Variables externes
Ces variables sont appelées des parce qu’elles se trouvent en dehors du web container Commanders Act : elles sont intégrées directement dans le code source des pages de votre site, contrairement aux variables internes, qui sont créées à l’intérieur du container et donc non visibles dans le code source de la page. Variables externes sont ajoutées par vos équipes techniques ou le prestataire technique en charge de l’implémentation des web containers Commanders Act sur votre site.
Variables externes sont indispensables puisqu’elles contiennent la plupart des données envoyées aux solutions présentes dans le container. Leur fonction et leur nombre varient en fonction du modèle économique du site (par exemple, les sites médias n’auront pas les mêmes variables externes que les sites e-commerce).
La liste des variables externes doit être considérée et établie avant la mise en place du web container Commanders Act afin de répondre aux besoins moyens et longs termes des solutions intégrées. Un résumé des variables externes à implémenter sur votre site sera fourni par votre » : « lors de la phase d’installation du TMS, dans un fichier Excel nommé «deliverables » ou « tagging plan“.
Variables externes doit être déclarée dans le Commanders Act interface avant de commencer à configurer des tags dans vos containers. Consultez l’article « Adding external variables » de cette section pour savoir comment déclarer une variable externe dans l’interface.
Toutes les variables externes déclarées peuvent être utilisées :
– Pour transmettre des informations aux solutions intégrées dans le container (lier les variables externes et les solutions s’appelle mapping). Voir l’article « Mapping Tags’ Variables » pour savoir comment mapper vos variables externes dans un tag.
– Pour créer des règles d’activation pour vos tags. Voir la section « Adding Rules » pour savoir comment créer des règles basées sur vos variables externes.
Informations supplémentaires
Comme pour votre container, les variables externes doivent être présentes sur toutes les pages de votre site et se voir attribuer des valeurs adaptées au contexte. Par exemple :
– La valeur de la variable «page template» sera différente pour les principaux templates de pages de votre site : page d’accueil, page produit, page de confirmation, etc.
– La valeur de la variable «user id» variable changera pour chaque visiteur qui se connecte à votre site.
Les variables externes doivent être déclarées dans le code source de votre site avant l’appel à vos containers (=fichiers JavaScript). Si vous avez un container dans le header, les variables externes seront ainsi présentes dans le <head> ; si vous avez un container dans le body, elles doivent être déclarées dans la balise html <body>.
Voici une liste d’exemples de variables externes :
<script type="text/javascript">
var tc_vars = new Array();
tc_vars["env_work"] = 'Prod';
tc_vars["env_channel"] = 'Web';
tc_vars["env_language"] = 'fr';
tc_vars["env_country"] = 'FR';
tc_vars['page_type'] = 'Homepage';
tc_vars["page_name"] = 'Tag Commander Market';
tc_vars["page_category_1"] = '';
tc_vars["page_category_2"] = '';
tc_vars["page_category_3"] = '';
</script>
/* Data layer is setup - call the Web Container Script underneath */
<script type="text/javascript" src="//cdn.tagcommander.com/674/my_web_container.js"></script>
Ajout de variables externes
Il existe Vous pouvez créer votre propre variable interne de situations dans lesquelles vous pourriez avoir besoin de déclarer vos variables dans l’interface de gestion des variables externes :
1) Vous souhaitez installer Commanders Act sur un nouveau site: avant que vos équipes techniques ou le prestataire technique ne mettent en place le data layer/les variables dans le code source de votre site, vous devez déclarer les variables dans l’interface Commanders Act afin qu’elles soient disponibles pour le mapping.
2) Des informations manquent dans votre plan de tagging actuel (par ex. le statut client) : Là encore, cette variable doit être déclarée dans l’interface d'abord, avant de pouvoir être utilisée dans vos tags et règles.
Remarque : si nécessaire, vous pouvez cliquer sur «Download», pour récupérer vos variables externes au format JavaScript et les envoyer à vos équipes techniques ou au prestataire technique en charge d’implémenter les variables dans le code source de votre site :
Cliquer sur «Download» ouvrira une fenêtre contenant le code JavaScript à insérer dans le code source du site :
Pour ajouter une variable externe, vous devez aller dans «Data Management» > "Web Data layer" > «External Variables» et cliquer sur « équipe peut créer des variables personnalisées pour vous si nécessaire).»
Les “ajouter une variableLa fenêtre «
» contient plusieurs champs :Nom« : le nom de la variable (champ obligatoire).
» contient plusieurs champs :Catégorie« : utilisée pour catégoriser la variable selon son application (ex. variable relative aux utilisateurs, pages produit, pages de confirmation, etc.). Voir l’article « Categorizing External Variables » dans cette section.
» contient plusieurs champs :Type« : Le type de variable. Voir l’article « Managing Variable Types » dans cette section.
» contient plusieurs champs :Use in noscript« : Cochez la case pour que la variable soit présente dans le code noscript du tag.
» contient plusieurs champs :Description« : Une description de la variable, pour clarifier le nom de la variable (ex. « Page template » peut être la description de la variable nommée « env_template »).
» contient plusieurs champs :« : Le type de variable. Veuillez vous référer à l’article « Managing Variable Types ». « : Une description détaillée de la variable, pour préciser davantage le nom de la variable (ex. « valeurs possibles : homepage/category/product/funnel_confirmation » peut être la description détaillée de la variable « env_template »).
Une fois la variable ajoutée, elle apparaîtra dans la liste des variables :
Catégorisation des variables externes
Les variables peuvent être catégorisées pour une gestion facilitée.
Catégories vous permettent de classer les variables selon leur application (ex. variables relatives aux utilisateurs du site dans la catégorie « Users », variables pour les pages produit dans la catégorie « Product page », variables transverses génériques du site dans la catégorie « Environment », etc.)
Les catégories sont gérées en cliquant sur le bouton «manage categories» à gauche du bouton « ADD VARIABLE » :
Une fois votre catégorie créée, elle peut être utilisée dans la fenêtre pour ajouter et éditer des variables externes ; vous pouvez les modifier en cliquant sur l’icône crayon, les supprimer en cliquant sur la croix et les ajouter en entrant un nom puis en cliquant sur le bouton bleu "+" :
tC.internalvars.my_custom_var
Remarque : Pour éviter des erreurs potentielles lorsque le code de la variable interne est inclus, l’étape «typeTEST» du processus de déploiement du container testera votre variable interne sur plusieurs navigateurs/systèmes d’exploitation.Gestion des types de variables
Elles sont utiles lorsqu’une de vos solutions exige un format de variable différent du format utilisé dans le des par les équipes techniques en charge de l’implémentation du data layer.
Par exemple, si votre variable « page_name » contient caractères spéciaux dans le code source, les fonctions de traitement vous permettent de les corriger afin que vos solutions puissent recevoir la valeur sans caractères spéciaux.
processing function
») vous permet de modifier le format de la variable à la volée lors du mapping de vos tags.Elles sont utiles lorsqu’une de vos solutions demande un format de variable différent du format que vous renvoyez dans votre
. Par exemple, si votre variable « order_discount » contient trois décimales, les processing functions vous permettront de corriger cela afin que vos solutions reçoivent la valeur avec seulement 2 décimales.
Les types les plus couramment utilisés sont :Montant de commande
Vous pouvez remplacer les caractères spéciaux par « _ » (ex. « the company&its values » devient « the company_its values ») ou tronquer une chaîne de caractères (ex. limiter la valeur de la variable à 10 caractères).
Après avoir attribué un type à une variable, vous pouvez modifier sa valeur à la volée, tag par tag, dans l’interface «EDIT». Les variables avec un type ajouté auront un symbole bleu devant leur nom (1) :
Une fois que vous avez mappé votre variable, cliquez sur le lien symbole:
Une fenêtre apparaîtra avec une liste de différentes opérations correspondant au type choisi. Cochez la case correspondant à l’opération souhaitée (par exemple, supprimer les caractères spéciaux et les remplacer par « _ ») et cliquez sur «SAVE» :
Avancé : tableau à 2 dimensions
Ce type peut être attribué aux variables ayant une tableau bidimensionnel comme valeur. Sur un site e-commerce, cela concernera très souvent les variables « list_product » et « order_product » qui retournent, respectivement, d’informations on products affichés sur une page catégorie ou ajoutés au panier.
On parle de « tableaux bidimensionnels » car ces variables renvoient un tableau de valeurs pour chaque product (par ex. pour tous les produits sur la page du site, leur ID, nom, prix, quantité, etc.).
Certaines solutions partenaires peuvent demander que vous envoyiez des données produit dans leur tag séparées par un caractère appelé «joindre» (par ex. tous les IDs produit séparés par «|», ou tous les prix produit séparés par une virgule dans leur tag de confirmation).
L’opération sera beaucoup plus simple si vous sélectionnez la fonction de traitement « Two-dimensional array » pour votre variable « order_product ».
Vous pourrez alors envoyer à vos partenaires les informations attendues sans nécessiter de connaissances en JavaScript.
La première étape du processus de configuration est de sélectionner le type «Two-dimensional array» (1) pour votre variable :
Une fois ce type ajouté, cliquez sur l’icône «List » qui apparaît à côté de votre variable pour voir un résumé des variables externes :
Saisissez toutes vos clés de tableau dans la fenêtre qui apparaît (ex. si votre variable principale est « list_products », les clés seront des caractéristiques de vos produits, c’est-à-dire l’ID, le nom, le prix, etc.) :
Après avoir sélectionné le type «Two-dimensional array» pour votre variable, allez à l’étape «EDIT». Cliquez sur le symbole apparaissant à gauche de la variable que vous venez de mapper :
Saisissez la clé du tableau dans la fenêtre de configuration (ex. l’ID produit) et le séparateur :
Vous pouvez également utiliser le type «Two-dimensional array» pour créer des variables internes qui renvoient des clés produit séparées par le symbole de votre choix. Pour plus d’informations, consultez l’article « Adding Custom Internal Variables – Builder Mode ».
Édition et suppression des variables externes
Vous pouvez modifier une variable externe en cliquant sur l’icône «Edit» et la supprimer en cliquant sur la corbeille. Le drapeau à côté du nom de la variable vous indiquera si elle est mappée et avec quel(s) tag(s) :
Remarque : Les variables utilisées dans un container (pour être ajoutées à un tag, par exemple) ne peuvent pas être supprimées, et leurs noms ne peuvent pas être modifiés.
En cliquant sur le drapeau, vous verrez quel(s) container(s), tag(s) ou règle(s) utilisent cette variable :
Mis à jour
Ce contenu vous a-t-il été utile ?