Erste Schritte mit Google Analytics für iOS+

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


In diesem Schnellstart wird beschrieben, wie Sie Google Analytics in Ihre App einfügen und mit der Erfassung von Ereignissen beginnen.

Google Analytics erhebt Nutzungs- und Verhaltensdaten für Ihre App. Das SDK protokolliert zwei primäre Arten von Informationen:

  • Ereignisse:Was in Ihrer App passiert, z. B. Nutzeraktionen, Systemereignisse oder Fehler.
  • Nutzereigenschaften:Attribute, die Sie definieren, um 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 der Projekterstellung.

    • Wenn Sie ein vorhandenes Firebase-Projekt verwenden, in dem Google Analytics nicht aktiviert ist, können Sie es auf dem Tab Integrationen unter Einstellungen 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 in Ihre App einbinden

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 Analytics-Mediathek aus.
  4. Fügen Sie das Flag -ObjC dem 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 in Ihrem Firebase-Projekt 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. Häufig gestellte Fragen zur aktuellen Organisation von Modulen im Google Analytics für das 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, finden Sie in der Dokumentation von Apple unter User Privacy and Data Use 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 von Ihrem App-Delegate verwendet werden. So verwenden Sie beispielsweise 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 gemeinsam genutzte FirebaseApp-Instanz in der application(_:didFinishLaunchingWithOptions:)-Methode des 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 ein Anwendungsdelegate erstellen und es über UIApplicationDelegateAdaptor oder NSApplicationDelegateAdaptor an Ihre App-Struktur anhängen. Außerdem müssen Sie das Swizzling von 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 Apple-Werbenetzwerk-Attribution deaktivieren

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

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 empfohlene 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 gezeigt, wie ein vordefiniertes Ereignis protokolliert wird. 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 in Ihrer App auf ein bestimmtes Element 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