Ereignisse protokollieren

In dieser Anleitung erfahren Sie, wie Sie Ereignisse in Ihrer App protokollieren.

Ereignisse bieten Einblicke in das, was in Ihrer App passiert, z. B. Benutzeraktionen, Systemereignisse oder Fehler.

Analytics automatisch protokolliert einige Ereignisse für Sie; Sie müssen keinen Code hinzufügen, um sie zu erhalten. Wenn Ihre App zusätzliche Daten sammeln muss, können Sie bis zu 500 verschiedenen Analytics Ereignistypen in der App einloggen oben. 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

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

Ereignisse protokollieren

Nachdem Sie die konfiguriert haben FirebaseApp Instanz, können Sie beginnen , Ereignisse zu protokollieren mit dem logEvent() Methode.

Um Ihnen den Einstieg zu erleichtern, definiert das Analytics SDK eine Reihe von vorgeschlagenen Ereignissen, die bei verschiedenen Arten von Apps üblich sind, einschließlich Einzelhandels- und E-Commerce-, Reise- und Spiele-Apps. Weitere Informationen zu diesen Ereignissen und deren Verwendung finden Sie in den Artikeln [Ereignisse und Eigenschaften][suggested-events-hc] in der Firebase-Hilfe.

Sie können Implementierungsdetails in der Konstanten Referenz für finden Swift und Objective-C .

Das folgende Beispiel zeigt , wie eine vorgeschlagene loggt kFIRSelectContent Ereignis:

Schnell

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

Ziel c

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

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

  • Benutzerdefinierte Parameter: Benutzerdefinierte Parameter können registriert für die Berichterstattung in Ihren Analytics - Berichten. Sie können auch als Filter verwendet werden in Publikum 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.

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

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

Schnell

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

Ziel c

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

Standard-Ereignisparameter festlegen

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

Schnell

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

Ziel c

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

Wenn ein Parameter in dem specificed wird logEvent() Methode, wird dieser Wert anstelle des Standard verwendet.

Um einen Standardparameter zu löschen, rufen Sie die setDefaultEventParameters Methode mit dem Parametersatz auf nil .

Ereignisse in der Xcode-Debugkonsole anzeigen

Sie können die ausführliche Protokollierung aktivieren, um die Protokollierung von Ereignissen durch das SDK zu überwachen, um sicherzustellen, dass Ereignisse ordnungsgemäß protokolliert werden. Dies umfasst sowohl automatisch als auch manuell protokollierte Ereignisse.

Sie können die ausführliche Protokollierung wie folgt aktivieren:

  1. In Xcode, wählen Sie Product> Schema> Edit Schema ...
  2. Wählen Sie Run aus dem linken Menü.
  3. Wählen Sie die Registerkarte Argumente.
  4. In den übergebenen Argumenten auf Starten Abschnitt Add -FIRAnalyticsDebugEnabled .

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

Ereignisse im Dashboard anzeigen

Sie können aggregierte Statistiken zu Ihren 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.

Sie können diese Daten zugreifen aus dem Event Armaturenbrett in der Konsole Firebase. Dieses Dashboard zeigt die Ereignisberichte, die automatisch für jeden einzelnen Ereignistyp erstellt werden, der von Ihrer App protokolliert wird.