Ereignisse protokollieren

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 Begrenzung für das Gesamtvolumen der Ereignisse, die Ihre App protokolliert. Achten Sie bei Ereignisnamen auf Groß- und Kleinschreibung: Wenn Sie zwei Ereignisse protokollieren, deren Namen sich nur in der Groß- und Kleinschreibung unterscheiden, werden zwei unterschiedliche Ereignisse protokolliert.

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

Eine detaillierte Anleitung für diese ersten Einrichtungsaufgaben finden Sie unter Firebase zu einem Unity-Projekt hinzufügen.

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 es verwenden, um Ereignisse mit der Methode LogEvent() zu protokollieren.

Das Analytics SDK definiert eine Reihe empfohlener Ereignisse, die für verschiedene Arten von Apps üblich sind, darunter Einzelhandel und E-Commerce, Reisen und Spiele. Weitere Informationen zu diesen Ereignissen und dazu, wann Sie sie verwenden sollten, finden Sie in den Hilfeartikeln zu empfohlenen Ereignissen in der Google Analytics-Hilfe.

Hinweis :Wenn Sie die vorgeschlagenen Analytics-Ereignisse, die für Ihre App sinnvoll sind, mit den zugehörigen Parametern protokollieren, erhalten Sie besonders detaillierte Berichte. So profitieren Sie auch von den neuesten Google Analytics-Funktionen, sobald diese verfügbar sind.

Implementierungsdetails für empfohlene Ereignisse finden Sie an den folgenden Stellen:

• Vorgeschlagene Ereignisse: Siehe die Liste der Event-Konstanten.
• Vorgeschriebene Parameter: Siehe die 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, 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 in BigQuery exportiert werden, wenn Ihre App mit einem BigQuery-Projekt verknüpft ist.

• VALUE-Parameter: VALUE ist ein Parameter für allgemeine Zwecke, mit dem sich ein wichtiger Messwert für ein Analytics-Ereignis erfassen lässt. Beispiele sind Umsatz, Entfernung, Zeit und Punkte.

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

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

Ereignisse in der Logausgabe ansehen

Android

Sie können das ausführliche Logging im Android Studio-Debug-Log 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 Logcat von Android Studio angezeigt. So können Sie sofort überprüfen, ob Ereignisse gesendet werden.

iOS+

Ereignisse werden in der Konsole protokolliert und können während der Ausführung der App über Xcode angezeigt werden.

Analytics-Ereignisse im Dashboard ansehen

Sie können sich aggregierte Statistiken zu Ihren Analytics-Ereignissen in den Firebase-Konsolendashboards ansehen. Diese Dashboards werden mehrmals täglich aktualisiert. Für sofortige Tests verwenden Sie die logcat-Ausgabe, wie im vorherigen Abschnitt beschrieben.

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

1. Öffnen Sie Ihr Projekt in der Firebase-Konsole.
2. Wählen Sie im Menü Analytics aus, um das Dashboard für Analytics-Berichte aufzurufen.

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