In diesem Leitfaden wird erläutert, wie Sie die Debug-Version der analytics.js-Bibliothek verwenden, um sicherzustellen, dass Ihre Implementierungen ordnungsgemäß funktionieren.
Die Debug-Version der analytics.js-Bibliothek
Google Analytics bietet eine Debug-Version der analytics.js-Bibliothek, mit der detaillierte Meldungen während der Ausführung in der JavaScript-Konsole protokolliert werden. Zu diesen Meldungen gehören erfolgreich ausgeführte Befehle sowie Warnungen und Fehlermeldungen, die Sie über falsche Tag-Einrichtung informieren. Sie erhalten außerdem eine Aufschlüsselung der an Google Analytics gesendeten Treffer, sodass Sie genau sehen können, welche Daten erfasst werden.
Sie können die Debug-Version von analytics.js aktivieren, indem Sie die URL im JavaScript-Tag von https://www.google-analytics.com/analytics.js in https://www.google-analytics.com/analytics_debug.js ändern:
(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');
Implementierung ohne Senden von Treffern testen
Bei der Debug-Version von analytics.js werden Daten genau wie bei der anderen Version an Google Analytics gesendet. So können Sie eine Website aufrufen, auf der analytics.js-Code ausgeführt wird, und die Implementierung prüfen, ohne die Datenerfassung zu beeinträchtigen.
Wenn Sie in bestimmten Fällen (z. B. in Entwicklungs- oder Testumgebungen) keine Daten an Google Analytics senden möchten, können Sie die Aufgabe sendHitTask deaktivieren. Es wird dann nichts gesendet.
Bei Ausführung auf localhost verhindert der folgende Code, dass Treffer an Google Analytics gesendet werden:
(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');
Trace-Fehlerbehebung
Wenn Sie das Trace-Debugging aktivieren, werden ausführlichere Informationen an die Konsole ausgegeben.
Um das Trace-Debugging zu aktivieren, laden Sie die Debug-Version von analytics.js wie oben beschrieben und fügen Sie die folgende JavaScript-Zeile hinzu, bevor Sie die ga()-Befehlswarteschlange aufrufen.
window.ga_debug = {trace: true};
Das vollständige Tag mit aktiviertem Trace-Debugging sieht so aus:
(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');
Chrome-Erweiterung „Google Analytics Debugger“
Google Analytics bietet auch eine Chrome-Erweiterung, mit der die Debug-Version von analytics.js aktiviert werden kann, ohne dass Sie Ihr Tag ändern müssen. So können Sie Fehler auf Ihren eigenen Websites beheben und sehen, wie Google Analytics mit analytics.js auf anderen Websites implementiert wurde.
Google Tag Assistant
Der Google Tag Assistant ist eine Chrome-Erweiterung, mit der Sie das Tag auf Ihrer Website validieren sowie häufige Probleme beheben können. Es ist ein ideales Tool, um Ihre analytics.js-Implementierungen lokal zu debuggen und zu testen und sicherzustellen, dass alles korrekt ist, bevor Sie den Code in der Produktion bereitstellen.
Mit dem Tag Assistant können Sie einen typischen Nutzerfluss aufzeichnen. Sie erfasst alle von Ihnen gesendeten Treffer, prüft sie auf Probleme und erstellt einen vollständigen Bericht zu den Interaktionen. Wenn dabei Probleme oder potenzielle Verbesserungen erkannt werden, werden Sie darüber informiert.
Weitere Informationen finden Sie in der Hilfe und auf den Seiten Tag Assistant und Tag Assistant Recordings. Sie können sich auch dieses Demovideo ansehen, in dem gezeigt wird, wie der Tag Assistant Fehler erkennt und die Gültigkeit erweiterter Implementierungen wie der domainübergreifenden Messung überprüft.