Erste Schritte mit Google Analytics


In dieser Kurzanleitung erfahren Sie, wie Sie Google Analytics zu Ihrer App hinzufügen und damit beginnen, Ereignisse zu erfassen.

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

  • Ereignisse:Hierbei geht es darum, was in Ihrer App geschieht, also z. B. um Nutzeraktionen, Systemereignisse oder Fehler.
  • Nutzereigenschaften:Attribute, mit denen Sie Nutzersegmente wie Spracheinstellungen oder geografische Standorte beschreiben.

In Analytics werden einige Ereignisse und Nutzereigenschaften automatisch protokolliert. Sie müssen dazu keinen Code hinzufügen.

Hinweis

  1. 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 Projekterstellungsworkflows.

    • Wenn Sie ein vorhandenes Firebase-Projekt verwenden, für das Google Analytics nicht aktiviert ist, rufen Sie den Tab Integrationen unter  > Projekteinstellungen auf, um Google Analytics zu aktivieren.

    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 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 Bibliothek Analytics aus.
  4. Fügen Sie das Flag -ObjC im Abschnitt Other Linker Flags (Weitere Verknüpfungsmerker) der Build-Einstellungen des Ziels hinzu.
  5. Für eine optimale Nutzung von Analytics empfehlen wir, Google Analytics in Ihrem Firebase-Projekt zu aktivieren und Ihrer App das Firebase SDK für Google Analytics hinzuzufügen. Sie können entweder die Bibliothek ohne oder mit IDFA-Erfassung auswählen.
  6. Wenn Sie fertig, beginnt Xcode automatisch, Ihre Abhängigkeiten im Hintergrund aufzulösen und herunterzuladen.

Weitere Informationen zur IDFA, der Werbe-ID auf Geräteebene, finden Sie in der Dokumentation von Apple 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. 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 freigegebene Instanz von FirebaseApp in der application(_:didFinishLaunchingWithOptions:)-Methode Ihres App-Delegierten:

    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 Anwendungsdelegierten erstellen und über UIApplicationDelegateAdaptor oder NSApplicationDelegateAdaptor an das App-Objekt anhängen. Außerdem müssen Sie das App-Delegate-Swizzling 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 Apple-Werbenetzwerke deaktivieren

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

Ereignisse protokollieren

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

Bestimmte Ereignisse werden für alle Apps empfohlen, andere für bestimmte Unternehmenstypen oder Branchen. Sie sollten vorgeschlagene Ereignisse zusammen 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.

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

Swift

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

Objective-C

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

Wenn Sie dieses Ereignis in der Xcode-Debugkonsole sehen möchten, aktivieren Sie die Analytics-Fehlerbehebung:

  1. Wählen Sie in Xcode Produkt > Schema > Schema bearbeiten… 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