Depuración

En esta guía se explica cómo utilizar la versión de depuración de la biblioteca analytics.js para garantizar que las implementaciones funcionen 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 puedan indicar 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 pruebas), puedes inhabilitar la tarea sendHitTask y no se enviará ningún dato.

Si se ejecuta en localhost, este código 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 ha descrito anteriormente 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 sea necesario cambiar la etiqueta. De este modo podrás depurar tus propios sitios web y comprobar también cómo otros sitios web 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 depurar y probar tus implementaciones de analytics.js 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 se haya producido ningún problema en ellos 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 de demostración donde se muestra cómo se usa Tag Assistant para detectar errores y comprobar la validez de implementaciones avanzadas como la medición multidominio.