1/11/2026
Cette page s'adresse au responsable marketing, au SEO ou à l'analyste qui configure GA4 dans GTM et veut des données exploitables. Les variables dans Google Tag Manager lisent, transforment et réutilisent les valeurs que vos balises envoient et que vos déclencheurs testent.
Elle complète l'article sur la couche de données (dataLayer) et s'inscrit dans notre guide Google Tag Manager : vous y décidez quel type de variable choisir, comment le nommer et comment éviter les valeurs vides dans GA4.
Variables, balises et déclencheurs : ce que fournit chaque brique
Dans GTM, une variable est un support d'information : elle fournit une valeur réutilisable à un déclencheur, à une balise ou à une autre variable. La différence opérationnelle avec les deux autres briques se lit ainsi :
- Déclencheur : il décide quand agir, sur quel événement et à quelle condition ;
- Balise : elle exécute l'action, par exemple envoyer un événement GA4 ;
- Variable : elle fournit quoi envoyer, et parfois comment le calculer.
Une même variable peut ainsi servir de condition dans un déclencheur et de paramètre dans une balise : la variable intégrée « Click URL » filtre un clic sortant, puis transmet l'adresse cliquée à GA4.
Variables intégrées et définies par l'utilisateur : bien choisir selon vos objectifs
Variables intégrées : cas d'usage et limite méthodologique
Les variables intégrées sont fournies par GTM et ne se personnalisent pas. Elles couvrent les besoins standards de collecte et de conditions :
- Pages : URL complète, nom d'hôte, chemin, référent ;
- Clics : élément, classes, ID, cible, URL, texte ;
- Formulaires : ID, classes, URL d'action, texte ;
- Défilement et visibilité (clés
gtm.*) : profondeur, ratio visible, temps à l'écran ; - Vidéos (clés
gtm.video*) : statut, durée, progression, titre ; - Erreurs : message, URL, ligne, mode débogage.
Leur limite est méthodologique : elles décrivent l'interface et non le métier. Dès qu'un composant change, lors d'une refonte ou d'un test A/B, les conditions qui s'appuient sur elles deviennent fragiles.
Variables définies par l'utilisateur : lire une valeur ou en produire une
Les variables définies par l'utilisateur se créent quand aucune variable intégrée ne convient. Elles lisent une valeur existante, comme une clé de la couche de données, ou en produisent une par transformation ou calcul. Elles servent notamment à :
- standardiser une valeur, par exemple un libellé de bouton ;
- rendre explicite une donnée métier comme
lead_typeoucta_location; - factoriser un réglage : un ID, un nom d'événement, une règle de correspondance ;
- réduire la duplication entre balises proches.
La fiabilité vient quand la donnée métier existe déjà sous une clé stable que GTM se contente de lire : les variables de transformation deviennent alors des outils de finition plutôt que des rustines.
Les principaux types de variables à maîtriser pour GA4
Le tableau ci-dessous classe les types définis par l'utilisateur utiles dans un conteneur orienté GA4.
Les types « Paramètres de la balise Google » et « Paramètres d'événement » existent depuis 2023, à la date de rédaction : ils regroupent les paramètres partagés par plusieurs balises GA4, au lieu de les ressaisir dans chacune.
Variable de couche de données : une clé stable et sensible à la casse
La variable de couche de données lit une clé exposée dans window.dataLayer. Le nom de la clé est sensible à la casse : si le site pousse form_name et que la variable lit formName, elle renvoie une valeur vide. Pour lire un élément de tableau, la variable utilise la notation à points, par exemple items.0.item_id.
La cohérence du schéma fait la qualité : même nom et même type partout (value reste numérique, currency reste une chaîne), camelCase ou snake_case sans mélange. Le contrat de données et la manière de pousser ces clés relèvent de l'article parent.
Variable JavaScript personnalisée : calculer avec une valeur de repli
La variable JavaScript personnalisée renvoie le résultat d'une fonction. L'exemple ci-dessous renvoie 'unknown' si lead_type manque, ce qui évite des paramètres vides dans GA4 :
function() {
var leadType = {{DLV - lead_type}};
if (!leadType) { return 'unknown'; }
return String(leadType).toLowerCase();
}
Cette variable reste l'exception : si le site peut pousser la valeur propre, faites-le. Sinon, appliquez quatre précautions :
- prévoir une valeur de repli pour chaque donnée qui peut manquer ;
- gérer les exceptions avec
try...catchquand la lecture peut échouer ; - éviter les traitements coûteux, comme les boucles lourdes sur le DOM ;
- faire relire la fonction par l'équipe mesure et par les développeurs.
Constante, table de correspondance et table regex : centraliser et normaliser
La variable constante stocke une valeur fixe, comme un nom d'environnement, et évite de la dupliquer en dur dans plusieurs balises.
La table de correspondance applique la règle « si X, alors Y » : en multi-sites, elle lit le nom d'hôte et renvoie l'ID de mesure du domaine, au lieu de maintenir plusieurs balises quasi identiques. Elle convertit aussi form_name en nom d'événement.
La table d'expression régulière harmonise des variantes par motifs quand les sources sont hétérogènes, sans multiplier les scripts.
Comment les variables alimentent vos balises et déclencheurs
Un plan de marquage robuste enchaîne un signal métier stable, un déclencheur clair et des balises qui puisent leurs paramètres dans des variables.
Dans les déclencheurs et les balises GA4 : partir d'un événement métier
Côté déclencheurs, les variables servent de conditions. Leur robustesse varie selon ce qu'elles lisent :
- événement personnalisé : la clé
eventvaut une valeur précise, sensible à la casse ; - URL : un chemin ou un fragment donné ;
- clic : « Click URL », « Click Text » ou « Click Classes », pratiques mais fragiles si l'interface change ;
- visibilité et défilement : les variables
gtm.*.
Quand le déclenchement porte un enjeu métier, comme un lead ou une demande de démo, préférez l'événement métier au détail d'interface. Côté balise, le schéma le plus robuste déclenche une balise « Événement GA4 » sur cet événement, par exemple lead_submit, et renseigne ses paramètres avec des variables de couche de données. Un paramètre non standard se déclare ensuite en définition personnalisée dans GA4, sous un nom strictement identique.
Dans une balise HTML personnalisée : injecter une variable sans fragiliser le site
Dans une balise HTML personnalisée, la syntaxe {{NomDeVariable}} injecte une variable GTM à la place d'une valeur en dur. En multi-domaines, une table de correspondance sur le nom d'hôte fournit l'identifiant du site : une seule balise remplace une copie par site.
La prévisualisation ne montre pas toujours le code final résolu : contrôlez aussi le code présent dans la page, et suivez quatre règles :
- limiter le HTML personnalisé aux cas où aucun modèle natif n'existe ;
- échapper les valeurs concaténées dans des chaînes de code ;
- vérifier que le consentement est acquis avant toute balise soumise à autorisation ;
- documenter le but, les variables requises et les dépendances.
Configuration d'une variable : méthode courte et robuste dans GTM
Étapes 1 à 3 : choisir le type, verrouiller le format, tester
Commencez par décider si vous devez lire ou transformer une valeur. Le tableau suivant associe les besoins les plus courants au type de variable et au piège à anticiper.
Avant de tester, fixez le format attendu, une valeur par défaut et la casse exacte des clés. Le test mobilise ensuite deux outils. Dans Tag Assistant, le mode Prévisualisation de GTM, l'onglet « Variables » montre si la valeur remonte au bon moment. Dans GA4, DebugView confirme la réception de l'événement et de ses paramètres.
La procédure complète figure dans notre méthode pour tester et déboguer un conteneur GTM.
Étape 4 : nommer par famille et documenter
Le préfixe indique la famille d'une variable d'un coup d'œil :
DLV -pour une variable de couche de données ;CJS -pour une variable JavaScript personnalisée ;CONST -pour une constante ;LT -pour une table de correspondance ;RT -pour une table d'expression régulière.
Complétez par un nom métier, une description (source, format, dépendances) et une publication par versions pour pouvoir revenir en arrière. Ces préfixes s'insèrent dans la convention de nommage de tout le conteneur.
Exemples B2B : GA4, événements clés et qualité de données
En B2B, l'objectif est de segmenter la performance par intention et par contexte éditorial, pas seulement par page. Trois montages couvrent l'essentiel :
- contexte éditorial : le site pousse le type de page, la thématique et l'étape du parcours, que GTM réutilise comme paramètres des clics sur un CTA ;
- formulaire : un seul événement par succès réel, enrichi du type de lead depuis la couche de données ;
- libellés de CTA : « Demander une démo » et « Obtenir une démo » ramenés à une seule valeur par une table de correspondance ou une table regex.
Le risque de double envoi, « en dur » et via GTM, se traite une fois pour toutes dans notre tutoriel pour configurer GA4 avec Google Tag Manager. Vérifiez ensuite que les définitions personnalisées de GA4 portent exactement les noms envoyés : vous reliez alors thèmes et formats aux leads qualifiés.
Fiabilité, conformité et qualité : pièges fréquents avec les variables
Pourquoi une variable renvoie « undefined » et comment la sécuriser
Une variable vide en prévisualisation vient presque toujours de l'une des causes ci-dessous ; chacune a sa parade.
En complément, prévoyez une valeur de repli et inspectez dataLayer dans la console pour confirmer l'ordre des messages.
Refontes et RGPD : ce qu'une variable ne doit pas lire
Une variable qui dépend du DOM (classes, texte, structure) casse au premier changement d'interface. Pour limiter les ruptures après une refonte ou un test A/B :
- poussez les informations métier dans la couche de données, sous des clés stables ;
- préférez les variables de couche de données aux sélecteurs ;
- si le DOM reste nécessaire, ciblez des attributs stables dédiés à la mesure.
Côté conformité, une variable ne doit collecter ni données directement identifiantes ni informations inutiles au plan de mesure. Le consentement, lui, se règle une fois dans GTM au niveau des déclencheurs, et non variable par variable.
Selon votre situation
La prochaine étape dépend de ce que vos variables alimentent aujourd'hui :
- Vos balises HTML personnalisées se multiplient. Rassemblez-les et nommez-les avec les règles de notre article sur les scripts et balises dans GTM.
- Une variable lit un cookie ou une donnée soumise à consentement. Vérifiez la chaîne CMP, état et déclenchement décrite dans le guide sur les cookies et le consentement dans GTM.
- Vos paramètres arrivent mais restent invisibles dans les rapports. Créez les définitions personnalisées en suivant notre guide Google Analytics 4.
Une fois vos paramètres fiables, le module de reporting de performance d'Incremys réunit les données de GA4 et de Search Console pour relier chaque contenu à ses événements clés et prioriser ceux à améliorer.
FAQ sur les variables dans GTM
Comment créer une variable définie par l'utilisateur sans complexifier le conteneur ?
Créez-la seulement si elle sert de façon récurrente, idéalement dans au moins deux balises. Donnez-lui un nom préfixé par sa famille, documentez sa source et son format, et préférez la couche de données à une extraction dans le DOM. Regroupez la logique de transformation dans des tables.
Quand privilégier une variable de couche de données plutôt qu'une custom javascript variable ?
Privilégiez la variable de couche de données dès que le site peut exposer la valeur sous une clé stable : elle se maintient mieux et ne dépend pas de l'interface. Réservez le JavaScript personnalisé au calcul, à la transformation ou à la valeur de repli, sachant qu'il impose 'unsafe-eval' dans une CSP stricte.
À quoi sert une variable constante dans un conteneur GTM ?
Une variable constante centralise une valeur fixe, comme un identifiant ou un nom d'environnement, réutilisée dans plusieurs balises. Lors d'une mise à jour, vous la modifiez à un seul endroit au lieu de corriger chaque balise, ce qui supprime les incohérences entre balises censées partager le même réglage.
Quelle différence entre une lookup table et une regex table ?
La lookup table associe une entrée exacte à une sortie : si l'entrée vaut X, la sortie vaut Y. La regex table applique des motifs pour couvrir des variantes de format, de domaine ou de casse. Choisissez la première pour une liste finie de valeurs connues, la seconde pour des valeurs hétérogènes.
Comment utiliser une variable dans une balise GA4 pour renseigner des paramètres d'événement ?
Dans la balise Événement GA4, ajoutez chaque paramètre, comme lead_type, et renseignez comme valeur une variable GTM, en général une variable de couche de données. Vérifiez la valeur dans Tag Assistant, la réception dans DebugView, puis déclarez le paramètre en définition personnalisée dans GA4.
Quelles conventions de nommage adopter pour des variables maintenables dans le temps ?
Adoptez un préfixe par type, comme DLV -, CJS -, CONST -, LT - ou RT -, suivi d'un nom métier plutôt que d'interface. Ajoutez une description indiquant la source et le format attendu, et alignez ces préfixes sur la convention de nommage du conteneur.

%2520-%2520blue.jpeg)

.jpeg)
.jpeg)
.avif)