Google Tag Assistant : voir quelles balises se déclenchent et ce qui les a cassées

Qu'est-ce que Google Tag Assistant et que montre-t-il ?

Google Tag Assistant est un outil web, sur tagassistant.google.com, qui vérifie les installations de la balise Google (gtag.js) et de Google Tag Manager et aide à les dépanner, y compris les balises Google Analytics et Google Ads. Il a remplacé l'ancien mode aperçu de Tag Manager, qui reposait sur des cookies tiers de plus en plus bloqués par les navigateurs.

Dans une seule session de débogage, vous suivez tout le domaine, page par page, et vous voyez :

• chaque événement, numéroté dans l'ordre de déclenchement et regroupé par page ;
• l'appel d'API derrière chaque événement, gtag() ou dataLayer.push() ;
• les hits envoyés, avec leur destination, leur type et les paramètres de chacun ;
• les valeurs de la couche de données, les événements de mesure améliorée de Google Analytics et les erreurs.

Pour les conteneurs Tag Manager, la vue de débogage indique aussi quelles balises se sont déclenchées ou non à chaque événement, les valeurs des variables et l'état du consentement lorsque le mode consentement est actif. Ces informations ne s'affichent que dans votre session, jamais pour les visiteurs.

Ce que Tag Assistant ne vous donne pas, c'est l'historique. Il montre le comportement des balises maintenant, dans votre navigateur. Si une balise ne se déclenche plus depuis mardi dernier, il vous reste à trouver ce qui a changé mardi dernier.

Comment lancer une session de débogage dans Tag Assistant ?

Partez de tagassistant.google.com pour tout site équipé de la balise Google, ou du bouton Prévisualiser de Tag Manager pour tester des modifications de l'espace de travail pas encore publiées.

Depuis Tag Assistant

1. Ouvrez tagassistant.google.com et cliquez sur « Add domain ».
2. Saisissez l'URL du site, en commençant par https:// ou http://.
3. Cliquez sur « Connect ». Le site s'ouvre dans une nouvelle fenêtre avec le paramètre de débogage _dbg dans l'URL.
4. Parcourez les pages et les actions à tester. Tag Assistant se met à jour au fil de la navigation.

Depuis Google Tag Manager

1. Ouvrez le conteneur et, dans l'onglet « Espace de travail », cliquez sur « Prévisualiser ». Tag Assistant s'ouvre dans un nouvel onglet.
2. Saisissez l'URL du site et cliquez sur « Se connecter ». Le site affiche « Connecté » en bas à droite.
3. Revenez dans l'onglet Tag Assistant et cliquez sur « Continuer » pour ouvrir l'interface de débogage.

Si le paramètre de débogage casse le site, décochez « Inclure le signal de débogage dans l'URL » avant de vous connecter. Google recommande l'extension Tag Assistant pour Chrome : elle permet de déboguer les balises dans des iframes (possible uniquement avec l'extension), les pop-ups, les nouveaux onglets et plusieurs fenêtres à la fois. Pour terminer, cliquez sur le X en haut à gauche de l'interface ou sur « Arrêter le débogage ». Pour reprendre une session, choisissez le domaine sous « Active Domains » ou « History » sur la page d'accueil de Tag Assistant (son aide n'existe qu'en anglais, d'où certains libellés en anglais).

Comment lire ce qu'affiche Tag Assistant ?

Lisez de gauche à droite : choisissez un événement dans la chronologie, puis vérifiez ce qu'il a envoyé et quelles balises il a déclenchées.

La session s'ouvre sur la vue « Summary ». Si la page contient plusieurs balises Google ou conteneurs, choisissez-en un en haut ; les hits sont alors filtrés sur cet ID. La colonne de gauche est la chronologie des événements ; ceux marqués d'une icône <> sont des événements intégrés que la balise Google envoie au chargement.

Une balise dans « Tags Fired » ne clôt pas la vérification. Ouvrez le hit et lisez les paramètres : une balise d'achat qui se déclenche avec une valeur de 0 ou sans devise gêne autant les enchères qu'une balise qui ne se déclenche pas. Tag Assistant signale aussi les événements envoyés à un produit Google sans que la balise Google correspondante se soit déclenchée avant.

Pourquoi ma balise Google ne se déclenche-t-elle pas ?

Dans la plupart des cas, une balise cesse de fonctionner à cause d'une modification : du site, du conteneur, du consentement ou du parcours des pages. Le tableau liste les causes courantes et la façon dont chacune apparaît.

Certaines limites tiennent à l'outil : les pages AMP ne sont pas prises en charge, et les balises dans des iframes ne se déboguent qu'avec l'extension Chrome. Si la balise Google se charge après la tentative de connexion de Tag Assistant, cliquez sur « Retry ». Les outils de consentement peuvent bloquer les balises Google s'ils ne sont pas configurés pour fonctionner avec l'API de consentement de Google ; ce cas a son propre article sur comment prouver qu'une bannière de consentement a fait chuter les conversions.

Comment isoler la modification qui a cassé la balise ?

Tag Assistant vous dit que la balise est cassée aujourd'hui. Pour savoir quelle modification en est la cause, trouvez le dernier jour où elle fonctionnait et alignez tout ce qui a changé ce jour-là et juste avant.

1. Trouver le dernier jour où ça marchait
2. Aligner les modifications d'avant
3. Tester le suspect dans Tag Assistant
4. Corriger et consigner la correction

Servez-vous de vos rapports pour dater la panne : le jour où les événements GA4 ou les conversions Google Ads tombent à zéro ou changent de palier. Rassemblez ensuite les modifications de cette période : versions du conteneur publiées dans Tag Manager (la liste des Versions indique quand chacune a été publiée et par qui), mises en production du site, mises à jour du CMS ou du thème, changements de la bannière de consentement, du tunnel de paiement ou des formulaires. Ouvrez la version publiée au plus près de la panne et regardez quelles balises, quels déclencheurs et quelles variables elle a touchés ; l'article sur l'historique des versions de Google Tag Manager explique comment.

Testez ensuite un suspect à la fois. Prévisualisez la version d'avant la panne et la version actuelle, refaites le même parcours (par exemple l'envoi d'un formulaire de test) et comparez « Tags Fired » et les hits. Si l'ancienne version se déclenche et pas la nouvelle, la cause est dans le conteneur. Si les deux échouent, cherchez du côté du site.

Avec toutes les modifications sur une seule frise chronologique, cela prend quelques minutes au lieu d'un après-midi : vous verriez qu'une version du conteneur et une mise en production du tunnel de paiement sont sorties la veille de la chute, et vous testeriez ces deux-là d'abord. Dans Changeline, l'équipe consigne les modifications du site, des balises et du consentement avec la date, le responsable et la raison, et les modifications Google Ads sont importées automatiquement via une connexion en lecture seule : une panne de suivi et un changement d'enchères de la même semaine apparaissent côte à côte.

Exemple : un client demande pourquoi les leads Google Ads sont tombés à zéro jeudi. Tag Assistant affiche la balise du formulaire dans « Tags Not Fired ». La frise du mercredi contient deux entrées : une version du conteneur qui ajoute un widget de chat et une mise en production du site qui renomme l'événement du formulaire de form_submit en lead_submit. En prévisualisant l'ancien conteneur sur le site actuel, la balise échoue toujours : le conteneur n'est donc pas en cause, le déclencheur attend un événement que le site n'envoie plus. Corriger le déclencheur règle le problème, et la réponse au client tient en une phrase datée. Noms et chiffres donnés à titre d'illustration.

Comment partager une session de débogage ou tester une ancienne version du conteneur ?

Vous pouvez confier la session de débogage à un collègue ou à un développeur au lieu de décrire le problème par e-mail.

• Partager l'aperçu de l'espace de travail : dans Tag Assistant, cliquez sur « Autres actions », puis sur « Partager ». Dans la boîte « Partager la session de débogage », saisissez le domaine du site, copiez l'URL d'aperçu et envoyez-la.
• Prévisualiser une ancienne version : dans Tag Manager, ouvrez « Versions », ouvrez « Autres actions » sur la version et choisissez « Prévisualiser », ou l'option de partage de l'aperçu pour l'envoyer à quelqu'un.
• Exporter la session : Tag Assistant permet d'exporter et d'importer des sessions de débogage, pour qu'un développeur ouvre exactement ce que vous avez vu.

Le mode aperçu ne fonctionne que dans le navigateur où vous l'avez lancé, ou pour les personnes avec qui vous l'avez partagé. Tester la version d'avant la panne sur le site actuel est le moyen le plus rapide de distinguer un problème de conteneur d'un problème de site.

Comment éviter qu'une balise casse sans que personne ne le voie à la prochaine mise en production ?

Traitez le suivi comme du code : chaque modification a un nom, une date et un test.

1. Nommez chaque version du conteneur. Tag Manager demande un nom et une description de version à la publication, et l'exemple donné par Google est « GA page view tag - initial launch ». Un nom clair est votre premier indice quand vous chercherez une panne des mois plus tard.
2. Lancez Tag Assistant après chaque mise en production du site, pas seulement après des changements dans Tag Manager. Beaucoup de pannes viennent du site : une classe renommée, un nouveau modèle, une étape du paiement déplacée.
3. Testez de bout en bout les événements qui rapportent, comme l'achat, le lead et l'inscription, et ouvrez les hits pour vérifier la valeur, la devise et l'ID de transaction.
4. Consignez la modification là où toute l'équipe la voit, avec la raison et son auteur, à côté des modifications de campagnes et du site. Un modèle de journal des modifications marketing suffit pour commencer, et le guide du journal des modifications marketing explique quoi noter.
5. Signalez les corrections de suivi dans vos rapports. Quand les conversions reviennent après une correction, ajoutez une note pour que personne n'y voie un gain de performance ; voir les annotations GA4.

Si une balise cassée vous a déjà coûté une semaine de conversions, le guide pour expliquer une baisse de conversions à un client vous aide à présenter la date, la cause et la correction.