En esta guía, se explica cómo utilizar la versión de depuración de la biblioteca analytics.js para garantizar que tus implementaciones funcionen correctamente.
La versión de depuración de la biblioteca analytics.js
Google Analytics proporciona una versión de depuración de la biblioteca analytics.js que registra mensajes detallados en la consola de JavaScript mientras se ejecuta. Estos mensajes incluyen comandos ejecutados correctamente, así como advertencias y mensajes de error que pueden indicarte cuándo tu etiqueta está mal configurada. También proporciona un desglose de cada hit que se envió a Google Analytics, de modo que puedas ver exactamente qué datos se están captando.
Para habilitar la versión de depuración de analytics.js, cambia la URL en la etiqueta de JavaScript de https://www.google-analytics.com/analytics.js a 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');
Prueba tu implementación sin enviar hits
La versión de depuración de analytics.js enviará datos a Google Analytics exactamente como la versión de no depuración. Esto te permite visitar un sitio web que ejecute el código analytics.js y, luego, inspeccionar la implementación sin interferir en la forma en que se recopilan los datos.
Si no deseas enviar datos a Google Analytics en ciertos casos (p.ej., entornos de desarrollo o pruebas), puedes inhabilitar la tarea sendHitTask y no se enviará nada.
Si se ejecuta en localhost, el siguiente código evitará que se envíen hits a 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');
Depuración de Trace
Si habilitas la depuración de seguimiento, se mostrará información más detallada en la consola.
Para habilitar la depuración de seguimiento, carga la versión de depuración de analytics.js como se describió anteriormente y agrega la siguiente línea de JavaScript antes de cualquier llamada a la cola de comandos de ga().
window.ga_debug = {trace: true};
Esta es la etiqueta completa con la depuración de seguimiento habilitada:
(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');
La extensión de Chrome Google Analytics Debugger
Google Analytics también proporciona una extensión de Chrome que puede habilitar la versión de depuración de analytics.js sin necesidad de cambiar tu etiqueta. Esto te permite depurar tus propios sitios y también ver cómo otros sitios implementaron Google Analytics con analytics.js.
Google Tag Assistant
Google Tag Assistant es una extensión de Chrome que te ayuda a validar la etiqueta en tu sitio web y solucionar problemas comunes. Es una herramienta ideal para depurar y probar tus implementaciones de analytics.js de forma local y asegurarte de que todo sea correcto antes de implementar el código en producción.
Tag Assistant te permite grabar un flujo de usuarios típico. Recopila todos los hits que envías, comprueba si hay problemas y te brinda un informe completo de las interacciones. Te informará si detecta algún problema o posible mejora.
Para obtener más información, visita el Centro de ayuda y consulta Acerca de Tag Assistant y Acerca de las grabaciones de Tag Assistant. También puedes mirar este video de demostración que muestra cómo se usa Tag Assistant para detectar errores y verificar la validez de las implementaciones avanzadas, como las mediciones multidominio.