Variables externes
Ces variables sont appelées external variables car elles sont en dehors du Commanders Act web container : 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 ne sont donc pas visibles dans le code source de la page. Les variables externes sont ajoutées par vos équipes techniques ou par le prestataire technique chargé d’implémenter les Commanders Act web containers sur votre site.
Les variables externes sont indispensables car 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 envisagée et établie avant l’implémentation du Commanders Act web container afin de répondre aux besoins à moyen et long terme des solutions embarquées. Un récapitulatif des variables externes à implémenter sur votre site vous sera fourni par votre consultant Commanders Act lors de la phase de configuration du TMS, dans un fichier Excel nommé «deliverables » ou « tagging plan ».
Les variables externes doivent être déclarées dans le interface Commanders Act avant de commencer à configurer les tags dans vos containers. Consultez l’article « Ajout de variables externes » 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 (le lien entre les variables externes et les solutions s’appelle le mapping). Consultez l’article « Mapping des variables des Tags » pour savoir comment mapper vos variables externes dans un tag.
– Pour créer des règles d’activation pour vos tags. Consultez la section « Ajout de règles » pour savoir comment créer des règles à partir de vos variables externes.
Informations complémentaires
Comme pour votre container, les variables externes doivent être présentes sur toutes les pages de votre site et recevoir des valeurs adaptées au contexte. Par exemple :
– La valeur de la variable «page template» sera différente selon les principaux modèles de pages de votre site : page d’accueil, page produit, page de confirmation, etc.
– La valeur de la variable «user id» variera 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 en header, les variables externes seront donc 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 un exemple de liste 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 est configuré - appeler ensuite le script du Web Container */
<script type="text/javascript" src="//cdn.tagcommander.com/674/my_web_container.js"></script>
Ajout de variables externes
Il existe deux situations dans lesquelles vous pouvez 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 de faire implémenter le data layer/les variables dans le code source de votre site par vos équipes techniques ou votre prestataire technique, vous devez déclarer les variables dans l’interface Commanders Act afin qu’elles soient disponibles pour le mapping.
2) Des informations manquent de votre tagging plan actuel (par exemple : 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 à votre équipe technique ou au prestataire technique chargé d’implémenter les variables dans le code source de votre site :
En cliquant sur «Download», une fenêtre s’ouvrira contenant le code JavaScript à insérer dans le code source du site :
Pour ajouter une variable externe, vous devez aller dans le «Data Management» > «Web Data layer» > «External Variables» et cliquer sur «ADD VARIABLE»
Les « add variable » contient plusieurs champs :
«Nom« : le nom de la variable (champ obligatoire).
«Catégorie« : utilisé pour catégoriser la variable selon son usage (par ex. variable relative aux utilisateurs, aux pages produit, aux pages de confirmation, etc.). Consultez l’article « Catégorisation des variables externes » de cette section.
«Type« : le type de variable. Consultez l’article « Gestion des types de variables » de cette section.
«Use in noscript« : cochez la case afin que la variable soit présente dans le code noscript du tag.
«Description« : une description de la variable, pour clarifier son nom (par ex. « Page template » peut être la description de la variable nommée « env_template »).
«Description détaillée« : une description détaillée de la variable, pour clarifier davantage son nom (par 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 plus simple.
Catégories vous permettent de classer les variables selon leur usage (par ex. les variables relatives aux utilisateurs du site dans la catégorie « Users », les variables pour les pages produit dans la catégorie « Product page », les variables transverses génériques du site dans la catégorie « Environment », etc.)
Les catégories se gèrent en cliquant sur le bouton «manage categories» situé à gauche du bouton « ADD VARIABLE » :
Une fois votre catégorie créée, elle peut être utilisée dans la fenêtre pour ajouter et modifier les variables externes ; vous pouvez les modifier en cliquant sur l’icône crayon, les supprimer en cliquant sur la croix et en ajouter en saisissant un nom puis en cliquant sur le bouton bleu « + » :
Gestion des types de variables
La variable « type » (également appelée « processing function ») vous permet de modifier à la volée le format de la variable lors du mapping de vos tags.
Elles sont utiles lorsqu’une de vos solutions exige un format de variable différent de celui utilisé dans le external variables par les équipes techniques chargées d’implémenter le data layer.
Par exemple, si votre variable « page_name » contient des 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.
Les types les plus couramment utilisés sont :
Montant de commande: cela vous permet de modifier à la volée le format numérique (montant).
Vous pouvez remplacer les virgules séparatrices par des points (par ex. « 12,50 » devient « 12.50 »), choisir le nombre de décimales à conserver (par ex. « 12.50 » devient « 12.5 »), ou convertir le montant en centimes (« 12.50 » devient « 1250 »).
Alphanumeric & Special chars: cela vous permet de modifier à la volée le format de la chaîne de caractères.
Vous pouvez remplacer les caractères spéciaux par « _ » (par ex. « the company&its values » devient « the company_its values ») ou tronquer une chaîne de caractères (par ex. limiter la valeur de la variable à 10 caractères).
Après avoir attribué un type de variable, vous pouvez modifier sa valeur à la volée, tag par tag, dans l’interface «EDIT» . Les variables auxquelles un type a été ajouté auront un symbole bleu devant leur nom (1) :
Une fois votre variable mappée, 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 « _ ») puis cliquez sur «SAVE» :
Avancé : tableau à 2 dimensions
Ce type peut être attribué aux variables ayant un tableau à deux dimensions comme valeur. Sur un site e-commerce, il s’agit très souvent des variables « list_product » et « order_product » qui renvoient, respectivement, d’informations on products affiché sur une page catégorie ou ajouté au panier.
On parle de « tableaux à deux dimensions » puisque ces variables renvoient un tableau de valeurs pour chaque product (par ex. pour tous les produits de la page du site, leur ID, nom, prix, quantité, etc.).
Certaines solutions partenaires peuvent vous demander d’envoyer les données produit dans leur tag, séparées par un caractère appelé «séparateur» (par ex. tous les ID 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 « Tableau à deux dimensions » pour votre variable « order_product ».
Vous pourrez alors envoyer à vos partenaires les informations attendues sans avoir besoin de connaissances en JavaScript.
La première étape du processus de configuration consiste à sélectionner le type «Tableau à deux dimensions» (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écapitulatif des variables externes :
Saisissez toutes les clés de votre tableau dans la fenêtre qui s’affiche (par 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 «Tableau à deux dimensions» 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 (par ex. l’ID produit) ainsi que le séparateur :
Vous pouvez également utiliser le type «Tableau à deux dimensions» 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 « Ajout de variables internes personnalisées – Mode Builder ».
Modification 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) elle est mappée :
Remarque : les variables utilisées dans un container (à ajouter à 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 ?