Atelier Tech for Retail 2025 : Du SEO au GEO - gagner en visibilité à l’ère des moteurs génératifs

Back to blog

Les variables dans Google Tag Manager : types, configuration et cas GA4

SEO

Découvrez Incremys

Le plateforme SEO Next Gen 360°

Demande de demo
Mis à jour le

1/11/2026

Chapitre 01

Example H2
Example H3
Example H4
Example H5
Example H6

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_type ou cta_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.

 

TypeQuand l'utiliserExempleRisque
Couche de donnéesLire une clé poussée par le siteform_name, page_typeCasse erronée : valeur vide
JavaScript personnaliséCalculer ou transformer une valeur absenteValeur de repli, segment d'URLExige 'unsafe-eval' dans la CSP
ConstantePartager une valeur fixe entre balisesNom d'environnement, ID de configurationDoublon en dur resté dans une balise
Table de correspondanceAssocier une entrée exacte à une sortieNom d'hôte vers ID de mesureCas non prévu sans valeur par défaut
Table d'expression régulièreNormaliser des variantes par motifsfacebook.fr vers « Facebook »Motif trop large, faux positifs
« Paramètres de la balise Google », « Paramètres d'événement »Factoriser des paramètres GA4 communsParamètres partagés par plusieurs balises Événement GA4Une modification touche toutes les balises liées
URLExtraire une partie de l'adresseChemin, nom d'hôte, paramètre de requêteStructure d'URL changée par une refonte
Cookie propriétaireLire un cookie de votre domaineCookie posé par votre siteCookie absent ou expiré : valeur vide

 

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...catch quand 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é event vaut 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.

 

BesoinVariablePiège
Changer d'ID selon l'environnement ou le domaineTable de correspondance sur le nom d'hôteDomaine oublié, sans valeur par défaut
Nettoyer une valeur hétérogèneTable d'expression régulièreMotif trop large qui capture d'autres cas
Lire un cookieCookie propriétaireCookie absent avant consentement ou expiré
Lire le dataLayerVariable de couche de donnéesCasse erronée ou push trop tardif
Calculer une valeur absenteJavaScript personnalisé, en dernier recoursMaintenance plus lourde, CSP à adapter
Partager une valeur fixeConstanteCopie en dur oubliée dans une balise

 

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.

 

CauseSymptômeParade
Casse erronéeClé lue sous un autre nomRecopier le nom exact poussé par le site
Push trop tardifValeur arrivée après le déclenchementDéclencher sur l'événement qui porte la valeur
Objet invalideGuillemets oubliés, syntaxe incorrecteCorriger le push, contrôler dans la console
Persistance attendueValeur absente sur la page suivanteRepousser la clé sur chaque page

 

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.

Découvrez d’autres articles

See all

Le SEO et GEO nouvelle génération commence ici

Complétez le formulaire pour que l’on puisse vous contacter.

Le SEO nouvelle génération
est en marche !

Merci pour votre demande, nous revenons vers vous rapidement.

Oops! Something went wrong while submitting the form.