Variables externes
Ces variables sont appelées variables externes car elles sont en dehors du container web 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 ne sont donc pas visibles dans le code source de la page. Variables externes sont ajoutées par vos équipes techniques ou par le prestataire technique chargé d’implémenter les containers web Commanders Act sur votre site.
Variables externes sont indispensables car elles contiennent la majeure partie 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édia n’auront pas les mêmes variables externes que les sites e-commerce).
La liste des variables externes doit être étudiée et établie avant que le container web Commanders Act soit implémenté afin de répondre aux besoins à moyen et long terme des solutions intégrées. Un récapitulatif des variables externes à implémenter sur votre site vous sera fourni par votre consultant Commanders Act lors de la mise en place du TMS, dans un fichier Excel nommé «deliverables » ou « plan de taggage ».
Variables externes doit être déclaré dans le interface Commanders Act avant de commencer à configurer des tags dans vos containers. Consultez l’article « Adding external variables » dans 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 variables externes et solutions s’appelle le mapping). Consultez l’article « Mappage 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 basées sur 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 se voir attribuer des valeurs adaptées au contexte. Par exemple :
– La valeur de la «modèle de page» variable sera différente pour les principaux modèles de page de votre site : page d’accueil, page produit, page de confirmation, etc.
– La valeur de la «ID utilisateur» 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 l’en-tête, 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 le Web Container Script ci-dessous */
<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 devrez peut-être 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 votre prestataire technique n’implémentent 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 de votre plan de taggage actuel (par ex. 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 vos règles.
Remarque : si nécessaire, vous pouvez cliquer sur «Télécharger», 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 «Télécharger», 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» > «Variables externes » et cliquez sur «ADD VARIABLE»
Les « ajouter une variable» contient plusieurs champs :
«Nom« : le nom de la variable (champ obligatoire).
«Catégorie« : permet de catégoriser la variable selon son application (par ex. variable relative aux utilisateurs, aux pages produit, aux pages de confirmation, etc.). Consultez l’article « Catégorisation des variables externes » dans cette section.
«Type« : le type de variable. Consultez l’article « Gestion des types de variables » dans cette section.
«Utiliser dans noscript« : cochez la case afin que la variable soit présente dans le code noscript du tag.
«Description« : une description de la variable, afin de clarifier le nom de la variable (par ex. « Modèle de page » peut être la description de la variable nommée « env_template »).
«Description détaillée« : une description détaillée de la variable, afin de préciser 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 application (par ex. variables relatives aux utilisateurs du site dans la catégorie « Users », variables pour les pages produit dans la catégorie « Product page », variables transversales génériques pour le site dans la catégorie « Environment », etc.)
Les catégories se gèrent en cliquant sur le bouton «gérer les catégories» situé à gauche du bouton « AJOUTER UNE 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 les ajoutant 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 nécessite un format de variable différent de celui utilisé dans le variables externes 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 corriger 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 la commande: cela vous permet de modifier à la volée le format numérique (montant).
Vous pouvez remplacer les virgules par des points (par exemple, « 12,50 » devient « 12.50 »), choisir le nombre de décimales à conserver (par exemple, « 12.50 » devient « 12.5 ») ou convertir le montant en centimes (« 12.50 » devient « 1250 »).
Alphanumérique et caractères spéciaux: 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» interface. 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 ex. supprimer les caractères spéciaux et les remplacer par « _ ») et cliquez sur «SAVE» :
Avancé : tableau bidimensionnel
Ce type peut être attribué à des variables ayant un tableau bidimensionnel comme valeur. Sur un site e-commerce, cela concernera très souvent les variables « list_product » et « order_product » qui renvoient, respectivement, informations on products affichés sur une page catégorie ou ajoutés au panier.
On parle de « tableaux bidimensionnels » puisque ces variables renvoient un tableau de valeurs pour chaque product (par ex. pour tous les produits présents sur la page du site, leur ID, nom, prix, quantité, etc.).
Certaines solutions partenaires peuvent vous demander d’envoyer dans leur tag des données produit séparées par un caractère appelé «séparateur » (par ex. tous les ID produit séparés par «| », ou tous les prix des produits 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 bidimensionnel » 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 bidimensionnel » (1) pour votre variable :
Une fois ce type ajouté, cliquez sur l’icône «Liste » icône qui apparaît à côté de votre variable pour voir un résumé 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 les caractéristiques de vos produits, c’est-à-dire l’ID, le nom, le prix, etc.) :
Après avoir sélectionné le type «Tableau bidimensionnel » 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 du produit) et le séparateur :
Vous pouvez également utiliser le type «Tableau bidimensionnel » pour créer des variables internes qui renvoient des clés de produits 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 «Modifier» et vous pouvez la supprimer en cliquant sur la corbeille. Le drapeau à côté du nom de la variable vous indiquera si elle est mappée ainsi que le(s) tag(s) avec lequel/lesquels 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 quels container(s), tag(s) ou règle(s) utilisent cette variable :
Mis à jour
Ce contenu vous a-t-il été utile ?