Erste Schritte mit Google Analytics für iOS+

Plattform auswählen: iOS+ Android Web Flutter Unity C++


In dieser Kurzanleitung erfahren Sie, wie Sie Google Analytics in Ihre App einbinden und mit dem Protokollieren 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. Nutzeraktionen, Systemereignisse oder Fehler.
  • Nutzereigenschaften:Attribute, die Sie definieren, um bestimmte Nutzersegmente wie Spracheinstellungen oder geografische Standorte zu beschreiben.

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

Hinweis

  1. Falls noch nicht geschehen, fügen Sie Ihrem Apple-Projekt Firebase hinzu und achten Sie darauf, 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 vorhandenes Firebase-Projekt verwenden, für das Google Analytics nicht aktiviert ist, können Sie es in den Einstellungen > Tab Integrationen aktivieren.

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

  2. (Empfohlen) Fügen Sie das AdSupport-Framework zu Ihrem Projekt 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:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Wählen Sie die Bibliothek Analytics aus.
  4. Fügen Sie das Flag -ObjC im Abschnitt Other Linker Flags (Andere Linker-Flags) der Build-Einstellungen Ihres Ziels hinzu.
  5. Für eine optimale Nutzung von Analytics empfehlen wir, Google Analytics zu aktivieren und das Firebase SDK für Google Analytics in Ihre App einzubinden. Sie können entweder die Bibliothek ohne IDFA-Erfassung oder mit IDFA-Erfassung auswählen. Weitere Informationen finden Sie in den FAQs zur neuesten Organisation von Modulen im Google Analytics for Firebase SDK.
  6. Wenn Sie fertig, beginnt Xcode automatisch, Ihre Abhängigkeiten im Hintergrund aufzulösen und herunterzuladen.

Weitere Informationen zum IDFA, der Werbe-ID auf Geräteebene, findest du in der Apple-Dokumentation zu Datenschutz und Datennutzung und App Tracking Transparency.

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

  1. Importieren Sie das FirebaseCore-Modul in Ihre UIApplicationDelegate sowie alle anderen Firebase-Module, die Ihr App-Delegat verwendet. Beispiel für die Verwendung von 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 in der application(_:didFinishLaunchingWithOptions:)-Methode des App-Delegats eine freigegebene FirebaseApp-Instanz:

    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 ein App-Delegat erstellen und es über UIApplicationDelegateAdaptor oder NSApplicationDelegateAdaptor an Ihre App-Struktur anhängen. Außerdem müssen Sie das Swizzling des App-Delegaten deaktivieren. Weitere Informationen finden Sie in der SwiftUI-Anleitung.

    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 der Attribution für das Apple-Werbenetzwerk deaktivieren

Das SDK registriert Ihre App automatisch bei Apple für die Werbenetzwerk-Attribution 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 (boolescher Wert).

Ereignisse protokollieren

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

Bestimmte Ereignisse werden für alle Apps empfohlen, andere für bestimmte Unternehmenstypen oder Branchen. Sie sollten vorgeschlagene Ereignisse gemeinsam mit den zugehörigen Parametern senden, um detaillierte Berichte zu erhalten und von zukünftigen Funktionen und Integrationen zu profitieren. In diesem Abschnitt wird das Protokollieren eines vordefinierten Ereignisses veranschaulicht. Weitere Informationen zum Protokollieren von Ereignissen finden Sie unter Ereignisse protokollieren.

Im folgenden Beispiel wird gezeigt, wie Sie ein empfohlenes Ereignis protokollieren, um anzugeben, dass ein Nutzer auf ein bestimmtes Element in Ihrer App geklickt hat:

Swift

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

Objective-C

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

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

  1. Wählen Sie in Xcode Product > Scheme > Edit scheme… aus.
  2. Wählen Sie im Menü auf der linken Seite Ausführen aus.
  3. Wählen Sie den Tab Argumente aus.
  4. Fügen Sie im Bereich Beim Start übergebene Argumente -FIRAnalyticsDebugEnabled hinzu.

Nächste Schritte