Ereignisse protokollieren

Plattform auswählen: iOS+ Android Web Flutter Unity C++


Ereignisse liefern Informationen darüber, was in Ihrer App geschieht, z. B. Nutzeraktionen, 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 Beschränkung für die Gesamtmenge der Ereignisse, die Ihre App protokolliert. Beachten Sie bei der Benennung von Ereignissen die Groß-/Kleinschreibung. Zwei Ereignisnamen, die sich nur bei der Groß-/Kleinschreibung unterscheiden, führen zu zwei unterschiedlichen Ereignissen.

Hinweis

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

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

    • Wenn Ihr Unity-Projekt bereits Firebase 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.

Wenn Sie Firebase zu Ihrem Unity-Projekt hinzufügen, müssen Sie sowohl in der Firebase Console als auch in Ihrem offenen Unity-Projekt Aufgaben ausführen. Sie laden beispielsweise Firebase-Konfigurationsdateien aus der Console herunter und verschieben sie dann in Ihr Unity-Projekt.

Log-Ereignisse

Nachdem Sie das Firebase.Analytics.FirebaseAnalytics-Modul initialisiert haben, können Sie es verwenden, um Ereignisse mit der Methode LogEvent() zu protokollieren.

Für den Einstieg sind im Analytics SDK eine Reihe empfohlener Ereignisse definiert, die in verschiedenen Arten von Apps häufig vorkommen, z. B. in Einzelhandels- und E-Commerce-, Reise- und Gaming-Apps. Weitere Informationen zu diesen Ereignissen und ihrer Verwendung finden Sie in der Google Analytics-Hilfe im Artikel Empfohlene Ereignisse.

Details zur Implementierung empfohlener Ereignisse finden Sie hier:

  • Vorgeschlagene Ereignisse: Liste der Event-Konstanten
  • Vorgeschriebene Parameter: Liste der Parameters-Konstanten ansehen.

Das folgende Beispiel zeigt, wie ein empfohlenes 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 allgemeiner Parameter, der nützlich ist, um einen wichtigen Messwert zu akkumulieren, der sich auf ein Analytics-Ereignis bezieht. Beispiele hierfür sind Umsatz, Entfernung, Zeit und Punkte.

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

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

Ereignisse in der Logausgabe ansehen

iOS+

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

Android

Sie können das ausführliche Logging im Android Studio-Debugging-Log aktivieren, um zu prüfen, ob Ereignisse vom SDK ordnungsgemäß protokolliert werden. Dazu gehören sowohl automatisch als auch manuell protokollierte Ereignisse.

Sie können das ausführliche Logging 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

Mit diesem Befehl werden Ihre Ereignisse im Android Studio-Logcat angezeigt, sodass Sie sofort prüfen können, ob Ereignisse gesendet werden.

Analyseereignisse im Dashboard ansehen

In der Firebase-Konsole können Sie sich im Dashboard Analytics > Ereignisse zusammengefasste Statistiken zu Ihren Ereignissen ansehen.

Beachten Sie bei diesem Dashboard Folgendes:

  • Im Dashboard werden die Ereignisberichte angezeigt, die automatisch für jeden einzelnen Ereignistyp erstellt werden, der von Ihrer App protokolliert wird.

  • Das Dashboard wird mehrmals täglich aktualisiert. Wenn Sie sofort testen möchten, verwenden Sie die Xcode-Debugging-Konsole oder die Logcat-Ausgabe, wie im vorherigen Abschnitt dieses Leitfadens beschrieben.

Weitere Informationen zum Dashboard