Tutoriel
Convention de nommage GTM : balises, déclencheurs, variables
Convention de nommage GTM pour balises, déclencheurs et variables : modèle par type, tableau de décision et script Python signalant les noms non conformes.
Dans ce tutoriel
Une convention de nommage GTM tient en une règle : chaque balise, déclencheur et variable commence par un code de type, suivi de « - » et d’un libellé lisible. Les pages d’aide Google que j’ai lues n’imposent aucune forme à ces objets : la règle est un choix de projet, à appliquer de la même façon dans le conteneur, dans l’audit et dans le plan de taggage. Je propose ci-dessous un modèle par type, un tableau de décision et un script qui signale les noms non conformes dans l’export JSON d’un conteneur. Si votre conteneur part de zéro, la mise en place GTM et GA4 commence par cette étape.
Ce qui est imposé, ce qui ne l’est pas
Les règles de nom d’événement GA4 (casse, longueur, caractères, noms réservés) sont détaillées dans la convention de nommage GA4. Elles portent sur le nom envoyé à Google, pas sur le nom d’une balise dans GTM. Pour les balises, déclencheurs et variables, aucune règle n’est imposée.
Google documente en revanche le format de l’export : un fichier JSON d’une version ou d’un espace de travail, qui contient les balises, les déclencheurs et les variables (aide Tag Manager : exporter un conteneur). C’est ce fichier qui permet de contrôler les noms sans cliquer objet par objet.
Le modèle par type
| Objet | Forme du nom | Exemple | Règle |
|---|---|---|---|
| Dossier | Nom de plateforme, ou Utilities | GA4 | Rien ne reste hors dossier |
| Balise | Plateforme - Type - Libellé | GA4 - Event - generate_lead | Plateforme : GA4, Google Ads, Meta, HTML, Consent. Type : Config, Event, Conversion, Pixel |
| Déclencheur | Code - Libellé | CE - form_submit | Codes : PV (page vue), CE (événement personnalisé), CL (clic), FS (envoi de formulaire), DL (chargement du DOM). Pour CE, le libellé est le nom exact poussé dans la couche de données |
| Variable | Code - Libellé | DLV - ecommerce.value | Codes : DLV (couche de données), JS (JavaScript personnalisé), Const, Url, Cookie. Pour DLV, le libellé est le chemin exact de la clé |
Une balise se lit de gauche à droite : la plateforme dit où part la donnée, le type dit ce qu'elle fait, le libellé dit quel geste elle mesure.
Les codes reprennent ceux de l’audit conteneur GTM, pour qu’un seul référentiel serve à la relecture et à l’audit. Certains guides anglophones écrivent CJS pour le JavaScript personnalisé ; je garde JS pour rester aligné sur l’audit. Le choix compte moins que son application uniforme.
Le script de contrôle
Le script lit l’export JSON, vérifie chaque balise, déclencheur et variable, et signale les noms non conformes, les doublons et les objets hors dossier. Il n’utilise que la bibliothèque standard de Python 3 et ne modifie rien. Je l’ai testé sur un export synthétique fictif, avec des erreurs posées exprès, dont la sortie suit le code.
#!/usr/bin/env python3
"""Contrôle de nommage d'un export JSON de conteneur Google Tag Manager.
Usage : python nommage_gtm.py chemin/vers/export.json
Stdlib uniquement, lecture seule, aucun appel réseau.
Code de sortie : 0 si aucun point signalé, 1 sinon.
"""
import json
import re
import sys
from collections import Counter
# Convention « Préfixe - Libellé », alignée sur audit_gtm.py.
PLATEFORMES = {"GA4", "Google Ads", "Meta", "HTML", "Consent"} # balises : plateforme
CODES_DECLENCHEUR = {"PV", "CE", "CL", "FS", "DL"} # déclencheurs : type
CODES_VARIABLE = {"DLV", "JS", "Const", "Url", "Cookie"} # variables : type
DOSSIERS = PLATEFORMES | {"Utilities"} # dossiers autorisés
SEP = " - "
EVENEMENT = re.compile(r"^[a-z][a-z0-9_]*$")
CHEMIN_DL = re.compile(r"^[A-Za-z0-9_.]+$")
NOM_PAR_DEFAUT = re.compile(r"(?i)^(tag|trigger|variable|balise|déclencheur)\s*\d*$|copy|copie")
def controle_nom(nom, codes, kind):
erreurs = []
if not nom or not nom.strip():
return ["nom vide"]
if NOM_PAR_DEFAUT.search(nom):
erreurs.append("nom par défaut ou copie")
if SEP not in nom:
return erreurs + ["séparateur ' - ' absent"]
code, libelle = nom.split(SEP, 1)
if code not in codes:
erreurs.append(f"préfixe « {code} » non autorisé")
if not libelle.strip():
erreurs.append("libellé vide")
if kind == "trigger" and code == "CE" and not EVENEMENT.match(libelle):
erreurs.append("nom d'événement attendu en snake_case")
if kind == "variable" and code == "DLV" and not CHEMIN_DL.match(libelle):
erreurs.append("chemin de couche de données avec espace ou caractère interdit")
return erreurs
def charger(chemin):
with open(chemin, encoding="utf-8") as f:
data = json.load(f)
return data.get("containerVersion", data)
def controler(conteneur):
dossiers = {d.get("folderId"): d.get("name", "") for d in conteneur.get("folder", [])}
points = []
categories = (
("balise", "tag", "tagId", PLATEFORMES),
("déclencheur", "trigger", "triggerId", CODES_DECLENCHEUR),
("variable", "variable", "variableId", CODES_VARIABLE),
)
for titre, kind, id_cle, codes in categories:
entites = conteneur.get(kind, [])
doublons = Counter(e.get("name", "") for e in entites)
for e in entites:
nom = e.get("name", "")
erreurs = controle_nom(nom, codes, kind)
if nom and doublons[nom] > 1:
erreurs.append("nom en double")
pid = e.get("parentFolderId")
if pid is None or pid not in dossiers:
erreurs.append("hors dossier")
elif dossiers[pid] not in DOSSIERS:
erreurs.append(f"dossier « {dossiers[pid]} » non prévu")
if erreurs:
points.append((titre, e.get(id_cle, "?"), nom or "(sans nom)", erreurs))
return points
def main():
if len(sys.argv) != 2:
print("Usage : python nommage_gtm.py export.json")
return 2
points = controler(charger(sys.argv[1]))
for titre, eid, nom, erreurs in points:
print(f"KO | {titre} | id {eid} | {nom} | {'; '.join(erreurs)}")
print(f"Total : {len(points)} point(s) de nommage à corriger.")
return 1 if points else 0
if __name__ == "__main__":
sys.exit(main())
Sortie obtenue sur cet export synthétique fictif, qui contient dix-huit objets dont dix sont signalés :
KO | balise | id 2 | GA4 - Event - generate_lead | nom en double
KO | balise | id 4 | tag-divers | séparateur ' - ' absent; dossier « Divers » non prévu
KO | balise | id 5 | Copy of GA4 - Config | nom par défaut ou copie; préfixe « Copy of GA4 » non autorisé
KO | balise | id 6 | GA4 - Event - generate_lead | nom en double
KO | balise | id 7 | HTML - Pixel chat | hors dossier
KO | déclencheur | id 22 | CE - Form Submit | nom d'événement attendu en snake_case
KO | déclencheur | id 23 | Trigger sans préfixe | séparateur ' - ' absent
KO | variable | id 31 | DLV - form name | chemin de couche de données avec espace ou caractère interdit
KO | variable | id 33 | Variable 3 | nom par défaut ou copie; séparateur ' - ' absent
KO | variable | id 34 | CJS - Titre | préfixe « CJS » non autorisé
Total : 10 point(s) de nommage à corriger.
Mettre la convention en place
Avant de commencer
- Un export JSON de la version à contrôler, téléchargé depuis l'interface GTM
- Python 3 sur le poste : le script n'utilise que la bibliothèque standard
- Le plan de taggage, ou un tableur qui en tient lieu
-
Exporter la version et compter les objets
Exportez la version à contrôler en JSON. Comptez les balises, déclencheurs et variables, et notez ceux qui ne suivent aucun modèle. Un export daté se compare plus tard à un export suivant.
-
Créer un dossier par plateforme
Créez les dossiers GA4, Meta, Google Ads, HTML, Consent et Utilities. Déplacez chaque objet dans son dossier avant de le renommer : un objet hors dossier est signalé par le script.
-
Renommer selon le modèle
Appliquez la forme du tableau à chaque objet. Un déclencheur CE reprend le nom exact de l’événement de la couche de données ; une variable DLV reprend le chemin exact de la clé.
-
Lancer le script et corriger chaque ligne
Lancez
python nommage_gtm.py export.jsonsur le nouvel export. Le code de sortie vaut 0 quand aucun point ne reste, et 1 sinon. Corrigez chaque ligne KO avant de passer à l’étape suivante. -
Dater la convention dans le plan
Notez la version de la convention et sa date dans le plan de taggage. Une modification de forme doit apparaître comme une nouvelle version, pas comme une correction silencieuse.
Erreurs fréquentes
- Copie non renommée :
Copy of GA4 - Configreste dans l’export. Renommez-la ou supprimez-la. - Préfixe inventé en cours de route :
tag-diversne suit aucun code. Le script le signale comme séparateur absent et dossier non prévu. - Déclencheur qui reprend l’action en français :
CE - Form Submitn’écoute pas le nomform_submitpoussé par le site, car la casse et l’espace diffèrent. - Chemin DLV approximatif :
DLV - form namene correspond à aucune clé de couche de données. Le libellé doit être le chemin exact.
Ce que cette convention ne règle pas
Elle ne décrit ni les paramètres de balise, ni les valeurs attendues. Le plan de taggage GA4 porte les colonnes de chaque événement. L’audit conteneur vérifie la structure du conteneur : balises en pause, déclencheurs trop larges, consentement absent. Pour tester les noms sans toucher la production, un environnement de préproduction GTM évite les essais en direct.
Sources
- Aide Tag Manager : exporter un conteneur, consultée le 20 novembre 2026.
- Référence API Tag Manager v2 : versions de conteneur, avec les objets dossier, balise, déclencheur et variable, consultée le 20 novembre 2026. Champs vérifiés :
containerVersion.tag,trigger,variable,folder;folderIdetnamepour les dossiers ;parentFolderIdpour balises, déclencheurs et variables. - Aide Google Analytics : règles de nommage des événements et des paramètres, déjà citée et vérifiée dans la convention de nommage GA4 le 19 novembre 2026, non relue pour cet article.