Erste Schritte mit Google Analytics

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

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

  • Ereignisse: Was in Ihrer App passiert, z. B. Benutzeraktionen, Systemereignisse oder Fehler.
  • Benutzereigenschaften: Attribute, die Sie definieren, um Segmente Ihrer Benutzerbasis zu beschreiben, z. B. Sprachpräferenz oder geografischer Standort.

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

Bevor Sie beginnen

  1. Falls noch nicht geschehen, fügen Sie Firebase zu Ihrem Apple-Projekt hinzu und stellen Sie sicher, dass Google Analytics in Ihrem Firebase-Projekt aktiviert ist:

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

    • Wenn Sie ein bestehendes Firebase-Projekt verwenden, für das Google Analytics nicht aktiviert ist, wechseln Sie zur Registerkarte „Integrationen“ Ihres Projekts > Projekteinstellungen , um es 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 das AdSupport-Framework zu Ihrem Projekt hinzu, um zusätzliche Funktionen wie Zielgruppen und Kampagnenzuordnung zu aktivieren.

Fügen Sie das Analytics SDK zu Ihrer App hinzu

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

  1. Navigieren Sie in Xcode bei geöffnetem App-Projekt zu File > Add Packages .
  2. Wenn Sie dazu aufgefordert werden, fügen Sie das Firebase Apple Platforms SDK-Repository hinzu:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Wählen Sie die Analytics-Bibliothek.
  5. Fügen Sie das Flag -ObjC zum Abschnitt „Andere Linker-Flags“ der Build-Einstellungen Ihres Ziels hinzu.
  6. Für ein optimales Erlebnis mit Analytics empfehlen wir, Google Analytics in Ihrem Firebase-Projekt zu aktivieren und das Firebase SDK für Google Analytics zu Ihrer App hinzuzufügen. Sie können entweder die Bibliothek ohne IDFA-Sammlung oder mit IDFA-Sammlung auswählen.
  7. Wenn Sie fertig sind, beginnt Xcode automatisch mit der Auflösung und dem Herunterladen Ihrer Abhängigkeiten im Hintergrund.

Weitere Informationen zu IDFA, der Werbekennung auf Geräteebene, finden Sie in der Dokumentation zu Benutzerdatenschutz, Datennutzung und App-Tracking-Transparenz von Apple.

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

  1. Importieren Sie das FirebaseCore Modul in Ihr UIApplicationDelegate sowie alle anderen Firebase-Module, die Ihr App-Delegierter verwendet. Um beispielsweise Cloud Firestore und Authentifizierung zu verwenden:

    SwiftUI

    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Schnell

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Ziel c

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. Konfigurieren Sie eine gemeinsam genutzte FirebaseApp Instanz in der application(_:didFinishLaunchingWithOptions:) Methode Ihres App-Delegierten:

    SwiftUI

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

    Schnell

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

    Ziel c

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. Wenn Sie SwiftUI verwenden, müssen Sie einen Anwendungsdelegaten erstellen und ihn über UIApplicationDelegateAdaptor oder NSApplicationDelegateAdaptor an Ihre App Struktur anhängen. Sie müssen auch das Swizzling von App-Delegierten deaktivieren. Weitere Informationen finden Sie in den SwiftUI-Anweisungen .

    SwiftUI

    @main
    struct YourApp: App {
      // register app delegate for Firebase setup
      @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
    
      var body: some Scene {
        WindowGroup {
          NavigationView {
            ContentView()
          }
        }
      }
    }
          


(Optional) Deaktivieren Sie die Attributionsregistrierung für das Apple-Werbenetzwerk

Zu Ihrer Bequemlichkeit registriert das SDK Ihre App automatisch bei Apple für die Werbenetzwerkzuordnung mit SKAdNetwork . Wenn Sie diese Funktion deaktivieren möchten, setzen Sie den Wert von GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED in der info.plist-Datei Ihrer App auf NO (Boolean).

Beginnen Sie mit der Protokollierung von Ereignissen

Nachdem Sie die FirebaseApp Instanz konfiguriert haben, können Sie mit der Protokollierung von Ereignissen mit der Methode logEvent() beginnen.

Bestimmte Ereignisse werden für alle Apps empfohlen ; andere werden für bestimmte Geschäftstypen oder Branchen empfohlen. Sie sollten vorgeschlagene Ereignisse zusammen mit den vorgeschriebenen Parametern senden, um die größtmögliche Detailgenauigkeit in Ihren Berichten sicherzustellen und von zukünftigen Funktionen und Integrationen zu profitieren, sobald diese verfügbar sind. In diesem Abschnitt wird die Protokollierung eines vordefinierten Ereignisses veranschaulicht. Weitere Informationen zur Protokollierung von Ereignissen finden Sie unter Ereignisse protokollieren .

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

Schnell

Hinweis: Dieses Firebase-Produkt ist auf dem macOS-Ziel nicht verfügbar.
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

Ziel c

Hinweis: Dieses Firebase-Produkt ist auf dem macOS-Ziel nicht verfügbar.
[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];

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

  1. Wählen Sie in Xcode Produkt > Schema > Schema bearbeiten... aus.
  2. Wählen Sie im linken Menü „Ausführen“ .
  3. Wählen Sie die Registerkarte Argumente .
  4. Fügen Sie im Abschnitt „Beim Start übergebene Argumente“ -FIRAnalyticsDebugEnabled hinzu.

Nächste Schritte