Debug-Ereignisse

Mit DebugView können Sie die von Ihrer App protokollierten Rohereignisdaten nahezu in Echtzeit auf Entwicklungsgeräten anzeigen. Dies ist für Validierungszwecke während der Instrumentierungsphase der Entwicklung sehr nützlich und kann Ihnen dabei helfen, Fehler und Irrtümer in Ihrer Analytics-Implementierung zu entdecken und zu bestätigen, dass alle Ereignisse und Benutzereigenschaften korrekt protokolliert werden.

Aktivieren Sie den Debug-Modus

Im Allgemeinen werden von Ihrer App protokollierte Ereignisse über einen Zeitraum von etwa einer Stunde gebündelt und gemeinsam hochgeladen. Dieser Ansatz schont den Akku der Endbenutzergeräte und reduziert die Netzwerkdatennutzung. Zum Zwecke der Validierung Ihrer Analytics-Implementierung (und um Ihre Analytics im DebugView-Bericht anzuzeigen) können Sie jedoch den Debug-Modus auf Ihrem Entwicklungsgerät aktivieren, um Ereignisse mit minimaler Verzögerung hochzuladen.

iOS+

Um den Analytics-Debugmodus auf Ihrem Entwicklungsgerät zu aktivieren, geben Sie das folgende Befehlszeilenargument in Xcode an:

-FIRDebugEnabled

Dieses Verhalten bleibt bestehen, bis Sie den Debugmodus explizit deaktivieren, indem Sie das folgende Befehlszeilenargument angeben:

-FIRDebugDisabled

Sie können diese Argumente hinzufügen, indem Sie das Schema Ihres Projekts bearbeiten und einen neuen Eintrag zu „Beim Start übergebene Argumente“ hinzufügen.

Android

Um den Analytics-Debug-Modus auf einem Android-Gerät zu aktivieren, führen Sie die folgenden Befehle aus:

adb shell setprop debug.firebase.analytics.app PACKAGE_NAME

Dieses Verhalten bleibt bestehen, bis Sie den Debugmodus explizit deaktivieren, indem Sie den folgenden Befehl ausführen:

adb shell setprop debug.firebase.analytics.app .none.

Netz

Um den Analytics-Debug-Modus in Ihrem Browser zu aktivieren, installieren Sie die Google Analytics Debugger Chrome-Erweiterung.

Aktivieren Sie nach der Installation die Erweiterung und aktualisieren Sie die Seite. Von diesem Zeitpunkt an protokolliert die Erweiterung Ereignisse in Ihrer App im Debug-Modus.

Sie können im DebugView in der Firebase-Konsole protokollierte Ereignisse anzeigen.

Bericht über Ereignisdaten

Sobald Sie den Debug-Modus auf Ihren Entwicklungsgeräten aktiviert haben, navigieren Sie zu DebugView , indem Sie im oberen Navigationsbereich von Google Analytics den Pfeil neben StreamView auswählen und DebugView auswählen.

Navigieren Sie zu DebugView, indem Sie im oberen Navigationsbereich von Google Analytics den Pfeil neben StreamView auswählen und DebugView auswählen

Beginnen Sie dann einfach mit der Verwendung Ihrer App, um zu sehen, wie die Ereignisse Ihrer App im DebugView-Bericht protokolliert werden.

Der DebugView-Bericht.

Der Sekunden-Stream (die mittlere Spalte) zeigt die Ereignisse, die in den letzten 60 Sekunden protokolliert wurden. Der Protokollstream (linke Spalte) zeigt eine Reihe von Archiven der Ereignisse der letzten 30 Minuten. Und in der rechten Spalte werden die im 30-Minuten-Zeitraum protokollierten Top-Ereignisse sowie die aktuellen Benutzereigenschaften für das aktuell ausgewählte Entwicklungsgerät angezeigt.

Sekundenstrom

Standardmäßig wird eine Liste der in den letzten 60 Sekunden protokollierten Ereignisse angezeigt. Für jedes Ereignis wird ein Zeitstempel angezeigt, der dem Zeitpunkt seiner Protokollierung auf dem Entwicklungsgerät entspricht. Sie können auf ein Ereignis klicken, um eine Liste der Parameter anzuzeigen, die diesem Ereignis zugeordnet waren.

Eine Beispielliste von Ereignisparametern.

Wenn sich die Benutzereigenschaftswerte im Laufe der App-Nutzung ändern, wird ein Eintrag für diese Änderung angezeigt.

Eine beispielhafte Benutzereigenschaft.

Minutenstrom

Dieser Stream zeigt eine Reihe von Kreisen, die jeweils einer Minute der letzten 30 Minuten entsprechen. Die Zahl im Kreis gibt die Anzahl der in dieser Minute empfangenen Ereignisse an. Wenn Sie auf einen dieser Kreise klicken, wird der Sekunden-Stream mit Ereignissen gefüllt, die während dieser Minute protokolliert wurden. Auf diese Weise können Sie die in den letzten 30 Minuten protokollierten Ereignisse effektiv und detailliert untersuchen.

Ein Beispiel für den Minutenstream.

Top-Events und aktuelle Benutzereigenschaften

Die Tabelle „Top-Ereignisse“ zeigt die Top-Ereignisse, die während des 30-Minuten-Zeitraums protokolliert wurden. Und die Tabelle „Aktuelle Benutzereigenschaften“ zeigt den neuesten Status des Satzes von Benutzereigenschaften für das aktuell ausgewählte Entwicklungsgerät.

Ein Beispiel für die Top-Events-Tabelle.

Geräteauswahl

Da für viele verschiedene Entwicklungsgeräte der Debugmodus aktiviert sein kann, können Sie mit der Geräteauswahl das spezifische Gerät auswählen, auf das sich der DebugView-Bericht konzentrieren soll. Dadurch können sich mehrere Entwickler auf ihre eigenen Instrumentierungs- und Validierungsbemühungen konzentrieren, ohne sich gegenseitig zu beeinträchtigen.

Ein Beispiel für die Geräteauswahl.