DebugView GA4 et Tag Assistant : vérifier ses balises pas à pas

Tag Assistant et DebugView : à quoi sert chaque outil

Vérifier ses balises, c'est répondre à une question simple : quand un visiteur remplit un formulaire ou clique sur votre numéro de téléphone, est-ce que l'information arrive bien dans vos statistiques ? Si la réponse est non, vos tableaux de bord mentent. Vos campagnes sont pilotées à l'aveugle, et le budget part vers les mauvais mots-clés.

Deux outils gratuits de Google permettent de le savoir. Ils ne font pas le même travail. Le mieux est de les utiliser l'un après l'autre, dans cet ordre.

Tag Assistant : ce qui se passe dans le navigateur

Tag Assistant est l'outil de diagnostic de la google tag et de Google Tag Manager. Il affiche, pour chaque action sur la page, les balises qui se sont déclenchées et celles qui sont restées muettes. Il montre aussi les valeurs des variables à cet instant précis. C'est le point de vue de votre website : ce qu'il essaie d'envoyer.

La DebugView dans Google Analytics : ce que GA4 reçoit

La DebugView se trouve dans votre propriété Google Analytics 4. Elle affiche en direct les événements reçus d'un appareil en mode débogage, avec chaque paramètre et chaque propriété user. C'est le point de vue de l'autre côté : ce qui est vraiment arrivé. Si vous débutez avec l'outil, notre définition de Google Analytics 4 pose les bases.

Et le rapport Temps réel, alors ?

Le rapport Temps réel mélange tous vos visiteurs. Sur un site qui reçoit un peu de trafic, impossible d'y retrouver votre propre test. La DebugView, elle, isole un seul appareil : le vôtre. Elle détaille aussi les paramètres de chaque événement, ce que le rapport Temps réel fait mal. Pour valider une configuration, c'est donc elle qu'il faut ouvrir.

Étape 1 : lancer le preview mode de Google Tag Manager

Si votre suivi passe par Google Tag Manager, tout commence par le mode aperçu. Il permet de tester vos modifications sur le vrai site, sans rien publier pour les visiteurs. Si vous n'avez pas encore installé GA4 de cette façon, notre guide pour installer GA4 avec GTM détaille la mise en place.

Ouvrir l'aperçu et connecter le site

• Dans votre conteneur, cliquez sur « Prévisualiser » (« Preview » si l'interface est en anglais), en haut à droite.
• Tag Assistant s'ouvre dans un nouvel onglet. Saisissez l'adresse de la page à tester, puis connectez-vous.
• Votre site s'ouvre dans une nouvelle fenêtre, avec un badge qui confirme la connexion à Tag Assistant.
• Gardez les deux fenêtres ouvertes : vous agissez sur le site, vous lisez le résultat dans Tag Assistant.

Une extension Chrome dédiée à Tag Assistant existe et facilite cette connexion. Elle n'est pas toujours obligatoire, mais elle évite certains blocages, notamment quand le site s'ouvre mal dans une nouvelle fenêtre.

Lire le résumé, action par action

La colonne de gauche liste les étapes de chargement de la page, puis chacune de vos actions : clic, envoi de formulaire, défilement. Cliquez sur une étape pour voir les balises déclenchées à ce moment-là, et celles qui ne l'ont pas été. Une balise de conversion qui apparaît dans la partie « non déclenchées » après un envoi de formulaire, c'est le signal d'un déclencheur mal réglé.

Faites le parcours d'un vrai client. Arrivée sur la page d'accueil, visite d'une page service, clic sur le bouton d'appel à l'action, envoi du formulaire de devis. À chaque étape, vérifiez que la bonne balise s'est déclenchée, une seule fois. Une balise qui se déclenche deux fois gonfle vos conversions aussi sûrement qu'une balise absente les fait disparaître.

Inspecter les variables et la couche de données

Les onglets « Variables » et « Couche de données » montrent les valeurs disponibles à chaque étape. C'est là qu'on repère une valeur de commande vide, un identifiant de formulaire qui a changé après une mise à jour du thème, ou une variable mal nommée. Prenez l'habitude de regarder ces onglets avant de conclure qu'une balise fonctionne. Pour mieux comprendre la logique balise, déclencheur et variable, notre définition de Google Tag Manager reprend tout depuis le début.

Étape 2 : enable debug mode pour alimenter la DebugView GA4

La DebugView n'affiche que les appareils en mode débogage. Il faut donc d'abord l'activer. Il existe trois façons de le faire, et le choix dépend de la façon dont votre suivi est installé.

Méthode 1 : passer par l'aperçu de Tag Manager

C'est la plus simple. Quand le preview mode de Google Tag Manager est actif, les événements GA4 envoyés depuis la fenêtre de test sont automatiquement marqués en débogage. Vous n'avez rien à ajouter. Ouvrez la DebugView en parallèle et vos actions y apparaissent au bout de quelques secondes.

Méthode 2 : ajouter le paramètre debug_mode

Si vous n'utilisez pas Tag Manager, ou si vous voulez tester sur un environnement de préproduction pendant plusieurs jours, vous pouvez ajouter le parameter debug_mode avec la valeur true. Dans Tag Manager, il se place dans les paramètres de configuration de la balise Google. Dans un code gtag installé à la main, il s'ajoute dans la commande de configuration. Vous pouvez aussi le poser sur un seul événement si vous ne voulez déboguer que celui-là.

Méthode 3 : l'extension Chrome Google Analytics Debugger

C'est ce que beaucoup cherchent sous le nom de « ga4 debugview chrome extension ». L'extension Google Analytics Debugger active le mode débogage pour votre seul navigateur, d'un clic sur son icône. Pratique pour contrôler un site sans toucher au code ni au conteneur, par exemple pendant un audit. Pensez à la désactiver après le test, sinon vos visites suivantes continueront d'arriver en débogage.

• Site sous Tag Manager : utilisez l'aperçu, c'est le plus fiable.
• Site avec un code gtag direct ou un module de CMS : l'extension ou le paramètre.
• Préproduction testée sur plusieurs jours : le paramètre, limité à cet environnement.
• Application mobile : la documentation Firebase prévoit une commande spécifique pour activer le débogage sur l'appareil.

Étape 3 : lire la DebugView et valider chaque événement

Le mode débogage est actif. Ouvrez maintenant la DebugView : dans Google Analytics, allez dans « Administration », puis « Affichage des données », puis « DebugView ». Gardez cet onglet à côté de votre site, et refaites le parcours testé dans Tag Assistant.

Choisir le bon appareil de débogage

En haut de l'écran, un menu liste les appareils de débogage actifs. Si un collègue ou votre prestataire teste en même temps, plusieurs appareils apparaissent. Sélectionnez le vôtre. Si la liste reste vide, revenez à l'étape précédente : le mode débogage n'est pas encore actif, ou les données n'arrivent pas.

Comprendre les deux flux

La colonne centrale déroule les événements seconde par seconde, sur la dernière minute. La colonne de gauche les regroupe minute par minute, sur la demi-heure écoulée. À droite, vous retrouvez les événements les plus fréquents sur la période et les propriétés utilisateur. Les événements que vous avez déclarés comme événements clés ressortent visuellement, ce qui permet de repérer d'un coup d'œil si la conversion attendue est bien là.

Ouvrir chaque événement et vérifier ses paramètres

Cliquez sur un événement : ses paramètres s'affichent. C'est l'étape la plus utile, et la plus souvent sautée. Un événement « generate_lead » qui arrive sans le nom du formulaire ne vous dira jamais quel formulaire rapporte. Un achat sans valeur rend impossible le calcul du retour sur vos campagnes.

• Le nom de l'événement est-il exactement celui prévu, sans faute de frappe ni majuscule en trop ?
• Chaque paramètre attendu est-il présent, avec une valeur cohérente ?
• L'événement arrive-t-il une seule fois par action ?
• La page de l'événement, le paramètre page_location, correspond-elle bien à la page testée ?
• Les propriétés utilisateur que vous avez définies sont-elles renseignées ?

Une fois l'événement validé, notez-le. Ces données alimenteront vos indicateurs clés de performance, et un indicateur n'a de valeur que si la mesure qui le nourrit a été vérifiée. Les notions d'utilisateur, de session et d'événement sont détaillées dans notre article sur le vocabulaire de la mesure GA4.

DebugView GA4 not working : pourquoi rien ne s'affiche

C'est la recherche la plus fréquente après la mise en place, en anglais comme en japonais : la DebugView reste vide. Dans la grande majorité des cas, la cause est l'une de celles qui suivent. Prenez-les dans l'ordre, de la plus simple à la plus technique.

Le consentement cookies a été refusé

Si votre bandeau cookies bloque Analytics tant que le visiteur n'a pas accepté, vos tests sont bloqués aussi. Acceptez les cookies de mesure dans la fenêtre de test. Avec le mode consentement de Google, un refus peut aussi changer la façon dont les données sont envoyées. Notre article sur le Consent Mode v2 explique ces mécanismes, et celui sur le bandeau cookies RGPD rappelle ce que la loi impose : les cookies strictement nécessaires d'un côté, les cookies de mesure et de marketing soumis à votre choix de l'autre.

Un bloqueur de publicité filtre les envois

Les bloqueurs de publicité et certains navigateurs axés sur la confidentialité coupent les envois vers Google Analytics. Testez dans une fenêtre sans extension, ou désactivez le bloqueur pour votre propre domaine. C'est aussi un rappel utile : une partie de vos vrais visiteurs ne sera jamais mesurée, quoi que vous fassiez.

Les données partent vers la mauvaise propriété

Vérifiez l'ID de mesure, qui commence par G-, dans votre balise Google. Il doit correspondre à la propriété que vous regardez. Sur les sites qui ont connu plusieurs prestataires, il n'est pas rare de trouver deux codes de suivi, dont un vers une ancienne propriété oubliée. Tag Assistant affiche les ID détectés sur la page, ce qui permet de trancher vite.

Les autres causes à éliminer

• Le mauvais appareil est sélectionné dans le menu de la DebugView.
• Un filtre de données exclut votre trafic, par exemple un filtre de trafic interne basé sur l'adresse IP du bureau.
• Le mode débogage n'est pas actif : aperçu fermé, extension éteinte ou paramètre absent.
• La balise Google ne se déclenche pas sur toutes les pages, à vérifier dans Tag Assistant.
• Un cache de page ou un module d'optimisation sert une ancienne version du site, sans le nouveau code.
• Vous n'avez pas les droits suffisants sur la propriété Analytics pour voir l'écran de débogage.

Laissez aussi quelques secondes aux données pour arriver. Si rien n'apparaît après plusieurs minutes et plusieurs actions, le problème est réel. Revenez alors à Tag Assistant : si la balise ne part pas, inutile de chercher du côté de GA4.

Après les tests : nettoyer, publier et documenter

Un test réussi ne vaut que si la version testée est bien celle que vos visiteurs reçoivent. Dans Tag Manager, l'aperçu ne publie rien. Une fois les contrôles terminés, il faut publier une nouvelle version du conteneur, avec un nom et une description clairs. Vous pourrez ainsi revenir en arrière en cas de souci.

Retirer ce qui ne doit pas rester en production

Retirez le paramètre debug_mode s'il a été ajouté, et désactivez l'extension de débogage. Vous pouvez ensuite activer, dans les filtres de données de la propriété, le filtre de trafic de développeur : il écarte les événements envoyés en mode débogage de vos rapports. Testez-le d'abord en mode test, puis activez-le. Vos chiffres ne seront pas gonflés par vos propres essais.

Tenir un plan de marquage simple

Un tableau suffit : le nom de chaque événement, ce qui le déclenche, ses paramètres, la date du dernier contrôle. C'est ce document qui permet de refaire les tests rapidement après une refonte, un changement de thème ou l'ajout d'une page. Il évite aussi de perdre la mémoire du suivi quand le prestataire change.

Savoir quand refaire les contrôles

Le temps à prévoir dépend du nombre d'événements suivis, du nombre de formulaires et de la propreté du conteneur hérité. Un site vitrine avec deux conversions se vérifie bien plus vite qu'une boutique avec un tunnel d'achat complet. Refaites un contrôle après chaque mise en ligne qui touche aux formulaires, aux boutons ou au code de suivi, et avant de lancer une nouvelle campagne payante.

C'est aussi pour cela qu'on gagne à poser le suivi dès la construction du site, plutôt qu'après coup. Lors d'une création de site internet chez RankerSquare, la mesure fait partie du projet : un site vitrine sur-mesure est proposé dès 19,90 € par mois en abonnement, et les besoins de suivi plus poussés sont chiffrés sur devis.

Questions fréquentes