Tutoriel
Audit conteneur GTM : grille et script Python
Audit conteneur GTM à partir de l'export JSON : grille de 9 contrôles et script Python sans dépendance, exécuté sur un conteneur d'exemple fictif.
Dans ce tutoriel
Pour auditer un conteneur GTM, on lit l’export JSON d’une version plutôt que de cliquer balise par balise : la liste complète tient dans un seul fichier, et chaque anomalie se repère par une règle. Ce tutoriel donne neuf contrôles et un script Python sans dépendance qui les applique à cet export, en lecture seule. Le même principe s’applique aux pushes du dataLayer : voir l’audit des pushes du dataLayer. Le script a été exécuté sur un conteneur d’exemple synthétique et fictif, pas sur un conteneur client.
Il couvre la partie structurelle d’un audit de tracking : il ne remplace ni les tests de parcours en navigation privée, ni la vérification du consentement sur le site réel. Le contrôle de nommage applique les préfixes du modèle de nommage GTM.
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
- Un accès en lecture au conteneur, sans droit de publication pour ce tutoriel
Pourquoi lire l’export plutôt que l’interface
L’interface GTM affiche une balise ou une variable à la fois. Un export d’une version contient la liste complète des balises, déclencheurs et variables. Google indique que ce fichier sert à comparer, modifier et partager un conteneur, ou à le stocker dans un système de contrôle de versions (aide Google Tag Manager).
C’est ce fichier qui rend un contrôle systématique possible. Je commence par lui : il donne en quelques minutes la liste des points à vérifier dans l’interface, et il sert de trace pour comparer deux versions.
Ce que contient l’export
Le fichier porte une clé containerVersion, qui contient les tableaux tag, trigger et variable. Chaque balise a un identifiant, un nom, un type, des paramètres, la liste de ses déclencheurs et un indicateur paused. Chaque déclencheur a un triggerId, un type et ses conditions. Les conditions s’écrivent en minuscules, par exemple equals, contains ou matchRegex (référence API Tag Manager v2).
| Élément | Champ lu par le script | Usage |
|---|---|---|
| Balise | paused | balise en pause |
| Balise | firingTriggerId | balise sans déclencheur |
| Balise | consentSettings.consentStatus | consentement absent ou notSet |
| Déclencheur | filter, customEventFilter | conditions trop larges |
| Variable | name | recherche de {{nom}} dans le reste de l’export |
Balise googtag | paramètre tagId | identifiant de mesure G- |
Le contrôle en cinq étapes
-
Exporter la version à contrôler
Dans GTM, ouvrez Admin, puis cliquez sur Exporter le conteneur. Ouvrez le sélecteur de version ou d’espace de travail, choisissez la version à contrôler (ou un espace de travail si vous auditez un brouillon), puis cliquez sur Télécharger. Nommez le fichier avec la date et le numéro de version, par exemple
export-v3-2026-11-18.json, pour comparer deux exports plus tard.Résultat attendu : un fichier
.jsonunique, sans modification à la main. -
Enregistrer le script
Copiez le script ci-dessous dans un fichier
audit_gtm.py, dans un dossier qui ne contient que ce script et l’export. Il lit le fichier passé en argument, n’appelle aucun service et ne modifie rien.#!/usr/bin/env python3 """Contrôle d'un export JSON de conteneur Google Tag Manager. Usage : python audit_gtm.py chemin/vers/export.json Stdlib uniquement, lecture seule, aucun appel réseau. """ import json import re import sys # Convention de nommage : « Préfixe - Libellé ». Préfixes autorisés par type d'entité. PREFIXES = { "tag": {"GA4", "Google Ads", "Meta", "HTML", "Consent"}, "trigger": {"PV", "CE", "CL", "FS", "DL"}, "variable": {"DLV", "JS", "Const", "Url", "Cookie"}, } # Valeurs de regex ou de contenu qui matchent tout : déclencheur trop large. WIDE_VALUES = {"", ".*", ".+", "^.*$", ".*?"} TYPE_CONFIG = "googtag" # balise de configuration GA4 TYPE_HTML = "html" # balise HTML personnalisée ALL_PAGES_ID = "2147479553" # déclencheur intégré All Pages, absent du tableau trigger ID_RE = re.compile(r"^G-[A-Z0-9]{6,}$") def load(path): with open(path, encoding="utf-8") as f: data = json.load(f) return data.get("containerVersion", data) def walk_params(entity): """Tous les paramètres d'une entité, y compris list et map imbriqués.""" out, stack = [], list(entity.get("parameter", [])) while stack: p = stack.pop() out.append(p) stack.extend(p.get("list", []) + p.get("map", [])) return out def conditions(trigger): return (trigger.get("filter", []) + trigger.get("customEventFilter", []) + trigger.get("autoEventFilter", [])) def arg(condition, key): for p in condition.get("parameter", []): if p.get("key") == key: return p.get("value", "") return "" def is_wide(trigger): conds = conditions(trigger) if not conds and trigger.get("type") in ("pageview", "customEvent"): return True # pas de condition : se déclenche sur toutes les pages ou tous les événements return any(c.get("type") in ("matchRegex", "contains") and arg(c, "arg1") in WIDE_VALUES for c in conds) def naming_ok(name, kind): if " - " not in name: return False return name.split(" - ", 1)[0] in PREFIXES[kind] def label(e): eid = e.get("tagId") or e.get("triggerId") or e.get("variableId") return f'{e.get("name", "(sans nom)")} [id {eid}]' def audit(container): tags = container.get("tag", []) triggers = container.get("trigger", []) variables = container.get("variable", []) everything = [("tag", t) for t in tags] + [("trigger", t) for t in triggers] \ + [("variable", v) for v in variables] results = [] # 1. Balises en pause results.append(("PAUSE", "Balises en pause", [label(t) for t in tags if t.get("paused")])) # 2. Balises sans déclencheur results.append(("NO_TRIGGER", "Balises sans déclencheur", [label(t) for t in tags if not t.get("firingTriggerId")])) # 3. Déclencheurs jamais utilisés (par une balise, en déclenchement ou en blocage) used = set() for kind, e in everything: if kind == "tag": used.update(e.get("firingTriggerId", []) + e.get("blockingTriggerId", [])) for p in walk_params(e): if p.get("type") == "triggerReference": used.add(p.get("value")) results.append(("UNUSED_TRIGGER", "Déclencheurs jamais utilisés", [label(t) for t in triggers if t["triggerId"] not in used])) # 4. Variables jamais référencées : {{Nom}} absent de toutes les autres entités dumps = {id(e): json.dumps(e, ensure_ascii=False) for _, e in everything} def referenced(v): token = "{{" + v["name"] + "}}" return any(token in dumps[id(e)] for _, e in everything if e is not v) results.append(("UNUSED_VARIABLE", "Variables jamais référencées", [label(v) for v in variables if not referenced(v)])) # 5. Balises HTML personnalisées à relire à la main results.append(("HTML_REVIEW", "Balises HTML personnalisées à relire", [label(t) for t in tags if t.get("type") == TYPE_HTML])) # 6. Déclencheurs trop larges, utilisés par autre chose que la configuration GA4 wide = [] for t in triggers: if not is_wide(t): continue users = [x["name"] for x in tags if t["triggerId"] in x.get("firingTriggerId", []) and x.get("type") != TYPE_CONFIG] if users: wide.append(f'{label(t)} : utilisé par {", ".join(users)}') users = [x["name"] for x in tags if ALL_PAGES_ID in x.get("firingTriggerId", []) and x.get("type") != TYPE_CONFIG] if users: wide.append(f'All Pages intégré [id {ALL_PAGES_ID}] : utilisé par {", ".join(users)}') results.append(("WIDE_TRIGGER", "Déclencheurs trop larges (All Pages, .*)", wide)) # 7. Identifiant de mesure GA4 présent dans plusieurs balises de configuration seen = {} for t in tags: if t.get("type") != TYPE_CONFIG: continue for p in t.get("parameter", []): if p.get("key") == "tagId" and ID_RE.match(p.get("value", "")): seen.setdefault(p["value"], []).append(t["name"]) results.append(("DUP_MEASUREMENT_ID", "Identifiant de mesure en double", [f'{mid} dans : {", ".join(names)}' for mid, names in seen.items() if len(names) > 1])) # 8. Balises sans paramètre de consentement défini (absent ou notSet) no_consent = [] for t in tags: cs = t.get("consentSettings") status = "absent" if not cs else cs.get("consentStatus", "notSet") if status in ("absent", "notSet"): no_consent.append(f"{label(t)} : {status}") results.append(("NO_CONSENT", "Balises sans consentement défini", no_consent)) # 9. Noms hors convention names = [label(t) for t in tags if not naming_ok(t["name"], "tag")] names += [label(t) for t in triggers if not naming_ok(t["name"], "trigger")] names += [label(v) for v in variables if not naming_ok(v["name"], "variable")] results.append(("NAMING", "Noms hors convention « Préfixe - Libellé »", names)) return results, tags, triggers, variables def main(): if len(sys.argv) != 2: print("Usage : python audit_gtm.py export.json") return 2 sys.stdout.reconfigure(encoding="utf-8") container = load(sys.argv[1]) results, tags, triggers, variables = audit(container) print(f'Conteneur : {container.get("container", {}).get("name", "?")} ' f'(version {container.get("containerVersionId", "?")})') print(f"Balises : {len(tags)} | Déclencheurs : {len(triggers)} | Variables : {len(variables)}") total = 0 for code, title, lines in results: print(f"\n[{code}] {title} : {len(lines)}") for line in lines: print(f" - {line}") total += len(lines) print(f"\nTotal : {total} point(s) à relire. Un point signalé n'est pas forcément une erreur.") return 0 if __name__ == "__main__": sys.exit(main()) -
Lancer le script
Depuis le dossier du script :
python audit_gtm.py export-v3-2026-11-18.jsonSortie obtenue sur le conteneur d’exemple synthétique, exécution du 18 novembre 2026 avec Python 3.14.3 :
Conteneur : Site exemple (version 3) Balises : 10 | Déclencheurs : 9 | Variables : 3 [PAUSE] Balises en pause : 1 - GA4 - purchase (ancien) [id 1005] [NO_TRIGGER] Balises sans déclencheur : 1 - Google Ads - Conversion achat [id 1007] [UNUSED_TRIGGER] Déclencheurs jamais utilisés : 1 - CE - newsletter_signup [id 2008] [UNUSED_VARIABLE] Variables jamais référencées : 2 - DLV - unused_old [id 3002] - Ancienne variable [id 3003] [HTML_REVIEW] Balises HTML personnalisées à relire : 3 - HTML - Pixel chat [id 1006] - tag-divers [id 1008] - Meta - Pixel base [id 1010] [WIDE_TRIGGER] Déclencheurs trop larges (All Pages, .*) : 3 - PV - Toutes les pages (pixel) [id 2002] : utilisé par HTML - Pixel chat - CE - .* [id 2004] : utilisé par GA4 - Événements génériques - All Pages intégré [id 2147479553] : utilisé par Meta - Pixel base [DUP_MEASUREMENT_ID] Identifiant de mesure en double : 1 - G-EXEMPLE001 dans : GA4 - Configuration, GA4 - Configuration (doublon) [NO_CONSENT] Balises sans consentement défini : 4 - GA4 - Configuration (doublon) [id 1002] : notSet - HTML - Pixel chat [id 1006] : notSet - tag-divers [id 1008] : notSet - GA4 - Conversion lead [id 1009] : absent [NAMING] Noms hors convention « Préfixe - Libellé » : 3 - tag-divers [id 1008] - Trigger sans préfixe [id 2006] - Ancienne variable [id 3003] Total : 19 point(s) à relire. Un point signalé n'est pas forcément une erreur.Chaque contrôle s’est déclenché sur le cas prévu dans l’export d’exemple, et l’exemple ne produit aucun résultat en dehors de ces cas. La balise GA4 de configuration posée sur toutes les pages n’apparaît pas dans
WIDE_TRIGGER, parce que c’est son usage normal. -
Lire chaque code et classer par risque
Les neuf codes ne se valent pas. Le tableau donne le signal, le risque et mon repère de priorité. Ce sont mes repères de décision, pas une norme.
Code Signal Risque Mon repère PAUSEBalise suspendue Suivi coupé sans que personne le sache Critique si conversion NO_TRIGGERBalise sans déclencheur Balise qui ne part jamais Élevé UNUSED_TRIGGERDéclencheur sans balise Dette de maintenance Faible UNUSED_VARIABLEVariable non citée Dette, à supprimer après contrôle Faible HTML_REVIEWBalise HTML personnalisée Code tiers exécuté sur le site Élevé WIDE_TRIGGERAll Pages ou .*hors GA4Balise envoyée à chaque page ou événement Élevé DUP_MEASUREMENT_IDMême G-dans deux configurationsPages vues ou sessions comptées deux fois Critique NO_CONSENTConsentement absent ou notSetBalise sans réglage explicite Critique pour le marketing NAMINGNom hors « Préfixe - Libellé » Relecture plus lente Faible Google documente
notSetcomme la valeur par défaut, sans réglage saisi sur la balise (référence API Tag Manager v2). Une balisenotSetn’a donc pas de réglage de consentement : c’est une question à trancher, pas forcément une erreur.Deux lectures complètent le tableau. Un conteneur hérité d’un plugin tout-en-un peut contenir des balises dupliquées : la méthode pour remplacer un plugin par GTM explique comment les inventorier avant la bascule. Un déclenchement en double peut aussi venir d’un changement de Google : les événements gtag.config et pages vues bfcache peuvent activer un déclencheur trop large, à vérifier avant de conclure à une erreur de balise.
-
Corriger, republier, réexporter
Corrigez dans un espace de travail, pas dans la version publiée. Publiez, réexportez la nouvelle version, relancez le script sur ce nouvel export et comparez les totaux. Le total doit baisser, et aucun code nouveau ne doit apparaître. Si un code nouveau apparaît, la correction a créé un problème : revenez sur la modification.
Un script lancé une seule fois ne protège pas le conteneur : le cycle sert à repérer les dérives après la prochaine modification.
Les limites du script
- Il lit un export, pas le comportement du site. Une balise bien configurée peut ne jamais se déclencher : vérifiez les parcours dans le mode aperçu.
- La détection des variables repose sur le texte
{{nom}}. Une variable citée autrement, ou un nom mal écrit dans un code tiers, peut être signalée à tort ou manquée. - Le script lit
consentStatusseulement. Il ne vérifie ni leconsentType, ni la logique de votre CMP, ni le comportement réel du bandeau. - Il ne voit pas la propriété GA4 : les réglages d’administration se contrôlent avec la checklist d’audit GA4 en 32 points.
Pas suivant
Lancez le script sur l’export de votre version publiée et classez les codes par risque en commençant par DUP_MEASUREMENT_ID, NO_CONSENT et PAUSE sur les balises de conversion. Si la liste reste longue après correction, un audit de tracking complet, avec tests de parcours, est l’étape suivante.
Sources
- Exporter et importer des conteneurs, aide Google Tag Manager, lue le 18 novembre 2026.
- Référence API Tag Manager v2, ressource ContainerVersion, lue le 18 novembre 2026.
- Référence API Tag Manager v2, ressources Tag, Trigger et Variable, lue le 18 novembre 2026, avec les pages Trigger, Variable, Condition et Parameter de la même référence.