Mit DebugView können Sie die von Ihrer App protokollierten Rohereignisdaten auf Entwicklungsgeräten nahezu in Echtzeit sehen. Dies ist für die Validierung während der Instrumentierungsphase der Entwicklung sehr nützlich und hilft Ihnen, Fehler in der Analytics-Implementierung zu finden und zu prüfen, ob alle Ereignisse und Nutzereigenschaften korrekt protokolliert wurden.
Fehlerbehebungsmodus aktivieren
In der Regel werden von Ihrer App protokollierte Ereignisse innerhalb von etwa einer Stunde zusammengefasst und gemeinsam hochgeladen. So wird der Akku der Geräte der Endnutzer geschont und die Nutzung von Netzwerkdaten reduziert. Wenn Sie Ihre Analytics-Implementierung jedoch validieren und Analytics im DebugView-Bericht sehen möchten, können Sie den Debug-Modus auf Ihrem Entwicklungsgerät aktivieren, um Ereignisse mit minimaler Verzögerung hochzuladen.
iOS+
Wenn Sie den Analytics-Fehlerbehebungsmodus auf Ihrem Entwicklungsgerät aktivieren möchten, geben Sie das folgende Befehlszeilenargument in Xcode an:
-FIRDebugEnabled
Dieses Verhalten bleibt bestehen, bis Sie den Fehlerbehebungsmodus 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
Wenn Sie den Analytics-Fehlerbehebungsmodus auf einem Android-Gerät aktivieren möchten, führen Sie die folgenden Befehle aus:
adb shell setprop debug.firebase.analytics.app PACKAGE_NAME
Dieses Verhalten bleibt bestehen, bis Sie den Fehlerbehebungsmodus explizit deaktivieren, indem Sie den folgenden Befehl ausführen:
adb shell setprop debug.firebase.analytics.app .none.
Web
Wenn Sie den Analytics-Fehlerbehebungsmodus in Ihrem Browser aktivieren möchten, müssen Sie die Chrome-Erweiterung Google Analytics Debugger installieren.
Aktivieren Sie die Erweiterung anschließend und aktualisieren Sie die Seite. Jetzt werden durch die Erweiterung Ereignisse in Ihrer App im Debug-Modus erfasst.
Sie können sich die in DebugView protokollierten Ereignisse in der Firebase-Konsole ansehen.
Berichte zu Ereignisdaten erstellen
Nachdem Sie den Debug-Modus auf Ihren Entwicklungsgeräten aktiviert haben, können Sie zu DebugView wechseln. Klicken Sie dazu oben in der Navigationsleiste von Google Analytics auf den Pfeil neben „StreamView“ und wählen Sie „DebugView“ aus.
Google Analytics und DebugView auswählen">
Verwenden Sie dann einfach Ihre App, um zu sehen, wie die Ereignisse der App im DebugView-Bericht protokolliert werden.
Im Sekundenstream (mittlere Spalte) sehen Sie die Ereignisse, die in den letzten 60 Sekunden protokolliert wurden. Der Minutenstream (linke Spalte) enthält die Ereignisse der letzten 30 Minuten. In der rechten Spalte sehen Sie die im Zeitraum von 30 Minuten erfassten wichtigsten Ereignisse und die aktuellen Nutzereigenschaften für das derzeit ausgewählte Entwicklungsgerät.
Sekundenstream
Standardmäßig sehen Sie eine Liste von Ereignissen, die in den letzten 60 Sekunden protokolliert wurden. Zu jedem Ereignis wird ein Zeitstempel angezeigt, der dem Protokollierungszeitpunkt auf dem Entwicklungsgerät entspricht. Wenn Sie auf ein Ereignis klicken, wird eine Liste der mit diesem Ereignis verknüpften Parameter angezeigt.
Da sich die Werte für Nutzereigenschaften während der App-Nutzung ändern, wird für jede Änderung ein Eintrag angezeigt.
Minutenstream
In diesem Stream sehen Sie mehrere Kreise, von denen jeder einer Minute der letzten 30 Minuten entspricht. Die Zahl im Kreis gibt die Anzahl der Ereignisse an, die in dieser Minute empfangen wurden. Wenn Sie auf einen dieser Kreise klicken, wird der Sekundenstream mit Ereignissen gefüllt, die während dieser Minute protokolliert wurden. So können Sie sämtliche Ereignisse, die in den letzten 30 Minuten erfasst wurden, detailliert untersuchen.
"Wichtigste Ereignisse" und "Aktuelle Nutzereigenschaften"
In der Tabelle „Häufigste Ereignisse“ sehen Sie die Ereignisse, die in einem Zeitraum von 30 Minuten am häufigsten protokolliert wurden. In der Tabelle „Aktuelle Nutzereigenschaften“ sehen Sie den aktuellen Status der Gruppe von Nutzereigenschaften für das derzeit ausgewählte Entwicklungsgerät.
Geräteauswahl
Der Debug-Modus kann auf vielen verschiedenen Entwicklungsgeräten aktiviert sein. Über die Geräteauswahl können Sie das Gerät festlegen, auf das sich der DebugView-Bericht beziehen soll. So können sich mehrere Entwickler auf ihre eigenen Instrumentierungs- und Validierungsaufgaben konzentrieren, ohne sich gegenseitig zu beeinträchtigen.
