Ereignisse protokollieren

Ereignisse liefern Informationen darüber, was in Ihrer App geschieht, z. B. Nutzeraktionen, Systemereignisse oder Fehler.

Google Analytics protokolliert einige Ereignisse automatisch 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 unterschiedliche Analytics-Ereignistypen in Ihrer App erfassen. Die Gesamtzahl der Ereignisse, die in Ihrer App protokolliert werden, ist nicht begrenzt. Bei Ereignisnamen wird zwischen Groß- und Kleinschreibung unterschieden. Wenn Sie zwei Ereignisse protokollieren, deren Namen sich nur durch die Groß- und Kleinschreibung unterscheiden, werden zwei unterschiedliche Ereignisse erfasst.

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 in Ihrem Unity-Projekt bereits Firebase verwendet wird, 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 Ihrem Unity-Projekt das Firebase Unity SDK (insbesondere FirebaseAnalytics.unitypackage) hinzu.

Das Hinzufügen von Firebase zu Ihrem Unity-Projekt umfasst Aufgaben sowohl in der Firebase Console als auch in Ihrem geöffneten Unity-Projekt. Sie laden beispielsweise Firebase-Konfigurationsdateien aus der Console herunter und verschieben sie dann in Ihr Unity-Projekt.

Protokollereignisse

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

Zum Einstieg sind im Analytics SDK eine Reihe empfohlener Ereignisse definiert, die für verschiedene Arten von Apps üblich sind, z. B. für Einzelhandels- und E-Commerce-Apps, Reise- und Gaming-Apps. Weitere Informationen zu diesen Ereignissen und zu ihrer Verwendung finden Sie in den Artikeln Empfohlene Ereignisse in der Google Analytics-Hilfe.

Implementierungsdetails zu empfohlenen Ereignissen finden Sie an den folgenden Stellen:

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

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, sondern können 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, mit dem sich ein wichtiger Messwert für ein Analytics-Ereignis erfassen lässt. Beispiele sind Umsatz, Entfernung, Zeit und Punkte.

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

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

Ereignisse in der Logausgabe ansehen

Android

Sie können im Android Studio-Debug-Log ausführliches Logging aktivieren, um zu prüfen, ob Ereignisse vom SDK ordnungsgemäß protokolliert werden. Dazu gehören sowohl automatisch als auch manuell aufgezeichnete 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. So können Sie sofort prüfen, 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.

Analyseereignisse im Dashboard ansehen

In den Console-Dashboards für Firebase können Sie zusammengefasste Statistiken zu Ihren Analytics-Ereignissen aufrufen. Diese Dashboards werden mehrmals täglich aktualisiert. Verwenden Sie für sofortige Tests 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 Console Ihr Projekt.
  2. Wählen Sie im Menü Analytics aus, um das Berichtsdashboard für Analytics aufzurufen.

Auf dem Tab Ereignisse sehen Sie die Ereignisberichte, die automatisch für jeden Analytics-Ereignistyp erstellt werden, der von Ihrer App protokolliert wird. Weitere Informationen zum Dashboard