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.

Par Ron Kopelman Publié le 20 novembre 2026 ⏱ 40 min Niveau : Intermédiaire
Outils Google Tag Manager Google Analytics 4 Google Ads Meta (Pixel / CAPI)
Dans ce tutoriel
  1. Ce qui est imposé, ce qui ne l’est pas
  2. Le modèle par type
  3. Le script de contrôle
  4. Mettre la convention en place
  5. Erreurs fréquentes
  6. Ce que cette convention ne règle pas

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.

Outils concernés Google Tag Manager Google Analytics 4 Google Ads Meta (Pixel / CAPI)

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

ObjetForme du nomExempleRègle
DossierNom de plateforme, ou UtilitiesGA4Rien ne reste hors dossier
BalisePlateforme - Type - LibelléGA4 - Event - generate_leadPlateforme : GA4, Google Ads, Meta, HTML, Consent. Type : Config, Event, Conversion, Pixel
DéclencheurCode - LibelléCE - form_submitCodes : 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
VariableCode - LibelléDLV - ecommerce.valueCodes : DLV (couche de données), JS (JavaScript personnalisé), Const, Url, Cookie. Pour DLV, le libellé est le chemin exact de la clé
Anatomie d'un nom de balise

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

⏱ 40 min Niveau : Intermédiaire
  • 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
  1. Exporter la version et compter les objets10 min

    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.

  2. Créer un dossier par plateforme10 min

    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.

  3. Renommer selon le modèle15 min

    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é.

  4. Lancer le script et corriger chaque ligne5 min

    Lancez python nommage_gtm.py export.json sur 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.

  5. Dater la convention dans le plan5 min

    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 - Config reste dans l’export. Renommez-la ou supprimez-la.
  • Préfixe inventé en cours de route : tag-divers ne 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 Submit n’écoute pas le nom form_submit poussé par le site, car la casse et l’espace diffèrent.
  • Chemin DLV approximatif : DLV - form name ne 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

Ron Kopelman

Vous préférez que je le fasse ?

Je mets en place ce tutoriel sur votre site, avec recette et documentation. Cadrage gratuit de 30 minutes.