Ce guide vous explique comment utiliser la version de débogage de la bibliothèque analytics.js pour vous assurer que vos implémentations fonctionnent correctement.
Version de débogage de la bibliothèque analytics.js
Google Analytics fournit une version de débogage de la bibliothèque analytics.js, qui enregistre des messages détaillés dans la console JavaScript pendant son exécution. Ces messages incluent des commandes qui ont été correctement exécutées, ainsi que des avertissements et des messages d'erreur qui peuvent vous indiquer si votre balise n'est pas correctement configurée. Il fournit également une répartition de chaque appel envoyé à Google Analytics, ce qui vous permet de voir exactement quelles données sont capturées.
Vous pouvez activer la version de débogage d'analytics.js en remplaçant l'URL https://www.google-analytics.com/analytics.js de la balise JavaScript par https://www.google-analytics.com/analytics_debug.js:
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics_debug.js','ga');
ga('create', 'UA-XXXXX-Y', 'auto');
ga('send', 'pageview');
Tester votre implémentation sans envoyer d'appels
La version de débogage d'analytics.js envoie les données à Google Analytics exactement comme la version non-débogée. Vous pouvez ainsi accéder à un site Web exécutant le code analytics.js et inspecter sa mise en œuvre sans interférer avec la façon dont les données sont collectées.
Si vous ne souhaitez pas envoyer de données à Google Analytics dans certains cas (environnements de développement ou de test, par exemple), vous pouvez désactiver la tâche sendHitTask. Aucun élément ne sera alors envoyé.
En cas d'exécution sur localhost, le code suivant empêche l'envoi d'appels à Google Analytics:
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics_debug.js','ga');
ga('create', 'UA-XXXXX-Y', 'auto');
if (location.hostname == 'localhost') {
ga('set', 'sendHitTask', null);
}
ga('send', 'pageview');
Débogage des traces
L'activation du débogage de trace génère des informations plus détaillées dans la console.
Pour activer le débogage des traces, chargez la version de débogage d'analytics.js comme décrit ci-dessus et ajoutez la ligne JavaScript suivante avant tout appel à la file d'attente de commande ga().
window.ga_debug = {trace: true};
Le tag complet avec débogage des traces activé se présente comme suit:
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics_debug.js','ga');
window.ga_debug = {trace: true};
ga('create', 'UA-XXXXX-Y', 'auto');
ga('send', 'pageview');
Extension Google Analytics Debugger pour Chrome
Google Analytics fournit également une extension Chrome qui permet d'activer la version de débogage d'analytics.js sans que vous ayez à modifier votre balise. Vous pouvez ainsi déboguer vos propres sites et voir comment d'autres sites ont implémenté Google Analytics avec analytics.js.
Google Tag Assistant
Google Tag Assistant est une extension Chrome qui vous permet de valider la balise sur votre site Web et de résoudre les problèmes courants. Cet outil est idéal pour déboguer et tester vos implémentations d'analytics.js localement, et pour s'assurer que tout est correct avant de déployer votre code en production.
Tag Assistant vous permet d'enregistrer un flux utilisateur standard. L'outil collecte tous les appels que vous envoyez, les vérifie pour détecter d'éventuels problèmes et vous fournit un rapport complet sur les interactions. Si elle détecte des problèmes ou des améliorations potentielles, elle vous en informe.
Pour en savoir plus, consultez le centre d'aide et lisez les articles À propos de Tag Assistant et À propos de Tag Assistant Recordings. Vous pouvez également regarder cette vidéo de démonstration qui montre comment utiliser Tag Assistant pour détecter des erreurs et vérifier la validité des implémentations avancées telles que les mesures multidomaines.