Variables internes
Ces variables sont appelées internal variables car elles sont créées à l’intérieur du Commanders Act web container : elles sont intégrées directement dans le container de votre site, contrairement aux external variables, qui sont ajoutées dans le source code par l’équipe technique.
Les internal variables servent à collect data pour enrichir les données via les external variables. Une bibliothèque de predefined internal variables is available, mais vous pouvez aussi créer les vôtres.
Les internal variables doivent être créées dans l’ interface Commanders Act avant de pouvoir être utilisées dans les containers. Consultez le reste des articles de la section « internal variables » pour en savoir plus sur les différentes options disponibles pour créer de telles variables.
Toutes les internal variables créées peuvent être utilisées :
Pour être ajoutées aux solutions intégrées dans le container (le lien entre internal variables et solutions s’appelle mapping). Consultez l’article « Mapping tags’ variables » pour savoir comment mapper vos internal variables dans un tag.
Pour créer activation rules pour vos tags. Consultez l’article « Adding Rules » pour savoir comment créer des règles basées sur vos internal variables.
Informations complémentaires
Toutes les internal variables sont codées en JavaScript, mais vous n’avez pas besoin de connaissances techniques en JavaScript pour utiliser les variables « Predefined » ou les modes « Builder », puisque le code est généré automatiquement par la Commanders Act. Cependant, vous aurez besoin de connaître JavaScript ou de demander de l’aide à l’ équipe support Commanders Act afin de créer vos propres custom internal variables.
Voici quelques exemples d’internal variables predefined :
Variable interne pour récupérer l’URL de la page :\
Variable interne pour récupérer l’URL de la page / du site précédent :\
Variable interne pour récupérer ce qui se trouve entre le premier « / » et le deuxième « / » de l’URL :\
tC.internalvars.tc_url_1 =(function(){ tC.internalvars.tc_url_1_tmp = document.location.href.split('?'); tC.internalvars.tc_url_1_tmp2 = tC.internalvars.tc_url_1_tmp[0].split('/'); return tC.internalvars.tc_url_1_tmp2[3]; })();
Quand ajouter une internal variable
Il existe plusieurs situations dans lesquelles vous pouvez avoir besoin de créer une internal variable à l’aide de l’interface de gestion des variables :
Vous souhaitez récupérer des éléments disponibles sur vos pages web, mais ils n’ont pas d’ external variables implémentées par l’équipe technique (par exemple : la valeur d’un cookie, d’un HTML tag, d’une URL, etc.).
Vous souhaitez créer une nouvelle variable basée sur les valeurs des external variables déjà implémentées par l’équipe technique (par exemple : calculer le total du panier hors taxes à partir de l’external variable qui renvoie le total du panier TTC).
Vous souhaitez créer une table de correspondance basée sur une external variable (par exemple : lorsque la variable externe « country » vaut « FR », vous envoyez à votre outil d’analytics un numéro de compte différent de celui envoyé lorsque la variable vaut « IT »).
Etc.
Le lien créé entre les internal variables et les solutions s’appelle « mapping ». Cela se fait dans l’onglet « EDIT » lors du processus de déploiement du container.
Types d’internal variables
Il existe deux types d’internal variables : predefined et custom.
Les predefined internal variables ont déjà été créées et sont prêtes à l’emploi (par ex. des variables qui récupèrent des fragments d’URL).
Vous pouvez également configurer vos propres internal variables, en utilisant des variables existantes (par ex. des external variables) ou en récupérant des éléments disponibles sur les pages de vos sites (par ex. des cookies).
Pour déclarer une predefined internal variable, cliquez sur «Data Management» > «Web Datalayer» > «Internal Variables» > «ADD PREDEFINED VARIABLE» :
Vous serez alors invité à sélectionner un univers de predefined variables.\
Les « add variable » contient plusieurs champs :
«Predefined universe » : sélection des catégories d’internal variables predefined
«Nom« : Nom de la variable
«Description« : Description de la variable
«Code« : Code de la variable
Checkbox : sélection des predefined internal variables à ajouter au container (il est inutile d’inclure des variables que vous ne souhaitez pas utiliser).
Quatre univers de variables predefined (« Predefined universe ») sont disponibles :
Common variables : les variables les plus utilisées par les consultants Commanders Act et les clients.
Customer journey variables : variables qui exploitent le customer journey du visiteur (prérequis : le module « deduplication » doit être activé).
AT Internet plugin : variables qui exploitent les données collectées par la solution d’analytics digitale AT Internet (prérequis : la solution AT Internet doit être présente sur votre site).
Partner tags : extraits de code adaptés et adaptables aux partner tags afin d’en augmenter le potentiel et d’effectuer des actions supplémentaires.
Ajouter une variable interne common intégrée
Vous trouverez ci-dessous la liste des variables disponibles dans la catégorie « Common variables » et leur description
Page title : il stocke le titre de la page (depuis la balise HTML <title>).
Exemple :
La valeur de cette variable (sur la page http://www.tagcommander.com/fr/) sera « Commanders Act – Tag Universel – Tag Management – Commanders Act ». Elle prend la valeur de la balise HTML <title>.
***
Page URL : il stocke l’URL de la page courante.
Exemple :
La valeur de cette variable pour la page « http://www.tagcommander.com/fr/ » sera « http://www.tagcommander.com/fr/ »
***
Previously Visited URL : il stocke l’URL de la page précédente
Exemple :
Si le visiteur arrive sur le site Commanders Act via le moteur de recherche Google, la valeur de cette variable contiendra « google.fr »
***
Page URL without query string : il stocke l’URL de la page courante sans les paramètres de suivi (Commanders Act supprimera le « ? » de l’URL et tout ce qui suit).
Exemple :
Si le visiteur est sur la page « https://www.google.fr/webhp?tab=ww&ei=-ATjVPTyFaWqywOpqoHYDw&ved=0CAcQ1S4#q=inurl&start=10″, la valeur de cette variable sera « https://www.google.fr/webhp »
***
Page query string only: il stocke les paramètres URL de la page courante (Commanders Act enregistrera tout ce qui suit le « ? » sans l’inclure).
Exemple :
Si le visiteur est sur la page « https://www.google.fr/webhp?tab=ww&ei=-ATjVPTyFaWqywOpqoHYDw&ved=0CAcQ1S4#q=inurl&start=10″, la valeur de cette variable sera « tab=ww&ei=-ATjVPTyFaWqywOpqoHYDw&ved=0CAcQ1S4#q=inurl&start=10 »
***
URL parameters : il stocke le tableau des paramètres URL de la page courante.
Exemple :
Si le visiteur est sur la page « https://www.google.fr/webhp?tab=ww&ei=-ATjVPTyFaWqywOpqoHYDw&ved=0CAcQ1S4#q=inurl&start=10″, cette variable contiendra la valeur de ces trois paramètres : « tab », « ei » et « ved », et leurs valeurs seront accessibles de la manière suivante : « tc_array_url_vars[‘tab’] », « tc_array_url_vars[‘ei’] » et « tc_array_url_vars[‘ved’] »
***
Folder #1 in URL : il stocke le premier « dossier » de l’URL de la page courante
Exemple :
Si le visiteur est sur la page « http://www.tagcommander.com/fr/fonctionnalites/tag-management », la valeur de cette variable sera « fr ».
***
Folder #2 in URL : il stocke le deuxième « dossier » de l’URL de la page courante
Exemple :
Si le visiteur est sur la page « http://www.tagcommander.com/fr/fonctionnalites/tag-management », la valeur de cette page sera « fonctionnalités »
***
Folder #3 in URL : il stocke le troisième « dossier » de l’URL de la page courante
Exemple :
Si le visiteur est sur la page « http://www.tagcommander.com/fr/fonctionnalites/tag-management », la valeur de cette variable sera « tag-management »
***
Random value(integer 9 digits) : elle crée et stocke un nombre aléatoire composé de 9 chiffres
Exemple :
À chaque pageview/chargement de cette variable, la variable renverra un nombre aléatoire à 9 chiffres ; par exemple, « 255103492 »
***
URL pathname without query string /…/…/….html : il stocke l’URL de la page courante sans les paramètres (y compris le « / »)
Exemple :
Si le visiteur est sur la page « https://www.google.fr/webhp?tab=ww&ei=-ATjVPTyFaWqywOpqoHYDw&ved=0CAcQ1S4#q=inurl&start=10″, la valeur de cette variable sera « /webhp »
***
Https protocol ? « yes »/« no » : renvoie « yes » si la page utilise le protocole « https » et « no » sinon
Exemple :
Si le visiteur est sur la page « https://www.google.fr/webhp?tab=ww&ei=-ATjVPTyFaWqywOpqoHYDw&ved=0CAcQ1S4#q=inurl&start=10″, la valeur de cette variable sera « yes »
***
Current domain name (www.domain.com) : il stocke le nom de domaine de la page courante
Exemple :
Si le visiteur est sur la page « http://www.tagcommander.com/fr/fonctionnalites/tag-management », la valeur de cette variable sera « www.tagcommander.com »
***
Main domain name without subdomains : il stocke le nom de domaine de la page courante sans les sous-domaines
Exemple :
Si le visiteur est sur la page « http://www.tagcommander.com/fr/fonctionnalites/tag-management », la valeur de cette variable sera « tagcommander.com »
***
Unix timestamp : heure UNIX actuelle (le nombre de secondes depuis le 1er janvier 1970 00:00:00)
Exemple :
L’heure UNIX actuelle au moment où ce document a été rédigé était « 142166467 »
***
Device : Cette variable fournit des informations sur l’appareil de l’utilisateur à partir de sa résolution d’écran.
Ajout des internal variables customer journey intégrées
Vous trouverez ci-dessous la liste des variables disponibles dans la catégorie « Customer journey variables » et leur description correspondante :
Last touch name (channel) : canal du dernier touchpoint enregistré (prérequis : la deduplication doit être active sur votre site).
Exemple :
Pour le customer journey « SEO/Google -> SEM/Bing -> Display/Criteo » la valeur de cette variable sera « Display ».
***
Last touch name (source) : source du dernier touchpoint enregistré (prérequis : la deduplication doit être active sur votre site).
Exemple :
Pour le customer journey « SEO/Google -> SEM/Bing -> Display/Criteo » la valeur de cette variable sera « Criteo ».
Ajout d’internal variables customer
Vous pouvez créer votre propre internal variable de deux manières :
Via l’onglet « Builder » : le mode « Builder » vous aide à créer des internal variables personnalisées sans connaissances techniques ni expertise ;
Via l’onglet « Custom » : « Custom » est un mode entièrement personnalisé servant à écrire votre propre code JavaScript. Cette méthode requiert des connaissances techniques et de l’expertise (mais votre consultant Commanders Act ou équipe support peut créer des variables personnalisées pour vous si nécessaire).
Pour créer votre propre internal variable, cliquez sur « Data Management» > «Web Datalayer» > «Internal Variables» > «ADD VARIABLE» :
Les « add variable » contient plusieurs champs :
«tC.internalvars.« : nom de la variable (attention : il ne doit contenir ni accents ni caractères spéciaux, en particulier « - »).
Note : le nom de la variable est toujours précédé de « tC.internalvars. » afin d’éviter les conflits avec d’autres variables sur votre site. Par exemple, pour voir le contenu d’une internal variable directement sur votre site ou utiliser une variable sur un autre site, n’oubliez pas de spécifier le nom complet de la variable, qui inclut le préfixe « tC.internalvars. » ainsi que le nom de la variable.
«Builder« / »Custom« : sélectionnez le mode de création « Builder » ou « Custom »
Zone de création de la variable (voir les détails ci-dessous pour les modes Builder et Custom)
«Type« : le type de variable. Veuillez vous référer à l’article « Managing Variable Types ».
«Description« : une description de la variable, afin de clarifier son nom (par ex. « Product IDs separated by a / » peut être la description de la variable nommée « tC.internalvars.concatid »)
«Description détaillée« : une description détaillée de la variable, afin de préciser davantage son nom (par ex. « ID1/ID1/ID2… » peut être la description de la variable nommée « tC.internalvars.concatid »)
Mode Builder
Les « Builder » vous propose trois types d’opérations (1) que nous décrivons ci-dessous :
« Join internal and/or external variable(s) » ;
« Join two-dimensional array variable(s) » ;
« Variable mapping ».
Join internal and/or external variable(s)
Cette opération vous permet de joindre des variables internal ou external avec le séparateur de votre choix.
Exemple :
Si vous souhaitez joindre une external variable renvoyant l’ID de commande avec une autre external variable renvoyant le montant de commande, le tout séparé par un « - », sélectionnez la variable « order_id » dans l’onglet « External variables » à gauche puis saisissez et ajoutez votre séparateur dans le champ « add separator » afin de compléter la variable « order_amount » dans l’onglet « External variables ».
Join two-dimensional array variable(s)
Cette opération vous permet de joindre les clés du tableau d’une variable « Two dimensional array ».
Exemple :
Votre fournisseur de retargeting souhaite que vous envoyiez tous les prix des produits ajoutés au panier séparés par « | ». Commencez par sélectionner la variable qui contient les informations produit sur la page panier (ici la variable « user_id ») (1), puis la variable « order id » (ici la clé « order_confirmation_id ») et le séparateur « | ». Par exemple, la valeur obtenue pourrait être : « [email protected]|123456789AB ».
Variable mapping
Cette opération vous permet de créer une table de correspondance pour une valeur d’entrée (via une variable internal ou external déjà existante) et une valeur de sortie attendue.
Exemple :
Vous souhaitez envoyer un ID de compte différent à votre solution de Digital Analytics selon l’environnement de travail (pre-prod ou prod). Sélectionnez votre variable de référence (ici l’external variable « env_work »), ajoutez ses différentes valeurs d’entrée dans le champ « INPUT » (par ex. « pre-prod » et « prod »), puis ajoutez les ID de compte de sortie de votre solution d’analytics dans le champ « OUTPUT ». Vous pouvez également ajouter une valeur par défaut si aucune des valeurs saisies dans le champ « INPUT » n’a été trouvéej,yècr èuc.
Cette opération vous permet d’envoyer automatiquement le bon ID de compte à votre solution d’analytics en fonction de l’environnement de travail.
Full custom mode
Les « Custom » vous permet d’écrire votre propre JavaScript code afin de créer l’internal variable de votre choix :
Note : assurez-vous que le code JavaScript de la variable respecte toujours la syntaxe suivante :
tC.internalvars.nameVariable = "yourCode";
Assurez-vous également que nameVariable a le même nom que la variable saisie dans le champ « tC.internalvars » (voir la première capture d’écran avec la variable tC.internalvars.my_custom_var):
Note : pour éviter d’éventuelles erreurs lors de l’inclusion du code de l’internal variable, l’étape « TEST » du processus de déploiement du container testera votre internal variable sur plusieurs navigateurs/systèmes d’exploitation.
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 demande un format de variable différent du format que vous renvoyez dans votre internal variable. 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: 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 à une variable, vous pouvez en modifier la valeur à la volée, tag par tag, dans l’interface « EDIT ». Les variables auxquelles un type a été ajouté afficheront un symbole bleu devant leur nom :
Une fois votre variable mappée, cliquez sur le symbole de lien :
Une fenêtre apparaîtra avec une liste de différentes opérations correspondant au type choisi. Cochez l’opération souhaitée (par exemple, encoder un email en sha256) et cliquez sur « SAVE »)
Catégorisation des internal variables
Comme vous pouvez créer une variable à l’aide d’autres variables, il est important de pouvoir gérer l’ordre dans lequel elles sont exécutées afin d’éviter tout problème.
Vous devez donc déclarer une internal variable A, sur laquelle s’appuie une internal variable B, avant la variable B. La variable B a besoin que la variable A soit déclarée d’abord pour être exécutée sans créer d’erreurs.
L’ordre des variables peut être modifié à l’aide de l’icône à double flèche :
Pour catégoriser une internal variable, vous devez :
Cliquer sur le bouton d’édition (icône crayon à droite sur la même ligne que l’internal variable) et sélectionner le type dans le menu déroulant comme illustré ci-dessous. Cela s’applique uniquement lorsque vous ajoutez une predefined variable.
Sélectionnez le type lorsque vous ajoutez une variable personnalisée, que ce soit avec le mode « Builder » ou « Full Custom ». (Fenêtre similaire à celle ci-dessus).
Déclarer une internal variable dans un container
Vous pouvez lier une internal variable à un container si vous avez plusieurs containers sur votre site.
En effectuant cette action, vous déclarez une seule fois le code de l’internal variable dans le(s) container(s) lié(s).
Conséquences :
Vous réduisez le poids des autres containers en évitant de déclarer plusieurs fois le code d’une seule internal variable.
Si vous appelez 2 containers sur la même page, vous évitez d’écraser la valeur de la variable définie dans le premier container par la valeur définie dans le second container (si la valeur peut changer pendant le chargement de la page)
Exemple : deux containers sont sur la même page, l’un dans le header et l’autre dans le body. Si vous liez une internal variable au container du header, vous réduirez le code de la page car la variable ne sera pas déclarée deux fois, et vous conserverez la valeur de la variable définie dans le header.
Pour lier une internal variable à un container, sélectionnez le container de votre choix lorsque vous créez ou modifiez votre variable dans le champ « Declared in container » :
Pour effectuer une action en masse sur plusieurs variables, cochez les variables de votre choix, puis choisissez le(s) container(s) dans la liste :
Mis à jour
Ce contenu vous a-t-il été utile ?