Diese Seite wurde von der Cloud Translation API übersetzt.

Ereignisse protokollieren

In diesem Leitfaden erfahren Sie, wie Sie Ereignisse in Ihrer Anwendung protokollieren.

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

In Analytics werden einige Ereignisse automatisch protokolliert. Sie müssen also 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 Gesamtmenge der Ereignisse, die in Ihrer App protokolliert werden, ist nicht begrenzt. Bei Ereignisnamen wird zwischen Groß- und Kleinschreibung unterschieden. Das Logging von zwei Ereignissen, deren Namen sich nur in der Groß- und Kleinschreibung unterscheiden, führt zu zwei unterschiedlichen Ereignissen.

Hinweis

Prüfen Sie, ob Sie Ihr Projekt eingerichtet haben und auf Analytics zugreifen können, wie unter Erste Schritte mit Analytics beschrieben.

Protokollereignisse

Nachdem Sie die Instanz FirebaseApp konfiguriert haben, können Sie 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 ihrer Verwendung 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(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])ViewController.swift

Objective-C

[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];ViewController.m

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

Benutzerdefinierte Parameter: Benutzerdefinierte Parameter können in Analytics-Berichten als Dimensionen oder Messwerte verwendet werden. Sie können benutzerdefinierte Dimensionen für nicht numerische Ereignisparameterdaten und benutzerdefinierte Messwerte für 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 diese benutzerdefinierten Parameter in Analytics-Berichten berücksichtigt werden. Wählen Sie dazu Analytics > Ereignisse > Benutzerdefinierte Definitionen verwalten > Benutzerdefinierte Dimensionen erstellen aus.

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 Anwendung mit einem BigQuery-Projekt verknüpft ist. Beispielabfragen und weitere Informationen finden Sie unter BigQuery Export für Google Analytics 4.
kFIRParameterValue-Parameter: kFIRParameterValue ist ein allgemeiner Parameter, der sich zum Erfassen eines wichtigen Messwerts für ein Ereignis eignet. Beispiele sind Umsatz, Entfernung, Zeit und Punkte.

Wenn Ihre Anwendung bestimmte Anforderungen hat, die nicht durch einen empfohlenen Ereignistyp abgedeckt werden, können Sie eigene benutzerdefinierte Ereignisse erfassen, wie in diesem Beispiel gezeigt:

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject,
])PatternTabBarController.swift

Objective-C

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

Standardereignisparameter festlegen

Mit setDefaultEventParameters können Sie Parameter für mehrere Ereignisse protokollieren. Standardparameter sind allen zukünftigen Ereignissen zugeordnet, die protokolliert werden.

Registrieren Sie wie bei benutzerdefinierten Parametern die standardmäßigen Ereignisparameter, damit sie in Analytics-Berichten angezeigt werden.

Swift

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

Objective-C

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

Wenn in der Methode logEvent() ein Parameter 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 ordnungsgemäß protokolliert werden. Dazu gehören sowohl automatisch als auch manuell aufgezeichnete Ereignisse.

So aktivieren Sie die ausführliche Protokollierung:

Wählen Sie in Xcode Produkt > Schema > Schema bearbeiten... aus.
Wählen Sie im Menü auf der linken Seite Ausführen aus.
Wählen Sie den Tab Argumente aus.
Fügen Sie im Abschnitt Arguments Passed On Launch (Beim Start übergebene Argumente) -FIRAnalyticsVerboseLoggingEnabled hinzu.

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

Ereignisse im Dashboard ansehen

In den Dashboards der Firebase-Konsole können Sie zusammengefasste Statistiken zu Ihren Ereignissen ansehen. Diese Dashboards werden mehrmals täglich aktualisiert. Verwenden Sie für sofortige Tests die Logcat-Ausgabe, wie im vorherigen Abschnitt beschrieben.

Sie können auf diese Daten über das Ereignisse-Dashboard in der Firebase-Konsole zugreifen. Auf diesem Dashboard werden die Ereignisberichte angezeigt, die automatisch für jeden Ereignistyp erstellt werden, der von Ihrer App protokolliert wird.