Firebase is back at Google I/O on May 10! Register now

Ereignisse protokollieren

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Ereignisse geben Aufschluss darüber, was in Ihrer App passiert, z. B. Benutzeraktionen, Systemereignisse oder Fehler.

Google Analytics protokolliert automatisch einige Ereignisse für Sie; Sie müssen keinen Code hinzufügen, um sie zu erhalten. Wenn Ihre App zusätzliche Daten erfassen muss, können Sie bis zu 500 verschiedene Analytics-Ereignistypen in Ihrer App protokollieren. Es gibt keine Begrenzung für das Gesamtvolumen der Ereignisse, die Ihre App protokolliert. Beachten Sie, dass bei Ereignisnamen zwischen Groß- und Kleinschreibung unterschieden wird und dass das Protokollieren von zwei Ereignissen, deren Namen sich nur in Groß- und Kleinschreibung unterscheiden, zu zwei unterschiedlichen Ereignissen führt.

Bevor Sie beginnen

Bevor Sie Google Analytics verwenden können, müssen Sie:

  • Registrieren Sie Ihr Unity-Projekt und konfigurieren Sie es für die Verwendung von Firebase.

    • Wenn Ihr Unity-Projekt Firebase bereits verwendet, ist es bereits für Firebase registriert und konfiguriert.

    • Wenn Sie kein Unity-Projekt haben, können Sie eine Beispiel-App herunterladen.

  • Fügen Sie das Firebase Unity SDK (insbesondere FirebaseAnalytics.unitypackage ) zu Ihrem Unity-Projekt hinzu.

Beachten Sie, dass das Hinzufügen von Firebase zu Ihrem Unity-Projekt Aufgaben sowohl in der Firebase-Konsole als auch in Ihrem geöffneten Unity-Projekt umfasst (Sie laden beispielsweise Firebase-Konfigurationsdateien von der Konsole herunter und verschieben sie dann in Ihr Unity-Projekt).

Ereignisse protokollieren

Nachdem Sie das Modul Firebase.Analytics.FirebaseAnalytics initialisiert haben, können Sie es zum Protokollieren von Ereignissen mit der Methode LogEvent() verwenden.

Um Ihnen den Einstieg zu erleichtern, definiert das Analytics SDK eine Reihe von vorgeschlagenen Ereignissen, die bei verschiedenen App-Typen üblich sind, darunter Einzelhandels- und E-Commerce-, Reise- und Gaming-Apps. Weitere Informationen zu diesen Ereignissen und ihrer Verwendung finden Sie in den Artikeln zu Ereignissen und Eigenschaften in der Firebase-Hilfe.

Implementierungsdetails für vorgeschlagene Ereignistypen finden Sie an den folgenden Stellen:

  • Vorgeschlagene Ereignisse: siehe Liste der Event .
  • Vorgeschriebene Parameter: siehe Liste der Parameters .

Das folgende Beispiel zeigt, wie ein vorgeschlagenes SELECT_CONTENT Ereignis protokolliert wird:

    // Log an event with multiple parameters, passed as an array:

Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventSelectContent,
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemId, id),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemName, "name"),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.UserPropertySignUpMethod, "Google"),
  new Firebase.Analytics.Parameter(
    "favorite_food", mFavoriteFood),
  new Firebase.Analytics.Parameter(
    "user_id", mUserId)
);

Zusätzlich zu den vorgeschriebenen Parametern können Sie jedem Ereignis die folgenden Parameter hinzufügen:

  • Benutzerdefinierte Parameter: Benutzerdefinierte Parameter werden nicht direkt in Ihren Analytics-Berichten dargestellt, können aber als Filter in Zielgruppendefinitionen verwendet werden, die auf jeden Bericht angewendet werden können. Benutzerdefinierte Parameter sind auch in Daten enthalten , die nach BigQuery exportiert werden , wenn Ihre App mit einem BigQuery-Projekt verknüpft ist.

  • VALUE Parameter: VALUE ist ein Allzweckparameter , der zum Sammeln einer Schlüsselmetrik nützlich ist, die sich auf ein Analytics-Ereignis bezieht. Beispiele sind Umsatz, Entfernung, Zeit und Punkte.

Wenn Ihre Anwendung bestimmte Anforderungen hat, die nicht von einem vorgeschlagenen Analytics-Ereignistyp abgedeckt werden, können Sie Ihre eigenen benutzerdefinierten Analytics-Ereignisse protokollieren, wie in diesem Beispiel gezeigt:

Firebase.Analytics.FirebaseAnalytics.LogEvent("custom_progress_event", "percent", 0.4f);

Zeigen Sie Ereignisse in der Protokollausgabe an

Android

Sie können die ausführliche Protokollierung im Debug-Protokoll von Android Studio aktivieren, um zu überprüfen, ob Ereignisse vom SDK ordnungsgemäß protokolliert werden. Dies umfasst sowohl automatisch als auch manuell protokollierte Ereignisse.

Sie können die ausführliche Protokollierung mit einer Reihe von adb-Befehlen aktivieren:

adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

Dieser Befehl zeigt Ihre Ereignisse im Logcat von Android Studio an, sodass Sie sofort überprüfen können, ob Ereignisse gesendet werden.

iOS+

Ereignisse werden in der Konsole protokolliert und können angezeigt werden, während die App über XCode ausgeführt wird.

Zeigen Sie Analyseereignisse im Dashboard an

Sie können aggregierte Statistiken zu Ihren Analytics-Ereignissen in den Dashboards der Firebase-Konsole anzeigen. Diese Dashboards werden im Laufe des Tages regelmäßig aktualisiert. Verwenden Sie zum sofortigen Testen die Logcat-Ausgabe wie im vorherigen Abschnitt beschrieben.

So greifen Sie in der Firebase-Konsole auf diese Daten zu:

  1. Öffnen Sie in der Firebase-Konsole Ihr Projekt.
  2. Wählen Sie Analytics aus dem Menü aus, um das Analytics-Berichterstellungs-Dashboard anzuzeigen.

Auf der Registerkarte „Ereignisse“ werden die Ereignisberichte angezeigt, die automatisch für jeden einzelnen Typ von Analytics-Ereignis erstellt werden, der von Ihrer App protokolliert wird. Weitere Informationen zum Analytics-Berichterstellungs-Dashboard finden Sie in der Firebase-Hilfe.