Questa guida spiega come utilizzare la versione di debug della libreria analytics.js per verificare che le implementazioni funzionino correttamente.
La versione di debug della libreria analytics.js
Google Analytics fornisce una versione di debug della libreria analytics.js che registra messaggi dettagliati nella console JavaScript durante l'esecuzione. Questi messaggi includono comandi eseguiti correttamente, nonché avvisi e messaggi di errore che possono indicare quando il tag non è impostato correttamente. Fornisce inoltre un'analisi dettagliata di ogni hit inviato a Google Analytics, in modo da poter vedere esattamente quali dati vengono acquisiti.
Per attivare la versione di debug di analytics.js, modifica l'URL nel tag JavaScript da 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');
Test dell'implementazione senza inviare hit
La versione di debug di analytics.js invierà i dati a Google Analytics esattamente come la versione non di debug. In questo modo, puoi visitare un sito web che esegue il codice analytics.js e controllare l'implementazione senza interferire con il modo in cui i dati vengono acquisiti.
Se non vuoi inviare dati a Google Analytics in determinati casi (ad es. ambienti di sviluppo o di test), puoi disattivare l'attività sendHitTask e non verrà inviato nulla.
Quando viene eseguito su localhost, il seguente codice impedisce l'invio di hit 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');
Debug delle tracce
Se attivi il debug della traccia, verranno visualizzate informazioni più dettagliate nella console.
Per attivare il debug delle tracce, carica la versione di debug di analytics.js come descritto sopra e aggiungi la seguente riga di JavaScript prima di qualsiasi chiamata alla coda di comando ga().
window.ga_debug = {trace: true};
Il tag completo con il debug della traccia abilitato è il seguente:
(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');
Estensione di Chrome Google Analytics Debugger
Google Analytics fornisce inoltre un'estensione di Chrome che può attivare la versione di debug di analytics.js senza che tu debba modificare il tag. In questo modo puoi eseguire il debug dei tuoi siti e anche vedere in che modo altri siti hanno implementato Google Analytics con analytics.js.
Google Tag Assistant
Google Tag Assistant è un'estensione di Chrome che ti consente di convalidare il tag sul tuo sito web e risolvere i problemi più comuni. È uno strumento ideale per il debug e il test delle implementazioni analytics.js in locale e per verificare che sia tutto corretto prima di eseguire il deployment del codice in produzione.
Tag Assistant ti consente di registrare un flusso utente tipico. Raccoglie tutti gli hit che invii, li controlla per rilevare eventuali problemi e ti fornisce un report completo sulle interazioni. Riceverai una notifica nel caso in cui vengano rilevati problemi o potenziali miglioramenti.
Per saperne di più, visita il Centro assistenza e consulta gli articoli Informazioni su Tag Assistant e Informazioni sulle registrazioni di Tag Assistant. Puoi anche guardare questo video dimostrativo che mostra Tag Assistant come utilizzato per individuare gli errori e verificare la validità di implementazioni avanzate, come la misurazione interdominio.