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 está configurado incorrectamente el código de seguimiento. También proporciona un desglose de cada hit enviado a Google Analytics, para que puedas ver exactamente de qué datos se está realizando el seguimiento.

Puedes habilitar la versión de depuración de analytics.js cambiando la URL en el fragmento de código de seguimiento 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 de 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 los datos de los que se realiza el seguimiento.

Si no deseas enviar información a Google Analytics en casos determinados (p. ej., en entornos de desarrollo o prueba), puedes deshabilitar la tarea sendHitTask, y no se enviará ningún dato.

Cuando se ejecuta en localhost, este 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 seguimiento

Habilitar la depuración de seguimiento 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 agrega la siguiente línea de JavaScript al fragmento de seguimiento antes de las llamadas a la cola de comandos de ga().

window.ga_debug = {trace: true};

El fragmento de seguimiento completo con la depuración de seguimiento habilitada es el siguiente:

(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 el código de seguimiento. De este modo podrás depurar tus propios sitios web y comprobar también cómo otros sitios web han implementado el seguimiento de Google Analytics con analytics.js.

Asistente para etiquetas de Google

El Asistente para etiquetas de Google es una extensión de Chrome que te ayuda a validar el código de seguimiento de 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 tu código en la fase de producción.

El Asistente para etiquetas te permite registrar un flujo de usuario habitual. Realiza un seguimiento de todos los hits que envías, comprueba que no se haya producido ningún problema en ellos y te proporciona un completo informe 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 Acerca del Asistente para etiquetas y Acerca de Registros del Asistente de Etiquetas. También puedes ver esta demostración de vídeo donde se muestra cómo se usa el Asistente para etiquetas a la hora de detectar errores y comprobar la validez de las implementaciones de seguimiento avanzadas como, por ejemplo, el seguimiento multidominio.