Variables internes

Ces variables sont appelées variables internes parce qu’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 source code par le personnel technique.

Les variables internes sont utilisées pour collecter des données pour enrichir les données via les variables externes. Une bibliothèque de variables internes prédéfinies est disponible, mais vous pouvez également créer les vôtres.

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

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

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

• Pour créer 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 supplémentaires

Les variables internes sont toutes codées en JavaScript, mais vous n’avez pas besoin de connaissances techniques pour JavaScript utiliser les modes «Predefined» variables ou les modes «Builder», puisque le code est généré automatiquement par le Commanders Act. Cependant, vous aurez besoin de connaître JavaScript ou de solliciter l’équipe de support Commanders Act pour 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/site précédente :\

  tC.internalvars.tc_referrer = document.referrer;

• Variable interne pour récupérer ce qui se situe entre le premier « / » et le second « / » 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 en utilisant l’interface de gestion des variables internes :

• Vous souhaitez récupérer des éléments disponibles sur vos pages web, mais ils ne sont pas des variables externes implémentées par le personnel technique (par exemple : la valeur d’un cookie, d’une balise HTML, d’une URL, etc.).

• Vous souhaitez créer une nouvelle variable basée sur les valeurs de variables externes déjà implémentées par le personnel technique (par exemple : calculer le total du panier hors taxe en utilisant 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 un numéro de compte à votre outil d’analytics différent de celui envoyé lorsque la variable vaut « IT »).

• Etc.

Le lien créé entre les variables internes et les solutions est appelé «mapping». Ceci est effectué 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ées.

• Les variables internes prédéfinies ont déjà été créées et sont prêtes à l’emploi (par ex. variables qui récupèrent des fragments d’URL).

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

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

Vous serez alors invité à sélectionner un univers de variables prédéfinies.\

Les “ajouter une variableLa fenêtre «

» contient plusieurs champs :«Univers prédéfini

» contient plusieurs champs :Nom» : Sélection des catégories de variables internes prédéfinies

» contient plusieurs champs :Description« : Nom de la variable

» contient plusieurs champs :» : Description de la variableCode

« : Code de la variableCase à cocher

: La 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 prédéfinies (« Univers prédéfini ») sont disponibles :Variables communes

• : Les variables les plus utilisées par les consultants et clients Commanders Act.Variables Customer journey

• : Variables exploitant le Customer journey du visiteur (prérequis : le module « deduplication » doit être activé). Plugin AT Internet :

• Variables exploitant 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). Partner tags :

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

Ajouter une variable interne commune intégréeQuatre univers de variables prédéfinies (« Univers prédéfini ») sont disponibles :Vous trouverez ci-dessous une liste des variables disponibles dans la catégorie «

» et leur description Titre de la page :

il stocke le titre de la page (à partir de la balise <title> html).

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 l’onglet html <title>. URL de la page :

il stocke le titre de la page (à partir de la balise <title> html).

elle stocke l’URL de la page courante.

***

La valeur de cette variable pour la page « http://www.tagcommander.com/fr/ » sera « http://www.tagcommander.com/fr/ » URL visitée précédemment :

il stocke le titre de la page (à partir de la balise <title> html).

elle stocke l’URL de la page précédente

***

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 query string :

il stocke le titre de la page (à partir de la balise <title> html).

elle stocke l’URL de la page courante sans les paramètres de tracking (Commanders Act supprimera le « ? » de l’URL et tout ce qui suit).?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 »Chaîne de requête de la page uniquement

il stocke le titre de la page (à partir de la balise <title> html).

elle stocke l’URL de la page courante sans les paramètres de tracking (Commanders Act supprimera le « ? » de l’URL et tout ce qui suit).? : elle stocke les paramètres de l’URL de la page courante (Commanders Act sauvegardera tout ce qui suit le « ? » sans l’inclure).

***

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 de l’URL :

il stocke le titre de la page (à partir de la balise <title> html).

elle stocke le tableau des paramètres de l’URL de la page courante.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'] » Dossier #1 dans l’URL :

il stocke le titre de la page (à partir de la balise <title> html).

il stocke le premier « dossier » dans l’URL de la page couranteSi le visiteur est sur la page « http://www.tagcommander.com/fr

***

/fonctionnalites/tag-management », la valeur de cette variable sera « fr ». Dossier #2 dans l’URL :

il stocke le titre de la page (à partir de la balise <title> html).

il stocke le deuxième « dossier » dans l’URL de la page couranteSi le visiteur est sur la page « http://www.tagcommander.com/fr/fonctionnalites

***

/tag-management », la valeur de cette page sera « fonctionnalites » Dossier #3 dans l’URL :

il stocke le titre de la page (à partir de la balise <title> html).

il stocke le troisième « dossier » dans l’URL de la page couranteSi le visiteur est 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) :

il stocke le titre de la page (à partir de la balise <title> html).

elle crée et stocke un nombre aléatoire composé de 9 chiffres

***

À chaque affichage/chargement de page, cette variable renverra un nombre aléatoire de 9 chiffres ; par exemple, « 255103492 » Chemin de l’URL sans query string /…/…/….html :

il stocke le titre de la page (à partir de la balise <title> html).

il stocke l’URL de la page courante sans les paramètres (en incluant le « / »)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 » Protocole Https ? « yes »/« no » :

il stocke le titre de la page (à partir de la balise <title> html).

Renvoie « yes » si la page utilise le protocole « https » et « no » si ce n’est pas le casSi 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 » Nom de domaine actuel (www.domain.com) :

il stocke le titre de la page (à partir de la balise <title> html).

il stocke le nom de domaine de la page courante

***

Si le visiteur est 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 :

il stocke le titre de la page (à partir de la balise <title> html).

il stocke le nom de domaine de la page courante sans les sous-domaines

***

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

il stocke le titre de la page (à partir de la balise <title> html).

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

***

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

Cette variable fournit des informations concernant l’appareil de l’utilisateur en se basant sur la résolution de son écran.

Ajouter une variable interne commune intégrée : Les variables les plus utilisées par les consultants et clients Commanders Act.Ajout de variables internes Customer journey intégrées

» catégorie et leur description correspondante :

il stocke le titre de la page (à partir de la balise <title> html).

Nom du dernier touch (channel) : Channel du dernier Touchpoint enregistré (prérequis : la deduplication doit être active sur votre site). Pour le Customer journey « SEO/Google -> SEM/Bing ->Display

***

/Criteo » la valeur de cette variable sera « Display ».

Exemple :

Nom du dernier touch (source) : Source du dernier Touchpoint enregistré (prérequis : la deduplication doit être active sur votre site).CriteoPour le Customer journey « SEO/Google -> SEM/Bing -> Display/

» la valeur de cette variable sera « Criteo ».

Ajout de variables internes personnalisées Vous pouvez créer votre propre variable interne de deux

• façons :BuilderVia l’onglet «Builder» : Le mode «

• façons :Custom» vous aide à créer des variables internes personnalisées sans connaissances techniques ;CustomOnglet « » : « ou » est un mode entièrement personnalisé utilisé pour écrire votre propre code JavaScript. Cette méthode requiert des connaissances techniques (mais votre Commanders Act consultant

supportData Management» > "Web Datalayer" > «Internal Variables» > «équipe peut créer des variables personnalisées pour vous si nécessaire).» :

Les “ajouter une variableLa fenêtre «

» contient plusieurs champs :Pour créer votre propre variable interne, cliquez "ADD VARIABLE

tC.internalvars.

» contient plusieurs champs :Builder« : Le nom de la variable (attention : il ne doit contenir ni accents ni caractères spéciaux, notamment « - »).CustomRemarque : Le nom de la variable est toujours préfixé par « tC.internalvars. » afin d’éviter les conflits avec d’autres variables de 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 inclut le préfixe « tC.internalvars. » ainsi que le nom de la variable.

«/»

» contient plusieurs champs :Type« : Sélectionnez le mode de création « Builder » ou « Custom »

» contient plusieurs champs :DescriptionZone pour créer la variable (voir les détails ci-dessous pour les modes Builder et Custom)

» contient plusieurs champs :« : Le type de variable. Veuillez vous référer à l’article « Managing Variable Types ». « : Une description de la variable, pour clarifier le nom de la variable (par ex. « Product IDs separated by a / » peut être la description de la variable nommée « tC.internalvars.concatid »)

Description détaillée

Les “Builder« : Une description détaillée de la variable, pour clarifier davantage son nom (par ex. « ID1/ID1/ID2… » peut être la description de la variable nommée « tC.internalvars.concatid »)

• Mode Builder

• Le mode «

• » vous propose trois types d’opérations (1) que nous décrivons ci-dessous :

  

« Joindre des variable(s) interne(s) et/ou externe(s) » ;

« Joindre des variable(s) tableau bidimensionnel » ; « Mapping de variable ». Joindre des variable(s) interne(s) et/ou externe(s) Cette opération vous permet de avec le joindre des variables

il stocke le titre de la page (à partir de la balise <title> html).

internes ou externes

avec le séparateur

de votre choix.Si vous souhaitez joindre une variable externe renvoyant l’ID de commande avec une autre variable externe renvoyant le montant de la commande, avec 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 terminer par la variable « order_amount » dans l’onglet « External variables ». Joindre des variable(s) tableau bidimensionnel

il stocke le titre de la page (à partir de la balise <title> html).

Cette opération vous permet de joindre les clés de tableau d’une variable «

Two dimensional array

».

il stocke le titre de la page (à partir de la balise <title> html).

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 contenant 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 ».

Mapping de variable

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.

Les “CustomVous voulez envoyer un ID de compte différent à votre solution Digital Analytics selon 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 ex. « pre-prod » et « prod ») puis ajoutez les ID de compte de sortie de votre solution d’analytics dans le champ « OUTPUT ». Vous pouvez aussi ajouter une valeur par défaut si aucune des valeurs saisies dans le champ « INPUT » n’est 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 Full custom

Le mode « » vous permet d’écrire votre

propre JavaScript code pour créer la variable interne de votre choix : Remarque : assurez-vous que le code JavaScript de la variable ait toujours la syntaxe suivante :tC.internalvars.nameVariable = "yourCode";Assurez-vous également que nameVariable):

ait 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

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

La variable « variable interne» (appelée aussi «

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

: cela vous permet de modifier le format numérique (montant) à la volée.

Vous pouvez transformer des virgules en 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 »).

Alphanumérique & Caractères spéciaux

: cela vous permet de modifier la chaîne de caractères à la volée.SAVEVous 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 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 :

Une fois que vous avez mappé votre variable, 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 que vous souhaitez (par exemple, encoder un email en sha256) et cliquez sur «

»)

Catégoriser les variables internes

• Puisque vous pouvez créer une variable en utilisant 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 se base 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 s’exécuter sans créer d’erreurs. L’ordre des variables peut être modifié en utilisant l’icône double-flèche :

  
• Pour catégoriser une variable interne vous devez :BuilderCliquer sur le bouton d’édition (icône crayon à droite dans la même ligne où se trouve la variable interne) et sélectionner le type dans le menu déroulant comme illustré ci‑dessous. Ceci s’appliqueuniquementlorsque vous ajoutez une variable prédéfinie.

Sélectionnez le type lorsque vous ajoutez une variable personnalisée, que ce soit avec le mode «

» ou «

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 réalisant cette action, vous déclarez une seule fois le code de la variable interne 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 et même variable interne.