Was ist DebugView?
Du hast ein neues Ereignis eingebaut. Woher weißt du, dass es wirklich ankommt? Genau das beantwortet DebugView.
Der Bericht steckt in Google Analytics 4 unter Verwaltung, Bereich Datenpräsentation. Er zeigt nicht alle Besucher, sondern nur Geräte, auf denen der Debug-Modus läuft. Das ist dein Laptop, dein Handy oder das Gerät eines Kollegen.
Der Aufbau ist schnell erklärt:
- Sekundenstream: die Ereignisse der letzten 60 Sekunden, das neueste oben. Ein Klick zeigt alle Parameter.
- Minutenstream: die letzten 30 Minuten, ein Kreis je Minute mit der Zahl der Ereignisse.
- Top-Ereignisse: die häufigsten Ereignisse derselben 30 Minuten.
- Nutzereigenschaften: was GA4 gerade über dieses Gerät weiß.
- Geräteauswahl: Testen mehrere Leute parallel, wählst du dein eigenes Gerät aus.
Bei Apps funktioniert das über Firebase nach demselben Prinzip. Dort hat es einen besonderen Vorteil: Normal bündelt eine App ihre Ereignisse über rund eine Stunde. Im Debug-Modus gehen sie fast ohne Verzögerung raus.
So schaltest du den Debug-Modus ein
DebugView bleibt leer, bis ein Gerät im Debug-Modus sendet. Dafür hast du drei Wege:
- Tag Assistant: der einfachste Weg. Du verbindest deine Seite, das Werkzeug hängt den Parameter _dbg an die Adresse, fertig.
- Google Tag Manager: Den Parameter debug_mode setzt du im Google-Tag auf true, dann gilt er für alle Ereignisse. Im einzelnen Ereignis-Tag gilt er nur für dieses Ereignis.
- gtag.js: debug_mode: true im config-Befehl für alle Ereignisse, im event-Befehl für einzelne.
In Apps schaltest du den Modus per Befehl ein, bei Android über adb, bei iOS über ein Startargument. Er bleibt dort aktiv, bis du ihn ausdrücklich wieder abschaltest.
DebugView oder ein anderes Werkzeug?
Vier Werkzeuge klingen ähnlich, beantworten aber vier verschiedene Fragen:
Werkzeug
Beantwortet
GTM-Vorschau
Welches Tag hat ausgelöst und warum?
DebugView
Was kam von meinem Gerät in GA4 an?
Echtzeit
Was machen gerade alle Besucher?
Standardberichte
Was sagen die fertig verarbeiteten Daten?
Die GTM-Vorschau schaut also auf die Sendeseite, DebugView auf die Empfangsseite. Der Echtzeit-Bericht braucht keinen Debug-Modus, zeigt aber nur zusammengefasste Daten der letzten 30 Minuten. Für Tests sind Standardberichte zu langsam: Tägliche Daten brauchen bei einer normalen Property typischerweise 12 Stunden, die volle Verarbeitung ein bis zwei Tage.
Für die Frage, woher ein Besucher kam, taugt DebugView nicht. Google weist selbst darauf hin, dass die Attribution dort nur eingeschränkt funktioniert. Das prüfst du in den Akquisitionsberichten.
Häufige Fehler
Fehler 1 · Die Vorschau für den Beweis halten
Das Tag hat in der GTM-Vorschau ausgelöst, also passt alles? Nein. Die Vorschau zeigt, dass es losging, nicht dass es ankam. Prüf immer beide Seiten.
Fehler 2 · Ohne Einwilligung testen
Bericht leer, Panik groß. Oft liegt es am Cookie-Banner: Ohne Einwilligung für Analytics-Cookies erscheinen im Consent Mode keine Ereignisse in DebugView. Auch Werbeblocker können die Verbindung stören. Stimm also erst zu und schalte den Blocker für den Test ab.
Fehler 3 · Testdaten in die Berichte laufen lassen
Debug-Ereignisse landen ohne Filter in deinen normalen Berichten. Abhilfe schafft der Datenfilter „Entwickler-Traffic“: DebugView funktioniert weiter, die Berichte bleiben sauber. Der Filter braucht 24 bis 36 Stunden, bis er greift, und seine Wirkung ist endgültig. Ausgefilterte Daten holst du nie zurück.
Fehler 4 · Nur prüfen, ob das Ereignis auftaucht
Ein Ereignis mit falschen Parametern ist fast schlimmer als gar keines, weil niemand es bemerkt. Klick im Sekundenstream auf das Ereignis und lies die Parameter. Steht beim Testkauf wirklich der richtige Betrag drin?
So testest du ein neues Ereignis
Mit dieser Reihenfolge bist du in zehn Minuten durch:
- Vorschau starten: GTM-Vorschau öffnen und die Seite verbinden.
- Einwilligen: das Banner bestätigen, so wie ein echter Besucher.
- Aktion ausführen: Formular absenden, Testkauf machen, Knopf klicken.
- Sendeseite prüfen: Hat das Tag ausgelöst?
- Empfangsseite prüfen: In DebugView dein Gerät wählen, das Ereignis suchen, die Parameter lesen.
- Veröffentlichen: erst jetzt die Container-Version live stellen.
Häufige Fragen
Warum zeigt DebugView keine Ereignisse?
Meist läuft der Debug-Modus nicht, die Einwilligung fehlt oder ein Werbeblocker stört. Prüf außerdem, ob du in der richtigen Property bist und oben dein Gerät ausgewählt hast. Tag Assistant ist der schnellste Gegentest.
Was ist der Unterschied zwischen DebugView und dem Echtzeit-Bericht?
DebugView zeigt einzelne Ereignisse eines Testgeräts mit allen Parametern. Der Echtzeit-Bericht zeigt alle Besucher der letzten 30 Minuten zusammengefasst und braucht keinen Debug-Modus.
Fließen Debug-Daten in meine Berichte ein?
Ja, solange du sie nicht ausfilterst. Dafür ist der Datenfilter „Entwickler-Traffic“ da. Bei Firebase gehen Debug-Ereignisse standardmäßig auch in den täglichen BigQuery-Export.
Wie schalte ich den Debug-Modus wieder ab?
Entferne den Parameter debug_mode aus deinem Tag. Ihn auf false zu setzen reicht laut Google nicht. Hast du nur Tag Assistant benutzt, beende einfach die Sitzung.
Kann ich mit DebugView prüfen, was alle Besucher auslösen?
Nein, und das soll es auch nicht. DebugView ist für einzelne Testgeräte gedacht. Für den Gesamtblick nimmst du den Echtzeit-Bericht und später die Standardberichte.
