Ereignisse protokollieren

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


Ereignisse geben Aufschluss darüber, was in Ihrer App passiert, z. B. Nutzeraktionen, Systemereignisse oder Fehler.

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 Einschränkungen im Hinblick auf die Gesamtmenge 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

Achten Sie darauf, dass Sie Ihr Projekt eingerichtet haben und wie in Erste Schritte mit Analytics beschrieben auf Analytics zugreifen können.

Wenn Sie Daten zur Kampagnenattribution erfassen möchten, müssen Sie das AdSupport-Framework zu Ihrem Projekt hinzufügen.

Ereignisse protokollieren

Nachdem Sie die FirebaseApp-Instanz konfiguriert haben, können Sie mit der Methode logEvent() beginnen, Ereignisse 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 wann sie verwendet werden sollten, finden Sie unter Empfohlene Ereignisse.

Details zur Implementierung finden Sie in der Konstantenreferenz für Swift und Objective-C.

Das folgende Beispiel zeigt, wie ein empfohlenes kFIRSelectContent-Ereignis protokolliert wird:

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])

Objective-C

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];

Zusätzlich zu den vorgeschriebenen Parametern können Sie jedem Ereignis die folgenden Parameter hinzufügen:

  • Benutzerdefinierte Parameter: Benutzerdefinierte Parameter können als Dimensionen oder Messwerte in Analytics-Berichten verwendet werden. Sie können benutzerdefinierte Dimensionen für nicht numerische Ereignisparameterdaten und benutzerdefinierte Messwerte für alle Parameterdaten verwenden, die sich besser numerisch darstellen lassen. Nachdem Sie einen benutzerdefinierten Parameter mit dem SDK protokolliert haben, müssen Sie die Dimension oder den Messwert registrieren, damit die benutzerdefinierten Parameter in Analytics-Berichten angezeigt werden. Rufen Sie dazu in der Firebase-Console Analysen > Benutzerdefinierte Definitionen auf.

    Benutzerdefinierte Parameter können 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. Beispielabfragen und vieles mehr finden Sie unter Google Analytics 4 BigQuery Export.

  • Parameter kFIRParameterValue: kFIRParameterValue ist ein Allzweckparameter, mit dem sich ein wichtiger Messwert für ein Ereignis erfassen lässt. Beispiele sind Umsatz, Entfernung, Zeit und Punkte.

Wenn Ihre Anwendung bestimmte Anforderungen hat, die nicht von einem empfohlenen Ereignistyp abgedeckt werden, können Sie Ihre eigenen benutzerdefinierten Ereignisse wie in diesem Beispiel gezeigt erfassen:

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])

Objective-C

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];

Standardereignisparameter festlegen

Mit setDefaultEventParameters können Sie Parameter für verschiedene Ereignisse protokollieren. Standardparameter sind mit allen zukünftigen Ereignissen verknüpft, die protokolliert werden.

Wie bei benutzerdefinierten Parametern müssen Sie auch die Standardereignisparameter registrieren, damit sie in Analytics-Berichten berücksichtigt werden.

Swift 

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

Objective-C 

[FIRAnalytics setDefaultEventParameters:
  @{
  @"level_name": "Caverns01",
  @"level_difficulty": @(4)
}];

Wenn ein Parameter in der Methode logEvent() angegeben ist, wird dieser Wert anstelle des Standardwerts verwendet.

Wenn Sie einen Standardparameter löschen möchten, rufen Sie die Methode setDefaultEventParameters auf und setzen Sie den Parameter auf nil.

Ereignisse in der Xcode-Debugkonsole ansehen

Sie können das ausführliche Logging aktivieren, um das Logging von Ereignissen durch das SDK zu überwachen und so zu prüfen, ob Ereignisse richtig protokolliert werden. Dazu gehören sowohl automatisch als auch manuell aufgezeichnete Ereignisse.

So aktivieren Sie das ausführliche Logging:

  1. Wählen Sie in Xcode Product > Scheme > Edit scheme… aus.
  2. Wählen Sie im Menü auf der linken Seite Ausführen aus.
  3. Wählen Sie den Tab Argumente aus.
  4. Fügen Sie im Bereich Beim Start übergebene Argumente -FIRAnalyticsVerboseLoggingEnabled hinzu.

Wenn Sie Ihre App das nächste Mal ausführen, werden Ihre Ereignisse in der Xcode-Debugging-Konsole angezeigt. So können Sie sofort überprüfen, ob Ereignisse gesendet werden.

Ereignisse im Dashboard ansehen

In der Firebase Console können Sie sich auf dem Dashboard „Ereignisse“ unter Analytics aggregierte 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. Für sofortige Tests verwenden Sie die Xcode-Debug-Konsolenausgabe, wie im vorherigen Abschnitt dieses Leitfadens beschrieben.