Erste Schritte mit Google Analytics

Google Analytics sammelt Nutzungs- und Verhaltensdaten für Ihre App. Das SDK protokolliert zwei Haupttypen von Informationen:

• Veranstaltungen: Was in Ihrer Anwendung geschieht, wie Benutzeraktionen, Systemereignisse oder Fehler.
• Benutzereigenschaften: Attribute definieren Sie Segmente Ihrer Nutzerbasis zu beschreiben, wie bevorzugte Sprache oder geographische Lage.

Analytics automatisch protokolliert einige Ereignisse und Benutzereigenschaften ; Sie müssen keinen Code hinzufügen, um sie zu aktivieren.

Bevor Sie beginnen

1. Wenn Sie nicht bereits haben, fügen Sie Firebase zu Ihrem Apple - Projekt und stellen Sie sicher , dass Google Analytics in Ihrem Projekt Firebase aktiviert ist:

   • Wenn Sie ein neues Firebase-Projekt erstellen, aktivieren Sie Google Analytics während des Projekterstellungsworkflows.

   • Wenn Sie ein vorhandenes Projekt Firebase verwenden , die nicht von Google Analytics nicht aktiviert ist , gehen Sie auf die Integrations Registerkarte Ihrer settings > Projekteinstellungen zu aktivieren.

   Wenn Sie Google Analytics in Ihrem Projekt aktivieren, werden Ihre Firebase-Apps mit Google Analytics-Datenströmen verknüpft.

2. (Empfohlen). Fügen Sie den AdSupport Rahmen zu einem Projekt zusätzliche Funktionen zu aktivieren , wie das Publikum und Kampagnen Zuschreibung.

Fügen Sie das Analytics SDK zu Ihrer App hinzu

Verwenden Sie den Swift Package Manager, um Firebase-Abhängigkeiten zu installieren und zu verwalten.

1. In Xcode, mit Ihrem App - Projekt zu öffnen, navigieren Sie zu Datei> Swift Packages> Paket hinzufügen Abhängigkeit.
2. Wenn Sie dazu aufgefordert werden, fügen Sie das SDK-Repository der Firebase Apple Platforms hinzu:

  https://github.com/firebase/firebase-ios-sdk
  

3. Wählen Sie die Analytics-Bibliothek aus.
4. Für eine optimale Erfahrung mit Analytics, empfehlen wir Google Analytics ermöglicht in Ihrem Firebase - Projekt und das Hinzufügen des Firebase SDK für Google Analytics in Ihrer App. Sie können entweder die Bibliothek ohne IDFA-Sammlung oder mit IDFA-Sammlung auswählen.
5. Wenn Sie fertig sind, beginnt Xcode automatisch, Ihre Abhängigkeiten im Hintergrund aufzulösen und herunterzuladen.

Erfahren Sie mehr über IDFA, die auf Geräteebene Werbe - ID, in Apples Benutzer Datenschutz und Datenverwendung und App - Tracking - Transparency - Dokumentation.

Führen Sie als Nächstes einige Konfigurationsschritte aus:

1. Importieren Sie die Firebase Modul in Ihrem UIApplicationDelegate :

   Schnell

   import Firebase

   Ziel c

   @import Firebase;

2. Konfigurieren ein FirebaseApp gemeinsame Instanz, in der Regel in Ihrem App - application:didFinishLaunchingWithOptions: Methode:

   Schnell

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Ziel c

   // Use Firebase library to configure APIs
   [FIRApp configure];

(Optional) Deaktivieren Sie die Registrierung der Apple-Werbenetzwerk-Attribution

Für Ihre Bequemlichkeit des SDK automatisch registriert Ihre App mit Apple für Ad - Netzwerk Zuschreibung mit SKAdNetwork . Wenn Sie diese Funktion deaktivieren möchten, setzen Sie den Wert von GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED auf NO (Boolean) in Ihrer App info.plist Datei.

Beginnen Sie mit der Protokollierung von Ereignissen

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

Bestimmte Ereignisse werden für alle Anwendungen empfohlen ; andere werden für bestimmte Unternehmenstypen oder Branchen empfohlen. Sie sollten vorgeschlagene Ereignisse zusammen mit den vorgeschriebenen Parametern senden, um maximale verfügbare Details in Ihren Berichten zu gewährleisten und von zukünftigen Funktionen und Integrationen zu profitieren, sobald sie verfügbar sind. Dieser Abschnitt zeigt die Anmeldung ein vordefiniertes Ereignis, um weitere Informationen über die Protokollierung von Ereignissen finden Sie Protokollereignisse .

Das folgende Beispiel zeigt, wie Sie ein empfohlenes Ereignis protokollieren, um anzuzeigen, dass ein Benutzer auf ein bestimmtes Element in Ihrer App geklickt hat:

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

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

Um dieses Ereignis in der Xcode-Debugging-Konsole anzuzeigen, aktivieren Sie das Analytics-Debugging:

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 .

Nächste Schritte

• Verwenden Sie die Debugview Ihre Ereignisse zu überprüfen.
• Entdecken Sie Ihre Daten in der Firebase - Konsole.
• Entdecken Sie die Führungen auf Ereignisse und Benutzereigenschaften.
• Erfahren Sie, wie Sie Ihre Daten exportieren BigQuery.