Google Tag Assistant : déboguer vos balises étape par étape

Google Tag Assistant est l’outil gratuit de Google pour vérifier que les balises de votre site web fonctionnent correctement. Vous voyez, par page et par clic, quelles balises se déclenchent, lesquelles ne se déclenchent pas, quelles données elles envoient et quel statut de consentement s’applique. C’est donc le moyen le plus rapide de découvrir pourquoi une conversion manque, est comptée deux fois ou reçoit la mauvaise valeur. Dans cet article, vous découvrez comment ouvrir Tag Assistant, comment lire une session de débogage et quels contrôles effectuer au minimum avant de publier quoi que ce soit.

Qu’est-ce que Google Tag Assistant ?

Dans son centre d’aide, Google décrit Tag Assistant comme un outil permettant de « vérifier l’implémentation et le fonctionnement des balises sur votre site web ». Vous examinez les balises, les événements et les données, et vous pouvez exporter et importer des sessions de débogage pour les partager avec vos collègues.

Tag Assistant fonctionne via le site tagassistant.google.com, avec une extension Chrome facultative, Tag Assistant Companion. Cette extension est utile dans deux situations difficiles à tester autrement : les balises dans un iframe (pensez à un formulaire intégré ou à un outil d’agenda) et les pop-ups ou nouveaux onglets qui s’ouvrent depuis votre page. Vous cherchez encore l’ancienne extension autonome « Tag Assistant Legacy » ? Travaillez aujourd’hui avec la version web et l’extension Companion.

Trois façons d’ouvrir Tag Assistant

Via Preview dans Google Tag Manager

C’est l’accès que vous utiliserez le plus souvent. Dans votre espace de travail GTM, cliquez en haut à droite sur Preview. Selon la documentation de GTM, Tag Assistant s’ouvre alors dans un nouvel onglet ; vous saisissez l’URL de votre site et cliquez sur Connect. Votre site s’ouvre dans une nouvelle fenêtre avec la mention « Connected » en bas à droite. Tout ce que vous faites ensuite sur le site apparaît dans la vue de débogage.

Via tagassistant.google.com

Sur tagassistant.google.com, choisissez Add domain et saisissez votre URL. Tag Assistant ajoute un paramètre de débogage (_dbg) à l’URL et suit votre session. Cela fonctionne aussi sur des sites auxquels vous n’avez pas accès dans GTM, par exemple pour jeter un œil rapide à la balise Google d’un nouveau client.

Via le DebugView de GA4

Une balise qui se déclenche n’est pas encore un événement que GA4 traite correctement. C’est pourquoi vous vérifiez aussi dans GA4, sous Administration > DebugView. Selon l’explication de Google sur DebugView, les sessions issues de Tag Assistant ou du mode prévisualisation y apparaissent automatiquement. Attention : les événements ne sont pas visibles dans DebugView si le consent mode est actif et que l’utilisateur de test n’a pas donné son consentement. Acceptez donc les cookies dans votre fenêtre de test, ou testez délibérément aussi le scénario du refus.

Lire une session de débogage : étape par étape

1. Commencez par la chronologie à gauche

À gauche, vous voyez une chronologie avec chaque moment que GTM enregistre : le chargement du conteneur, « Consent Initialization », « Initialization », « Container Loaded », « DOM Ready », « Window Loaded », puis chaque clic, envoi de formulaire ou événement personnalisé issu de votre data layer. Cliquez sur un moment pour voir ce qui s’est passé à cet instant. Effectuez maintenant l’action que vous voulez tester, par exemple envoyer un formulaire, et cherchez le moment correspondant.

2. Contrôlez Tags Fired et Tags Not Fired

Pour chaque moment, Tag Assistant indique quelles balises se sont déclenchées et lesquelles non. Votre balise de conversion figure sous « Not Fired » ? Cliquez dessus : vous voyez quelle condition de déclenchement n’a pas été remplie. Se déclenche-t-elle au contraire sur chaque page au lieu de seulement après l’envoi, alors votre déclencheur est trop large.

3. Examinez les données dans Variables et Data Layer

Dans l’onglet Variables, vous voyez la valeur de chaque variable à ce moment-là : la valeur de conversion, l’ID du formulaire, la page. Dans l’onglet Data Layer, vous voyez ce que votre site a exactement transmis. Si la valeur est correcte dans la data layer mais pas dans la variable, l’erreur se trouve dans GTM. Si elle manque déjà dans la data layer, l’erreur se trouve sur le site. Pour en savoir plus sur cette structure, lisez notre article la data layer expliquée.

4. Contrôlez le statut de consentement

Dans l’onglet Consent, vous voyez le statut par défaut et le statut mis à jour pour chaque type de consentement, comme ad_storage et analytics_storage. Testez au moins deux scénarios : tout accepté et tout refusé. Dans le second cas, les balises publicitaires ne peuvent pas déposer de cookies. Pour comprendre le fonctionnement du consent mode, lisez notre article sur le consent mode v2 pour Google Ads.

5. Contrôlez la réception dans la plateforme

Rendez-vous ensuite dans la plateforme elle-même : le DebugView de GA4, le diagnostic des conversions dans Google Ads, les événements de test dans le Meta Events Manager. Votre test n’est réussi que lorsque l’événement y arrive avec les bons paramètres.

6. Partagez la session

Un développeur ou un collègue doit jeter un œil ? Dans Tag Assistant, choisissez More Actions puis Share pour partager un lien de prévisualisation. Vous pouvez aussi exporter une session, ce qui est pratique pour montrer un problème plus tard.

Checklist : que tester par plateforme ?

Les erreurs fréquentes que nous trouvons avec Tag Assistant

• Une conversion qui se déclenche à chaque page vue. Souvent un déclencheur sur « All Pages » ou sur une page de remerciement qui se recharge aussi via le bouton retour.
• Deux configurations GA4 en même temps. Une balise Google codée en dur dans le thème plus une balise dans GTM : chaque page view est comptée deux fois.
• Des formulaires dans un iframe. Sans l’extension Companion, vous ne les voyez pas, et sans mesure distincte, ils ne sont pas comptés.
• Du trafic de test dans vos chiffres. Chez Tryve, l’audit a révélé que des hits de test étaient comptés comme de vraies conversions et atterrissaient ainsi dans la stratégie d’enchères de Google Ads. Filtrez le trafic interne et de test dans GA4 et testez de préférence les conversions dans un environnement distinct.
• Oublier un test réussi après une mise à jour de formulaire. Chez Suivo, une mise à jour de formulaire a interrompu la mesure des leads sans le moindre message d’erreur. Nous en avons trouvé la cause grâce à une analyse des causes profondes dans GTM Preview.

Vous trouverez d’autres schémas dans notre article sur les erreurs de tracking dans Google Analytics.

Déboguer les conteneurs server-side

Si vous travaillez avec le server side tagging, votre conteneur serveur dispose de son propre mode prévisualisation. Vous y voyez, pour chaque requête entrante, quel client l’a captée, quelles balises se sont déclenchées et quelles requêtes sortantes sont parties vers GA4, Google Ads ou Meta, avec leur code de statut. Testez le conteneur web et le conteneur serveur ensemble : un événement qui part correctement du navigateur peut encore échouer dans le serveur.

Quand Tag Assistant ne suffit-il pas ?

Tag Assistant montre une seule session dans un seul navigateur. Il ne vous dit pas si vos chiffres sont corrects sur un mois, si GA4 et Google Ads comptent le même nombre de leads ou si votre CRM et vos plateformes publicitaires concordent. Pour cela, il vous faut un contrôle plus large. Un audit tracking met côte à côte vos balises, le consentement, les conversions et les écarts entre plateformes, et vous fournit une liste priorisée de ce qu’il faut corriger en premier. Lisez aussi pourquoi les conversions diffèrent entre Google Ads et GA4.

Questions fréquentes

Google Tag Assistant est-il gratuit ?

Oui. Tag Assistant sur tagassistant.google.com et l’extension Companion sont gratuits. Il vous faut un compte Google et, pour le mode prévisualisation de GTM, un accès au conteneur.

Pourquoi Tag Assistant n’affiche-t-il pas mon site comme « Connected » ?

En général, quelque chose bloque la connexion : un adblocker, une bannière cookies qui empêche le chargement du conteneur, une redirection vers une autre URL ou un blocage des pop-ups. Essayez une fenêtre privée sans extensions, et vérifiez que le snippet GTM est bien présent sur la page.

Pourquoi ne vois-je pas mes événements dans le DebugView de GA4 ?

Souvent parce que le consentement a été refusé dans votre session de test : les événements ne sont alors pas visibles dans DebugView. Vérifiez aussi que vous consultez la bonne propriété GA4 et que la session de débogage est toujours active.

Tag Assistant fonctionne-t-il aussi pour le pixel Meta ou LinkedIn ?

Tag Assistant indique si la balise se déclenche dans GTM, y compris pour Meta ou LinkedIn. Pour savoir si la plateforme reçoit correctement l’événement, vérifiez dans les outils de cette plateforme, comme les événements de test dans le Meta Events Manager.

Puis-je utiliser Tag Assistant sans Google Tag Manager ?

Oui. Via « Add domain » sur tagassistant.google.com, vous déboguez aussi un site qui utilise directement la balise Google. Vous voyez alors la balise Google et les événements, mais pas les onglets propres à GTM comme les déclencheurs.

Faites contrôler vos balises

Vous voyez dans Tag Assistant des choses que vous ne pouvez pas expliquer, ou vous voulez être sûr que chaque conversion est correcte avant d’investir davantage de budget ? Avec un audit tracking, nous contrôlons l’ensemble de votre configuration, et notre spécialiste tracking corrige ce qui ne va pas. Pour les bases de votre conteneur, lisez aussi notre article sur Google Tag Manager. Contactez-nous si vous voulez en discuter directement.