Ce guide vous aide à vérifier que votre balise Google Analytics est correctement installée et envoie des données. Il vous explique également comment diagnostiquer les problèmes courants si vous ne voyez pas les données attendues.
Méthodes de vérification immédiate
Ces outils vous aident à vérifier si votre balise se déclenche dès que vous la configurez :
DebugView de Google Analytics : activez DebugView pour voir les événements en temps réel lorsque vous interagissez avec votre site Web ou votre application. C'est le meilleur moyen de vérifier que les événements et les paramètres sont envoyés correctement. Consultez Surveiller les événements dans DebugView. Pour activer le mode de débogage pour votre session dans
gtag.js, transmettez'debug_mode': true:gtag('config', 'G-XXXXXX', { 'debug_mode': true });Google Tag Assistant Companion : cette extension de navigateur vous aide à valider l'implémentation de votre balise Google (gtag.js) sur les sites Web. Elle vous indique les balises qui se déclenchent et les données transmises. Consultez À propos de Tag Assistant.
Outils pour les développeurs dans un navigateur :
- Onglet "Réseau" : ouvrez les outils pour les développeurs de votre navigateur (par exemple, Chrome DevTools) et recherchez les requêtes réseau adressées à
google-analytics.com/g/collectouanalytics.google.com/g/collectlorsque vous naviguez sur votre site. Ces requêtes doivent se déclencher à chaque chargement de page et pour les événements. Un code d'état200 OKou204 No Contentindique que la transmission a réussi. - Onglet "Console" : recherchez les erreurs JavaScript liées à
gtag.jsou au code de votre site qui pourraient empêcher l'exécution de la balise.
- Onglet "Réseau" : ouvrez les outils pour les développeurs de votre navigateur (par exemple, Chrome DevTools) et recherchez les requêtes réseau adressées à
Vérifier les rapports Google Analytics
- Rapport "Temps réel" : les données doivent commencer à s'afficher dans le rapport "Temps réel" quelques minutes après le déclenchement correct de la balise. Vous devriez voir les pages vues, les événements et les utilisateurs actifs.
- Rapports standards : le traitement complet et la disponibilité de la plupart des données dans les rapports standards prennent 24 à 48 heures. Ne vous inquiétez pas si vous ne voyez pas immédiatement les données complètes en dehors des rapports "Temps réel" et DebugView.
Problèmes de configuration courants et comment les résoudre
- ID de mesure incorrect : assurez-vous que l'ID de mesure dans votre appel
gtag('config', 'G-XXXXXX')correspond exactement à l'ID des paramètres de votre flux de données Web Google Analytics. Les fautes de frappe dans l'ID de mesure sont l'une des erreurs de configuration les plus courantes et les plus faciles à commettre. Vérifiez donc attentivement cet ID. - Balise absente de toutes les pages : l'extrait de code d'une balise Google doit être présent dans la section
<head>de chaque page que vous souhaitez suivre. - Placement incorrect de la balise : le global site tag (gtag.js) doit être placé
le plus haut possible dans la section
<head>de votre code HTML. - Problèmes liés au mode Consentement : si vous avez implémenté le mode Consentement, assurez-vous que les balises ne sont pas bloquées de manière excessive. Les balises ne se déclenchent que lorsque l'utilisateur a donné le consentement requis. Utilisez Tag Assistant pour déboguer les états du consentement. Consultez Résoudre les problèmes liés au mode Consentement .
- Bloqueurs de publicité et extensions de confidentialité : certaines extensions de navigateur peuvent empêcher l'exécution des scripts Google Analytics. Effectuez un test dans une fenêtre de navigation privée ou dans un autre navigateur avec les extensions désactivées.
- Filtres Google Analytics : vérifiez si des filtres de données sont actifs dans les paramètres de votre propriété Google Analytics (Administration > Paramètres des données > Filtres de données) et s'ils n'excluent pas les données que vous recherchez.
- Mise en cache : la mise en cache côté navigateur ou côté serveur peut diffuser d'anciennes versions de la page sans la balise. Videz les caches après avoir ajouté la balise.
Ce à quoi vous attendre : données initiales
Une fois que les données commencent à être transmises, vous devriez voir les éléments suivants :
- Événements collectés automatiquement :
page_view,session_start,first_visitetuser_engagementsont collectés par défaut. - Dimensions de base : dans les rapports, vous commencerez à voir des données pour des dimensions telles que Chemin de la page, Source/Support, Catégorie d'appareil, Pays, etc.
Combien de temps faut-il pour que les données s'affichent ?
- DebugView : les événements s'affichent en quelques secondes.
- Rapports "Temps réel" : les données s'affichent en quelques minutes.
- Rapports standards : le traitement complet des données et la création des rapports prennent 24 à 48 heures.
Si vous avez suivi ces étapes et que vous ne voyez toujours pas de données, vérifiez l'implémentation de la balise et consultez le Centre d'aide Google Analytics.