Erste Schritte mit Google Analytics für iOS+

In dieser Kurzanleitung erfahren Sie, wie Sie Ihrer App Google Analytics 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:Hierbei geht es darum, was in Ihrer App geschieht, also z. B. um Nutzeraktionen, Systemereignisse oder Fehler.
• Nutzereigenschaften:Attribute, die Sie definieren, um Segmente Ihrer Nutzerbasis zu beschreiben, z. B. Spracheinstellungen oder geografische Standorte.

Analytics protokolliert einige Ereignisse und Nutzereigenschaften automatisch. Sie müssen dafür also keinen Code hinzufügen.

Hinweis

1. Falls noch nicht geschehen, fügen Sie Ihrem Apple-Projekt Firebase hinzu und prüfen Sie, ob Google Analytics in Ihrem Firebase Projekt aktiviert ist:

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

   • Wenn Sie ein vorhandenes Firebase-Projekt verwenden, in dem Google Analytics nicht aktiviert ist, rufen Sie in den Einstellungen den Tab „Integrationen“ Ihrer settings > Projekteinstellungen auf und aktivieren Sie die Funktion.

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

2. (Empfohlen) Fügen Sie Ihrem Projekt das AdSupport-Framework hinzu um zusätzliche Funktionen wie Zielgruppen und Kampagnenattribution zu aktivieren.

Analytics SDK zu Ihrer App hinzufügen

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

1. Öffnen Sie Ihr App-Projekt und gehen Sie in Xcode zu File > Add Packages (Datei > Pakete hinzufügen).
2. Fügen Sie bei entsprechender Aufforderung das Firebase Apple Platforms SDK-Repository hinzu:

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

3. Wählen Sie die Analytics Bibliothek aus.
4. Fügen Sie das Flag -ObjC im Bereich Other Linker Flags (Weitere Verknüpfungsmerker) der Build-Einstellungen Ihres Ziels hinzu.
5. Für eine optimale Nutzung von Analytics empfehlen wir die Aktivierung von Google Analytics in Ihrem Firebase-Projekt und das Hinzufügen des Firebase SDK für Google Analytics zu Ihrer App. Sie können entweder die Bibliothek ohne IDFA-Erfassung oder mit IDFA-Erfassung auswählen. Weitere Informationen zur aktuellen Organisation von Modulen im Google Analytics for Firebase SDK finden Sie in unseren FAQs.
6. Wenn Sie fertig, beginnt Xcode automatisch, Ihre Abhängigkeiten im Hintergrund aufzulösen und herunterzuladen.

Weitere Informationen zum IDFA (Identifier for Advertisers), der Werbe-ID auf Geräteebene, finden Sie in der Dokumentation von Apple zu Datenschutz und Datennutzung von Nutzern und App Tracking Transparency.

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

1. Importieren Sie das FirebaseCore Modul in Ihr UIApplicationDelegate, sowie alle anderen Firebase-Module, die Ihr App-Delegat verwendet. Beispiel: So verwenden Sie Cloud Firestore und Authentication:

   SwiftUI

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

   Swift

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Objective-C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. Konfigurieren Sie eine FirebaseApp gemeinsame Instanz in der application(_:didFinishLaunchingWithOptions:) Methode Ihres App-Delegaten:

   SwiftUI

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

   Swift

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

   Objective-C

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

3. Wenn Sie SwiftUI verwenden, müssen Sie einen App-Delegaten erstellen und ihn an Ihre App Struktur über UIApplicationDelegateAdaptor oder NSApplicationDelegateAdaptor anhängen. Außerdem müssen Sie das Swizzling des App-Delegaten deaktivieren. Weitere Informationen finden Sie in der Anleitung zu SwiftUI.

   SwiftUI

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

(Optional) Registrierung für die Attribution von Apple-Werbenetzwerken deaktivieren

Das SDK registriert Ihre App automatisch bei Apple für die Attribution von Werbenetzwerken mit SKAdNetwork. Wenn Sie diese Funktion deaktivieren möchten, setzen Sie den Wert von GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED in der Datei info.plist Ihrer App auf NO (boolesch).

Ereignisse protokollieren

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

Bestimmte Ereignisse werden für alle Apps empfohlen; andere werden für bestimmte Unternehmenstypen oder Branchen empfohlen. Sie sollten vorgeschlagene Ereignisse zusammen mit den zugehörigen Parametern senden, um besonders detaillierte Berichte zu erhalten und von zukünftigen Funktionen und Integrationen zu profitieren. 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 Nutzer auf ein bestimmtes Element in Ihrer App geklickt hat:

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])
MigratedSnippets.swift

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

Wenn Sie dieses Ereignis in der Xcode-Debug-Konsole sehen möchten, aktivieren Sie das Analytics-Debugging:

1. Wählen Sie in Xcode Product > Scheme > Edit scheme... (Produkt > Schema > Schema bearbeiten…) aus.
2. Wählen Sie im Menü auf der linken Seite Run (Ausführen) aus.
3. Wählen Sie den Tab Arguments (Argumente) aus.
4. Fügen Sie im Bereich Arguments Passed On Launch (Beim Start übergebene Argumente) -FIRAnalyticsDebugEnabled hinzu.

Nächste Schritte

• Informationen zu den einzelnen Analytics-Berichten
• Ereignisse mit DebugView überprüfen
• Daten in der Firebase Konsole untersuchen.
• Anleitungen zu Ereignissen und Nutzereigenschaften.
• Daten nach BigQuery exportieren