Depuración

En esta guía se explica cómo debes usar la versión de depuración de la biblioteca analytics.js para asegurarte de que las implementaciones funcionan correctamente.

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 JavaScript a medida que se ejecuta. En estos mensajes se incluyen los comandos que se han ejecutado correctamente, así como advertencias y mensajes de error que indican cuándo la etiqueta está configurada correctamente. También proporciona un desglose de cada hit enviado a Google Analytics para que puedas ver exactamente qué datos se están registrando.

Para habilitar la versión de depuración de analytics.js, puedes cambiar la URL de 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');

Probar la implementación sin enviar hits

La versión de depuración de analytics.js enviará datos a Google Analytics exactamente igual a como lo haría la versión que no es de depuración. De esta forma, puedes acceder a un sitio web que ejecuta el código analytics.js e inspeccionar la implementación sin interferir con el modo en que se registran los datos.

Si no quieres enviar información a Google Analytics en determinados casos (por ejemplo, en entornos de desarrollo o de pruebas), puedes inhabilitar la tarea sendHitTask y no se enviará ningún dato.

Si este código se ejecuta en localhost, impide 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 seguimiento

Si se habilita la depuración de seguimiento, se enviará información más detallada a la consola.

Para habilitar la depuración de seguimiento, carga la versión de depuración de analytics.js tal como se describe en este artículo y añade la siguiente línea de JavaScript antes de las llamadas a la cola de comandos de ga().

window.ga_debug = {trace: true};

La etiqueta completa con la depuración de seguimiento habilitada tendrá el siguiente formato:

(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');

Extensión del depurador de Google Analytics para Chrome

Google Analytics también proporciona una extensión de Chrome que puede habilitar la versión de depuración de analytics.js sin que tengas que cambiar la etiqueta. De este modo, podrás depurar tus propios sitios y comprobar también cómo otros han implementado 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 a solucionar problemas habituales. Es una herramienta ideal para hacer pruebas con tus implementaciones de analytics.js y depurarlas de forma local y comprobar que todo sea correcto antes de implementar el código en la fase de producción.

Tag Assistant te permite registrar flujos de usuario comunes. Recoge todos los hits que envías, comprueba que no tengan ningún problema y te proporciona un informe completo de las interacciones. Si detecta algún problema o posibilidades de mejora, te lo indicará.

Para obtener más información al respecto, visita el Centro de Ayuda y lee los artículos sobre Tag Assistant y Tag Assistant Recordings. También puedes ver este vídeo donde se muestra cómo se usa Tag Assistant para detectar errores y comprobar la validez de implementaciones avanzadas, como la medición multidominio.