Ereignisse protokollieren

Ereignisse bieten Einblicke in das, 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. Die Gesamtmenge der von Ihrer App protokollierten Ereignisse ist unbegrenzt. Beachten Sie, dass bei Ereignisnamen die Groß-/Kleinschreibung beachtet wird und dass das Protokollieren von zwei Ereignissen, deren Namen sich nur in der Groß-/Kleinschreibung unterscheiden, zu zwei unterschiedlichen Ereignissen führt.

Bevor Sie beginnen

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

  • 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 nicht über ein Unity - Projekt haben, können Sie eine Download - Beispielanwendung .

  • Fügen Sie die Firebase Unity SDK (genauer gesagt, FirebaseAnalytics.unitypackage ) , um Ihre Unity - Projekt.

Beachten Sie, dass das Hinzufügen Firebase zu Ihrer Unity Projektaufgabe beinhaltet sowohl in der Firebase - Konsole und in Ihrem geöffneten Projekt Unity (zum Beispiel downloaden Sie Config - Dateien Firebase aus der Konsole, dann in der Unity - Projekt bewegen).

Ereignisse protokollieren

Nachdem Sie den initialisierte Firebase.Analytics.FirebaseAnalytics Modul, können Sie es verwenden , um Ereignisse mit dem loggen LogEvent() Methode.

Um Ihnen den Einstieg zu erleichtern, definiert das Analytics SDK eine Reihe von vorgeschlagenen Ereignissen, die für verschiedene Arten von Apps üblich sind, einschließlich Einzelhandels- und E-Commerce-, Reise- und Spiele-Apps. Um mehr zu erfahren über diese Ereignisse und wann sie verwendet werden , durchsuchen Sie die Ereignisse und Eigenschaften Artikel in der Firebase - Hilfe.

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

  • Empfohlene Veranstaltungen: die Liste der sehen Event
  • Vorgeschriebene Parameter: siehe die Liste der Parameters Konstanten.

Das folgende Beispiel zeigt , wie ein vorgeschlagenes loggt SELECT_CONTENT Veranstaltung:

    // 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, aber sie können als Filter verwendet werden in Audience Definitionen, die für jeden Bericht angewendet werden kann. Benutzerdefinierte Parameter werden auch in Daten enthalten exportiert BigQuery wenn Ihre Anwendung auf ein BigQuery - Projekt verknüpft ist.

  • VALUE Parameter: VALUE ist ein Allzweck - Parameter , die zum Akkumulieren eine wichtige Kennzahl , dass bezieht sich auf ein Analytics - Ereignis nützlich ist. Beispiele sind Umsatz, Entfernung, Zeit und Punkte.

Wenn Ihre Anwendung spezielle Anforderungen hat, die von einem vorgeschlagenen Analytics-Ereignistyp nicht 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);

Ereignisse in der Protokollausgabe anzeigen

Android

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

Mit diesem Befehl werden Ihre Ereignisse im Android Studio-Logcat angezeigt, 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.

Analyseereignisse im Dashboard anzeigen

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 Ausgabe von logcat, wie im vorherigen Abschnitt beschrieben.

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

  1. In der Firebase Konsole , öffnen Sie Ihr Projekt.
  2. Wählen Analytics aus dem Menü der Analytics anzuzeigen Reporting Dashboard.

Die Registerkarte Ereignisse zeigt die Ereignisberichte , die für jede einzelne Art von Analytics - Ereignis automatisch erstellt werden , indem Sie Ihre App angemeldet. Lesen Sie mehr über die Analytics Reporting - Dashboard in der Firebase - Hilfe.