GA4 DebugView: Ereignisse und Parameter richtig prüfen

Was ist GA4 DebugView?

GA4 DebugView ist eine Ansicht in Google Analytics 4 (GA4), die dir nahezu in Echtzeit jedes einzelne Ereignis eines Testgeräts mit allen Parametern zeigt. Du findest sie in der Verwaltung von GA4 unter dem Punkt DebugView. DebugView zeigt nur Ereignisse, die als Debug-Ereignisse markiert sind, zum Beispiel weil du die Vorschau im Google Tag Manager gestartet hast. Damit prüfst du, ob ein Ereignis wie generate_lead oder purchase wirklich ankommt, ob die Parameter stimmen und ob Werte richtig übergeben werden, bevor du dich auf die Berichte verlässt.

DebugView spart Zeit, weil die Standardberichte in GA4 mit Verzögerung verarbeitet werden. Wer nach einer Änderung einen Tag warten muss, um zu sehen, ob ein Ereignis funktioniert, verliert Zeit und im schlimmsten Fall Daten. Mit DebugView siehst du das Ergebnis nach wenigen Sekunden. Damit deine Testklicks nicht in den Berichten landen, kannst du in GA4 zusätzlich den Datenfilter für Entwickler-Traffic aktivieren.

Wie aktiviere ich den GA4 Debug Mode?

Der bequemste Weg führt über den Google Tag Manager. Klickst du dort auf Vorschau und verbindest Tag Assistant mit deiner Website, markiert der Google Tag Manager alle Ereignisse aus diesem Browser-Fenster automatisch als Debug-Ereignisse. Du musst nichts weiter einstellen. In DebugView taucht dein Gerät dann nach kurzer Zeit auf. Ist GA4 ohne Tag Manager direkt mit dem Google-Tag (gtag.js) eingebaut, öffnest du die Seite stattdessen über Tag Assistant unter tagassistant.google.com. Auch dann gilt die Markierung nur für deinen Browser.

Der dritte Weg ist der Parameter debug_mode mit dem Wert true. Du setzt ihn in der Konfiguration des Google-Tags oder direkt an einzelnen Ereignis-Tags, je nachdem, ob alle oder nur bestimmte Ereignisse markiert werden sollen. Das eignet sich für Testumgebungen. Auf einer Live-Seite solltest du das nur kurz und gezielt tun, denn der Parameter gilt für alle Besucher, nicht nur für dich.

• Google Tag Manager: Vorschau starten, Website verbinden, fertig.
• Tag Assistant: für Seiten mit direkt eingebautem Google-Tag, nur für den eigenen Browser.
• Parameter debug_mode auf true: gilt für alle Besucher, nur in Testumgebungen dauerhaft.

Passend dazu: Meta Pixel (Facebook Pixel) im Google Tag Manager einrichten

Ereignisse, Parameter und Nutzereigenschaften prüfen

DebugView ist in drei Bereiche geteilt. Links läuft eine Zeitleiste der letzten 30 Minuten mit der Zahl der Ereignisse je Minute, in der Mitte stehen die Ereignisse der letzten 60 Sekunden in zeitlicher Reihenfolge, rechts siehst du die häufigsten Ereignisse der letzten 30 Minuten und die aktuellen Nutzereigenschaften des Geräts. Oben links kannst du über die Geräteauswahl zwischen mehreren Debug-Geräten wechseln, falls gleichzeitig mehrere Personen testen.

Klickst du auf ein Ereignis, öffnet sich eine Liste aller Parameter. Bei einem Formular-Ereignis prüfst du zum Beispiel, ob form_id oder ein eigener Parameter wie formular_name den richtigen Wert hat. Bei einem Kauf schaust du dir value, currency, transaction_id und die Artikelliste an. Nutzereigenschaften, also Merkmale des Besuchers wie eine Kundengruppe, die du selbst an GA4 übergibst, stehen rechts und sollten nach dem passenden Ereignis den erwarteten Wert zeigen.

Achte auch auf die Reihenfolge. Ein page_view sollte vor den Ereignissen auf der Seite stehen, ein generate_lead erst nach dem Absenden des Formulars und nicht schon beim Öffnen. Stehen Ereignisse doppelt untereinander, löst vermutlich ein Tag zweimal aus. Das siehst du hier deutlich früher als in jedem Bericht.

Typische Fehler und woran du sie erkennst

Ein häufiger Fehler: Es erscheint gar kein Gerät. Prüfe zuerst, ob du im Cookie-Banner zugestimmt hast. Ohne Einwilligung schickt die Seite je nach Einstellung gar keine oder nur eingeschränkte Anfragen, und dein Test sagt dann nichts über die Messung bei zustimmenden Besuchern aus. Prüfe danach, ob ein Werbeblocker aktiv ist, ob du in der richtigen Property bist und ob die Vorschau mit der Live-Adresse verbunden ist und nicht mit einer alten Testseite.

Ein zweiter Fehler betrifft den Parameter debug_mode. Wer ihn auf der Live-Seite setzt und vergisst, markiert alle echten Besucher als Debug-Geräte. Ist dann der Datenfilter für Entwickler-Traffic aktiv, der Debug-Ereignisse dauerhaft aus den Daten ausschließt, verschwinden plötzlich echte Zugriffe aus GA4. Wichtig zu wissen: Den Parameter auf false zu setzen, schaltet den Debug-Modus laut Google nicht ab. Du musst ihn vollständig entfernen.

Ein dritter Fehler sind Parameter mit dem Wert undefined oder leere Werte. Das passiert, wenn eine Variable im Google Tag Manager zum Zeitpunkt des Ereignisses noch nicht befüllt ist, zum Beispiel weil der Datenschicht-Eintrag des Shops erst nach dem Tag kommt. In DebugView siehst du den Parameter dann mit leerem Inhalt. Die Lösung liegt im Trigger, nicht in GA4.

• Kein Gerät sichtbar: Einwilligung, Werbeblocker, Property, Vorschau-Verbindung prüfen.
• Ereignis doppelt: zwei Tags oder zwei Trigger lösen gleichzeitig aus.
• Parameter leer oder undefined: Variable ist beim Auslösen noch nicht befüllt.
• Echte Besucher als Debug-Gerät: debug_mode auf der Live-Seite vergessen.
• Kauf ohne Wert: value oder currency fehlen, der Umsatz bleibt in GA4 bei null.

Passend dazu: Borlabs Cookie mit Consent Mode v2 und Tag Manager verbinden

Was unterscheidet DebugView vom Echtzeitbericht?

Der Echtzeitbericht und DebugView sehen auf den ersten Blick ähnlich aus, beantworten aber unterschiedliche Fragen. Der Echtzeitbericht zeigt dir, wie viele Besucher in den letzten 30 Minuten auf der Seite waren, woher sie kamen und welche Ereignisse insgesamt ausgelöst wurden. Er sagt dir, ob überhaupt Daten ankommen. DebugView zeigt dir dagegen nur markierte Testgeräte, dafür jedes Ereignis einzeln und mit allen Parametern. Es sagt dir, ob die Daten richtig ankommen.

Für die Prüfung einer neuen Messung brauchst du beides. Mit DebugView testest du deine eigenen Klicks im Detail. Mit dem Echtzeitbericht prüfst du nach dem Veröffentlichen, ob auch echte Besucher die neuen Ereignisse auslösen. Erst wenn beides passt, lohnt sich der Blick in die Standardberichte am nächsten Tag.

Beispiel: Testkauf im Onlineshop

Ein kleiner Onlineshop für Kaffeezubehör hat in GA4 zwar Käufe, aber keinen Umsatz. Der Shop-Betreiber startet die Vorschau im Google Tag Manager, stimmt im Banner zu und kauft mit einem Gutscheincode einen günstigen Artikel. In DebugView erscheint das Ereignis purchase, und beim Aufklappen zeigt sich: transaction_id ist da, die Artikelliste auch, aber value ist leer. Die Variable im Tag Manager liest den Wert aus einem Feld der Datenschicht, das im Shop-Plugin nach einem Update anders heißt.

Nach dem Anpassen der Variable zeigt der nächste Testkauf in DebugView den richtigen Betrag mit Währung. Der ganze Test hat zehn Minuten gedauert. Ohne DebugView hätte der Betreiber nach jeder Änderung einen Tag auf die Berichte warten müssen und wäre vermutlich erst nach mehreren Versuchen auf die Ursache gekommen.

Testen lassen statt selbst suchen

DebugView ist eines der wichtigsten Werkzeuge, um GA4 sauber zu halten. Es setzt aber voraus, dass du weißt, welche Ereignisse und Parameter da sein sollten. Wenn du das lieber abgeben möchtest: Trackum richtet Google Tag Manager, GA4 und Consent Mode v2 für 150 € zzgl. MwSt. ein, mit bis zu 15 Ereignissen, und testet jedes Ereignis in der Vorschau, mit und ohne Einwilligung, bevor etwas live geht. Wenn du schon ein Setup hast und nur wissen willst, ob es funktioniert, schreib uns über die Anfrage.