Variables internes

Ces variables sont appelées variables internes 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 variables externes, qui sont ajoutées dans le code source de la page source code par l'équipe technique.

Les variables internes servent à collecter des données afin d'enrichir les données grâce aux variables externes. Une bibliothèque de variables internes prédéfinies est disponible, mais vous pouvez aussi créer les vôtres.

Variables internes doivent être créées dans l' interface Commanders Act avant de pouvoir être utilisées dans des containers. Consultez le reste des articles de la section « internal variables » pour en savoir plus sur les différentes options disponibles pour créer ce type de variables.

Toutes les variables internes créées peuvent être utilisées :

• Pour être ajoutées aux solutions intégrées dans le container (le lien entre variables internes et solutions s'appelle mapping). Consultez l'article « Mapping tags’ variables » pour savoir comment mapper vos variables internes dans un tag.

• Pour créer des règles d'activation pour vos tags. Consultez l'article « Adding Rules » pour savoir comment créer des règles basées sur vos variables internes.

Informations complémentaires

Les variables internes sont toutes codées en JavaScript, mais vous n'avez pas besoin de connaissances techniques de JavaScript afin d'utiliser les modes «Predefined» ou «Builder», puisque le code est généré automatiquement par le Commanders Actsystème. Cependant, vous devrez connaître JavaScript ou demander de l'aide à l'équipe d' support Commanders Act afin de créer vos propres variables internes personnalisées.

Voici quelques exemples de variables internes prédéfinies :

• Variable interne pour récupérer l'URL de la page :\

  tC.internalvars.tc_url = document.location.href;

• Variable interne pour récupérer l'URL de la page / du site précédent :\

  tC.internalvars.tc_referrer = document.referrer;

• 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 variable interne

Il existe plusieurs situations dans lesquelles vous pouvez avoir besoin de créer une variable interne à l'aide de l' gestion des variables interface :

• Vous souhaitez récupérer des éléments disponibles sur vos pages web, mais ils ne disposent pas de variables externes mises en place par l'équipe technique (par exemple : la valeur d'un cookie, d'un tag HTML, d'une URL, etc.).

• Vous souhaitez créer une nouvelle variable à partir des valeurs des variables externes déjà mises en place par l'équipe technique (par exemple : calculer le total du panier hors taxes à l'aide de la variable externe qui renvoie le total du panier TTC).

• Vous souhaitez créer une table de correspondance basée sur une variable externe (par exemple : lorsque la variable externe « country » vaut « FR », vous envoyez à votre outil d'analyse un numéro de compte différent de celui envoyé lorsque la variable vaut « IT »).

• Etc.

Le lien créé entre les variables internes et les solutions s'appelle «mapping». Cela se fait dans l'onglet «EDIT» lors du processus de déploiement du container.

Types de variables internes

Il existe deux types de variables internes : prédéfinies et personnalisé.

• Les variables internes prédéfinies ont déjà été créées et sont prêtes à être utilisées (par exemple, des variables qui récupèrent des fragments d'URL).

• Vous pouvez également configurer vos propres variables internes, à l'aide de variables préexistantes (par exemple des variables externes) ou en récupérant des éléments disponibles sur les pages de vos sites (par exemple des cookies).

Pour déclarer une variable interne prédéfinie, cliquez sur «Data Management» > «Web Datalayer» > «Internal Variables» > «ADD PREDEFINED VARIABLE» :

Il vous sera alors demandé de sélectionner un univers de variables prédéfinies.\

Les « ajouter une variable» contient plusieurs champs :

«Univers prédéfini« : Sélection des catégories de variables internes prédéfinies

«Nom« : Nom de la variable

«Description« : Description de la variable

«Code« : Code de la variable

Case à cocher: Sélection des variables internes prédéfinies à ajouter au container (il est inutile d'inclure des variables que vous ne souhaitez pas utiliser).

Quatre univers de variables (« Predefined universe ») sont disponibles :

• Variables communes: Les variables les plus utilisées à la fois par les consultants Commanders Act et les clients.

• Variables Customer journey: Variables qui exploitent le Customer journey du visiteur (prérequis : le module « deduplication » doit être activé).

• Plugin AT Internet : : Variables qui exploitent les données collectées par la solution d'analytics digital AT Internet (prérequis : la solution AT Internet doit être présente sur votre site).

• tags partenaires : Extraits de code adaptés et adaptables aux tags partenaires pour augmenter leur potentiel et effectuer des actions supplémentaires.

Ajouter une variable interne commune intégrée

Vous trouverez ci-dessous une liste des variables disponibles dans la catégorie «Variables communes» et leur description

Titre de la page : elle stocke le titre de la page (issu de 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>.

***

URL de la page : elle stocke l'URL de la page actuelle.

Exemple :

La valeur de cette variable pour la page « http://www.tagcommander.com/fr/ » sera « http://www.tagcommander.com/fr/ »

***

URL précédemment visitée : elle 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 »

***

URL de la page sans chaîne de requête : elle stocke l'URL de la page actuelle sans les paramètres de suivi (Commanders Act supprimera le « ? » de l'URL et tout ce qui suit.

Exemple :

Si le visiteur se trouve 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 »

***

Chaîne de requête de la page uniquement: elle stocke les paramètres d'URL de la page actuelle (Commanders Act enregistrera tout ce qui suit le « ? » sans l'inclure).

Exemple :

Si le visiteur se trouve 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 »

***

Paramètres d'URL : elle stocke le tableau des paramètres d'URL de la page actuelle.

Exemple :

Si le visiteur se trouve 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'] »

***

Dossier #1 dans l'URL : elle stocke le premier « dossier » de l'URL de la page actuelle

Exemple :

Si le visiteur se trouve sur la page « http://www.tagcommander.com/fr/fonctionnalites/tag-management », la valeur de cette variable sera « fr ».

***

Dossier #2 dans l'URL : elle stocke le deuxième « dossier » de l'URL de la page actuelle

Exemple :

Si le visiteur se trouve sur la page « http://www.tagcommander.com/fr/fonctionnalites/tag-management », la valeur de cette page sera « fonctionnalites »

***

Dossier #3 dans l'URL : elle stocke le troisième « dossier » de l'URL de la page actuelle

Exemple :

Si le visiteur se trouve sur la page « http://www.tagcommander.com/fr/fonctionnalites/tag-management», la valeur de cette variable sera « tag-management »

***

Valeur aléatoire (entier à 9 chiffres) : elle crée et stocke un nombre aléatoire composé de 9 chiffres

Exemple :

À chaque affichage/chargement de cette variable, la variable renverra un nombre aléatoire à 9 chiffres ; par exemple « 255103492 »

***

Chemin d'URL sans chaîne de requête /…/…/….html : elle stocke l'URL de la page actuelle sans les paramètres (y compris le « / »)

Exemple :

Si le visiteur se trouve 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 »

***

Protocole Https ? « yes »/« no » : Renvoie « yes » si la page utilise le protocole « https » et « no » sinon

Exemple :

Si le visiteur se trouve 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 »

***

Nom de domaine actuel (www.domain.com) : elle stocke le nom de domaine de la page actuelle

Exemple :

Si le visiteur se trouve sur la page « http://www.tagcommander.com/fr/fonctionnalites/tag-management », la valeur de cette variable sera « www.tagcommander.com »

***

Nom de domaine principal sans sous-domaines : elle stocke le nom de domaine de la page actuelle sans les sous-domaines

Exemple :

Si le visiteur se trouve sur la page « http://www.tagcommander.com/fr/fonctionnalites/tag-management », la valeur de cette variable sera « tagcommander.com »

***

Timestamp Unix : Heure UNIX actuelle (le nombre de secondes écoulées depuis le 1er janvier 1970 00:00:00)

Exemple :

L'heure UNIX actuelle au moment de la rédaction de ce document était « 142166467 »

***

Appareil : Cette variable fournit des informations sur l'appareil de l'utilisateur en fonction de la résolution de son écran.

Ajout de variables internes Customer journey intégrées

Vous trouverez ci-dessous une liste des variables disponibles dans la catégorie «Variables Customer journey» et leur description correspondante :

Nom du dernier touch (canal) : 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 ».

***

Nom du dernier touch (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 de variables internes client

Vous pouvez créer votre propre variable interne de deux manières :

• Via l'onglet «Builder» : le mode «Builder» vous aide à créer des variables internes personnalisées sans connaissances ni expertise techniques ;

• Via l'onglet «Custom» : «Custom» est un mode entièrement personnalisé utilisé pour écrire votre propre code JavaScript. Cette méthode nécessite des connaissances techniques et de l'expertise (mais votre consultant Commanders Act ou support peut créer des variables personnalisées pour vous si nécessaire).

Pour créer votre propre variable interne, cliquez sur «Data Management» > «Web Datalayer» > «Internal Variables» > «ADD VARIABLE» :

Les « ajouter une variable» contient plusieurs champs :

«tC.internalvars.« : Nom de la variable (attention : elle ne doit contenir aucun accent ni caractère spécial, en particulier « - »).

Note : le nom de la variable est toujours précédé du préfixe « tC.internalvars. » afin d'éviter tout conflit avec d'autres variables sur votre site. Par exemple, pour voir le contenu d'une variable interne directement sur votre site ou utiliser une variable sur un autre site, n'oubliez pas de préciser le nom complet de la variable, qui comprend 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« : Type de variable. Veuillez vous référer à l'article « Managing Variable Types ».

«Description« : Description de la variable, pour clarifier le nom de la variable (par exemple, « ID produits séparés par un / » peut être la description de la variable nommée « tC.internalvars.concatid »)

«Description détaillée« : Description détaillée de la variable, pour préciser davantage son nom (par exemple, « 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) décrits 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 internes ou externes variables avec la séparateur de votre choix.

Exemple :

Si vous souhaitez joindre une variable externe renvoyant l'ID de commande avec une autre variable externe renvoyant le montant de la 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 de 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 sur le produit sur la page du 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 : « [e-mail]|123456789AB ».

Mappage de variables

Cette opération vous permet de créer une table de correspondance pour une valeur d'entrée (via une variable interne ou externe déjà existante) et une valeur de sortie attendue.

Exemple :

Vous souhaitez envoyer un ID de compte différent à votre solution Digital Analytics en fonction de l'environnement de travail (pre-prod ou prod). Sélectionnez votre variable de référence (ici la variable externe « env_work »), ajoutez ses différentes valeurs d'entrée dans le champ « INPUT » (par exemple « 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ée.

Cette opération vous permet d'envoyer automatiquement le bon ID de compte à votre solution d'analytics en fonction de l'environnement de travail.

Mode entièrement personnalisé

Les « Custom» vous permet d'écrire votre propre code JavaScript pour créer la variable interne de votre choix :

Note : assurez-vous que le code JavaScript de la variable respecte toujours la syntaxe suivante : tC.internalvars.nameVariable = "yourCode";

Veillez également à ce que nameVariable porte 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 : afin d'éviter d'éventuelles erreurs lors de l'inclusion du code de la variable interne, l'étape «TEST» du processus de déploiement du container testera votre variable interne 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 de celui que vous renvoyez dans votre variable interne. Par exemple, si votre variable « order_discount » contient trois décimales, les fonctions de traitement 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 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 exemple, « the company&its values » devient « the company_its values ») ou tronquer une chaîne de caractères (par exemple, 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é porteront 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 e-mail en sha256) et cliquez sur «SAVE»)

Catégorisation des variables internes

Comme vous pouvez créer une variable à partir 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.

Par conséquent, vous devez déclarer une variable interne A, sur laquelle repose une variable interne B, avant la variable B. La variable B a besoin que la variable A soit déclarée en premier afin de pouvoir s'exécuter sans générer d'erreurs.

L'ordre des variables peut être modifié à l'aide de l'icône à double flèche :

Pour catégoriser une variable interne, vous devez :

• Cliquez sur le bouton d'édition (icône crayon à droite sur la même ligne que la variable interne) et sélectionnez le type dans le menu déroulant comme indiqué ci-dessous. Cela s'applique uniquement lorsque vous ajoutez une variable prédéfinie.

  
• Sélectionnez le type lorsque vous ajoutez une variable personnalisée, que ce soit avec le mode «Builder» ou le mode «Full Custom». (Fenêtre similaire à celle ci-dessus).

Déclarer une variable interne dans un container

Vous pouvez lier une variable interne à un container si vous avez plusieurs containers sur votre site.

En effectuant cette action, vous ne déclarez le code de la variable interne qu'une seule fois dans le ou les containers liés.

Conséquences :

• Vous réduisez le poids des autres containers en évitant de déclarer plusieurs fois le code d'une seule variable interne.

• Si vous chargez 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 se trouvent sur la même page, l'un dans le header et l'autre dans le body. Si vous liez une variable interne au container du header, vous réduirez le code de la page, car la variable ne sera pas déclarée deux fois, et conserverez la valeur de la variable définie dans le header.

Pour lier une variable interne à 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 groupée sur plusieurs variables, cochez les variables de votre choix, puis choisissez le ou les containers dans la liste :