Erste Schritte mit Google Analytics

In dieser Schnellstartanleitung erfahren Sie, wie Sie Ihrer App Google Analytics hinzufügen und mit der Protokollierung von Ereignissen beginnen.

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 iOS - 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 > 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

  1. Fügen Sie die Abhängigkeit für Firebase zu Ihrem Podfile:
    pod 'Firebase/Analytics'
    
    # For Analytics without IDFA collection capability, use this pod instead
    # pod ‘Firebase/AnalyticsWithoutAdIdSupport’
    
    Weitere Infos zu IDFA, die auf Geräteebene Werbe - ID, in Apples Benutzer Datenschutz und Datenverwendung und App - Tracking - Transparency - Dokumentation.
  2. Run pod install Sie die erstellte und öffnen .xcworkspace Datei.
  3. Importieren Sie die Firebase Modul in Ihrem UIApplicationDelegate :

    Schnell

    import Firebase

    Ziel c

    @import Firebase;
  4. 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:

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"
                                 }];

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