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 einige Ereignisse automatisch. Sie müssen also keinen Code hinzufügen, um diese Ereignisse zu erhalten. Wenn Sie zusätzliche Daten benötigen, können Sie bis zu 500 verschiedene Analytics Ereignistypen in Ihrer App erfassen. Es gibt keine Beschränkung für die Gesamtzahl der Ereignisse, die Ihre App protokolliert. Beachten Sie, dass bei Ereignisnamen zwischen Groß- und Kleinschreibung unterschieden wird. Wenn Sie zwei Ereignisse protokollieren, deren Namen sich nur durch die 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 registriert und für Firebase konfiguriert.

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

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

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

Ereignisse protokollieren

Nachdem Sie das Modul Firebase.Analytics.FirebaseAnalytics 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 Einzelhandels-, E-Commerce-, Reise- und Gaming-Apps. Weitere Informationen zu diesen Ereignissen und ihrer Verwendung finden Sie in den Artikeln zu empfohlenen Ereignissen in der Google Analytics-Hilfe.

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

  • Vorgeschlagene Ereignisse: Liste der Event Konstanten
  • Vorgeschriebene Parameter: 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 in Ihren Analytics Berichten nicht direkt dargestellt, können aber als Filter in Zielgruppen Definitionen verwendet werden, die auf jeden Bericht angewendet werden können. Benutzerdefinierte Parameter sind auch in den Daten enthalten, die nach BigQuery exportiert werden, wenn Ihre App mit einem BigQuery-Projekt verknüpft ist.

  • VALUE-Parameter: VALUE ist ein allgemeiner Parameter , mit dem ein wichtiger Messwert für ein Analytics Ereignis erfasst werden kann. Beispiele sind Umsatz, Entfernung, Zeit und Punkte.

Wenn Ihre Anwendung spezielle Anforderungen hat, die nicht von einem vorgeschlagenen Analytics Ereignistyp abgedeckt werden, können Sie eigene benutzerdefinierte Analytics Ereignisse protokollieren, wie in diesem Beispiel:

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

Ereignisse in der Protokollausgabe ansehen

iOS+

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

Android

Sie können die ausführliche Protokollierung 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 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

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

Analytics-Ereignisse im Dashboard ansehen

In der Firebase Console können Sie aggregierte Statistiken zu Ihren Ereignissen im Dashboard Analytics > Ereignisse ansehen.

Beachten Sie bei diesem Dashboard Folgendes:

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

  • Das Dashboard wird mehrmals täglich aktualisiert. Für sofortige Tests verwenden Sie die Xcode-Debug-Console oder die Logcat-Ausgabe, wie im vorherigen Abschnitt dieser Anleitung beschrieben.

Weitere Informationen zum Dashboard.