Debugging

In diesem Leitfaden wird erläutert, wie Sie die Debug-Version der analytics.js-Bibliothek verwenden, um sicherzustellen, dass Ihre Implementierungen ordnungsgemäß funktionieren.

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. Dazu gehören erfolgreich ausgeführte Befehle sowie Warnungen und Fehlermeldungen, die Aufschluss darüber geben, ob das Tag falsch eingerichtet ist. Außerdem werden die an Google Analytics gesendeten Treffer aufgeschlüsselt, 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 genauso an Google Analytics gesendet wie die Version ohne Fehlerbehebung. 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 sendHitTask-Aufgabe deaktivieren. Es wird dann nichts gesendet.

Bei der 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-Debugging

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 außerdem eine Chrome-Erweiterung, mit der Sie die Debug-Version von analytics.js aktivieren können, ohne dass Sie das 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 Tags auf Ihrer Website validieren und häufige Probleme beheben können. Damit können Sie Fehler in Ihren analytics.js-Implementierungen lokal beheben und testen, ob alles korrekt ist, bevor Sie den Code für die Produktion bereitstellen.

Mit dem Tag Assistant können Sie einen typischen Nutzerfluss aufzeichnen. Es erfasst alle von Ihnen gesendeten Treffer, prüft sie auf Probleme und erstellt einen vollständigen Bericht über die Interaktionen. Wenn es Probleme oder potenzielle Verbesserungen erkennt, werden Sie darüber informiert.

Weitere Informationen finden Sie in der Google Tag Assistant-Hilfe sowie in den Hilfeartikeln Tag Assistant und Tag Assistant Recordings. Sie können sich auch dieses Demovideo ansehen. Darin wird gezeigt, wie Sie mit dem Tag Assistant Fehler finden und die Gültigkeit erweiterter Implementierungen wie der domainübergreifenden Messung prüfen.