Google is committed to advancing racial equity for Black communities. See how.
Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Ereignisse protokollieren

Diese Anleitung zeigt Ihnen, wie Sie Ereignisse in Ihrer App protokollieren.

Ereignisse bieten Einblicke in die Vorgänge in Ihrer App, z. B. Benutzeraktionen, 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 sammeln muss, können Sie bis zu 500 verschiedenen Analytics Ereignistypen in der App einloggen oben. Das Gesamtvolumen der Ereignisse, die Ihre App protokolliert, ist unbegrenzt. Beachten Sie, dass bei Ereignisnamen zwischen Groß- und Kleinschreibung unterschieden wird und dass die Protokollierung von zwei Ereignissen, deren Namen sich nur für den Fall unterscheiden, zu zwei unterschiedlichen Ereignissen führt.

Bevor Sie beginnen

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

Ereignisse protokollieren

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

Um Ihnen den Einstieg zu erleichtern, definiert das Analytics SDK eine Reihe von vorgeschlagenen Ereignissen, die für verschiedene Arten von Apps gelten, darunter Einzelhandels- und E-Commerce-, Reise- und Spiele-Apps. Weitere Informationen zu diesen Ereignissen und deren Verwendung finden Sie in den Artikeln [Ereignisse und Eigenschaften] [Vorgeschlagene Ereignisse-hc] in der Firebase-Hilfe.

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

Das folgende Beispiel zeigt, wie ein vorgeschlagenes kFIRSelectContent Ereignis kFIRSelectContent :

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 für die Berichterstellung in Ihren Analytics-Berichten registriert werden . Sie können auch als Filter 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.

  • Parameter kFIRParameterValue : kFIRParameterValue ist ein Allzweckparameter, mit dem eine Schlüsselmetrik akkumuliert werden kann, die sich auf ein Ereignis bezieht. Beispiele sind Umsatz, Entfernung, Zeit und Punkte.

Wenn Ihre Anwendung bestimmte Anforderungen hat, die nicht durch einen vorgeschlagenen Ereignistyp abgedeckt sind, 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
                                 }];

Zeigen Sie Ereignisse in der Xcode-Debug-Konsole an

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

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

  1. Wählen Sie in Xcode Produkt> Schema> Schema bearbeiten ...
  2. Wählen Sie im linken Menü die Option Ausführen .
  3. Wählen Sie die Registerkarte Argumente .
  4. -FIRAnalyticsDebugEnabled Abschnitt Argumente beim Start übergeben -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 Firebase-Konsolen-Dashboards anzeigen. Diese Dashboards werden im Laufe des Tages regelmäßig aktualisiert. Verwenden Sie zum sofortigen Testen die Logcat-Ausgabe wie im vorherigen Abschnitt beschrieben.

Sie können über das Ereignis- Dashboard in der Firebase-Konsole auf diese Daten zugreifen. Dieses Dashboard zeigt die Ereignisberichte an, die automatisch für jeden von Ihrer App protokollierten Ereignistyp erstellt werden.