Erste Schritte mit App-Events in iOS

In diesem Leitfaden erfährst du, wie du App-Events zu deiner neuen oder bestehenden App hinzufügst. Hierzu musst du das Facebook-SDK integrieren und dann diese Events protokollieren.

Bevor du loslegst

Voraussetzungen:

• Ein Facebook-Entwicklungskonto
• Ein Facebook-Werbekonto
• Ein Facebook-Business-Portfolio (erstelle ein neues Business-Portfolio, falls du noch keines hast)
• Eine Facebook-App

Schritt 1: Konfiguriere deine Facebook-App

Navigiere zum App-Dashboard, klicke auf Meine Apps und erstelle eine neue App, wenn du noch keine hast. Gehe zu Einstellungen > Allgemeines, um das Fenster App-Details mit deiner App-ID, deinem App-Geheimcode und anderen Details zu deiner App aufzurufen.

Scrolle zum Ende der Seite und klicke auf Plattform hinzufügen. Wähle iOS aus, füge die Informationen zu deiner App hinzu und speichere deine Änderungen.

Gib die folgenden Details an, um deine App für Werbeanzeigen einzurichten:

• App-Domains: Gib die Apple App Store-URL für deine App an.
• URL zur Datenrichtlinie: Gib eine Datenrichtlinien-URL an. Diese ist erforderlich, damit deine App veröffentlicht werden kann.
• URL zu Nutzungsbedingungen: Gib eine Nutzungsbedingungen-URL an.
• Plattform: Scrolle im Fenster „Einstellungen“ nach unten, um die iOS-Plattform hinzuzufügen.

Sieh dir die Dokumentation zur App-Entwicklung an, wenn du weitere Details wie ein Symbol oder eine Kategorie zu deiner App hinzufügen möchtest.

Schritt 2: Verknüpfe deine Anzeigen- und Business-Portfolios

Um Werbeanzeigen zu schalten und Installationen im Werbeanzeigenmanager zu messen, musst du mindestens ein Werbekonto und ein Business-Portfolio mit deiner App verknüpfen.

1. Klicke im App-Dashboard auf Einstellungen > Erweitert.
2. Füge deine Werbekonten-IDs unter Autorisierte Werbekonten-IDs hinzu. Du kannst deine Werbekonten-IDs vom Werbeanzeigenmanager abrufen.
3. Klicke im Bereich Werbekonten auf Los geht's und befolge die Anweisungen, um die App mit einem Unternehmen zu verknüpfen.

Schritt 3: Richte deine Entwicklungsumgebung ein

In der nachstehenden Vorgehensweise richtest du deine Entwicklungsumgebung in Xcode mit dem Swift Package Manager ein.

1. Klicke in Xcode auf File > Add Packages....
2. Gib im angezeigten Suchfeld die Repository-URL ein: https://github.com/facebook/facebook-ios-sdk.
3. Wähle in Dependency Rule die Option Up to Next Major Version aus und gib eine aktuelle Version ein. Die aktuelle Version findest du unter https://github.com/facebook/facebook-ios-sdk/releases/.
4. Wähle die gewünschten Bibliotheken und die Ziele aus, denen du diese Bibliotheken hinzufügen möchtest.
5. Klicke auf Add Package, um das Setup abzuschließen.

Schritt 4: Registriere und konfiguriere deine App für Facebook

1. Scrolle im App-Dashboard unter App-Einstellungen > Allgemeines nach unten und klicke auf + Plattform hinzufügen.
2. Scrolle nach unten zur iOS-Karte und füge deine Bundle-ID hinzu. Deine Bundle-ID findest du im iOS-App-Ziel deines XCode-Projekts. Du kannst deine Bundle-ID jederzeit aktualisieren.

Schritt 5: Konfiguriere dein Projekt

Schritt 6: Verbinde deinen App Delegate und Scene Delegate

  
// AppDelegate.swift
import UIKit
import FBSDKCoreKit

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {    
    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {          
        ApplicationDelegate.shared.application(
            application,
            didFinishLaunchingWithOptions: launchOptions
        )

        return true
    }
          
    func application(
        _ app: UIApplication,
        open url: URL,
        options: [UIApplication.OpenURLOptionsKey : Any] = [:]
    ) -> Bool {
        ApplicationDelegate.shared.application(
            app,
            open: url,
            sourceApplication: options[UIApplication.OpenURLOptionsKey.sourceApplication] as? String,
            annotation: options[UIApplication.OpenURLOptionsKey.annotation]
        )
    }  
}

 
// SceneDelegate.swift
import FBSDKCoreKit
  ...
func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let url = URLContexts.first?.url else {
        return
    }

    ApplicationDelegate.shared.application(
        UIApplication.shared,
        open: url,
        sourceApplication: nil,
        annotation: [UIApplication.OpenURLOptionsKey.annotation]
    )
}

Schritt 7: Füge App-Events hinzu

Es gibt drei Möglichkeiten, Events in deiner App zu tracken:

• Automatisch protokollierte Events: Das Facebook-SDK protokolliert automatisch App-Installationen, Launches und App-interne Käufe.
• Das Tool für App-Events ohne Code: Füge mit diesem Tool Standard-Events hinzu, ohne Code zu deiner App hinzuzufügen.
• Manuell protokollierte Events: Füge Code zu deiner App hinzu, um Standard-Events und selbstdefinierte Events zu tracken.

Automatisch protokollierte Events

Automatisch protokollierte Events für In-App-Käufe

Apple bietet vier verschiedene Arten von In-App-Käufen an: verbrauchbar, nicht verbrauchbar, automatisch verlängerbare Abonnements und nicht verlängerbare Abonnements. Wenn du In-App-Käufe mit StoreKit 1 implementierst, protokollieren wir automatisch jede dieser Arten von In-App-Käufen. Wenn du In-App-Käufe mit StoreKit 2 implementierst, protokollieren wir automatisch nicht verbrauchbare Artikel, automatisch verlängerbare Abonnements und nicht verlängerbare Abonnements. Wenn auch Verbrauchsartikel automatisch protokolliert werden sollen, musst du den Schlüssel SKIncludeConsumableInAppPurchaseHistory zu deiner Info.plist hinzufügen:

<key>SKIncludeConsumableInAppPurchaseHistory</key>

<true/>

In StoreKit 1 wird automatisch ein Event protokolliert, wenn der*die Nutzer*in erfolgreich ein Produkt kauft, ein Produkt wiederherstellt oder versucht, ein Produkt zu kaufen, aber der Kauf fehlschlägt. In StoreKit 2 wird automatisch ein Event protokolliert, wenn der*die Nutzer*in erfolgreich ein Produkt kauft oder ein Produkt wiederherstellt. Wenn auch protokolliert werden soll, wenn ein Produkt in StoreKit 1 fehlschlägt, stellen wir dir eine manuelle API zur Verfügung, die du aufrufen musst. Du kannst diese API folgendermaßen in deinem StoreKit 2-Kaufablauf aufrufen:

do {
   let result = try await product.purchase()
   switch result {
   case .success(let verificationResult):
       // Handle success case
   case .pending:
       // Handle pending case
   default:
       AppEvents.shared.logFailedStoreKit2Purchase(product.id)
   }
} catch {
   AppEvents.shared.logFailedStoreKit2Purchase(product.id)
}

Geräteeinwilligung abrufen

Ab iOS 14.5 musst du das Flag isAdvertiserTrackingEnabled aktivieren und jedes Mal protokollieren, wenn du einem Gerät die Berechtigung erteilst, Daten mit Facebook zu teilen.

Wenn ein Gerät die Einwilligung erteilt, lege Settings.shared.isAdvertiserTrackingEnabled = true fest.

Wenn ein Gerät kein Tracking zulässt, lege Settings.shared.isAdvertiserTrackingEnabled = false fest.

<key>FacebookAutoLogAppEventsEnabled</key>
<false/>

<key>FacebookAdvertiserIDCollectionEnabled</key>
<false/>

Manuelles Protokollieren von Events

Um ein selbstdefiniertes Event zu protokollieren, übergib einfach den Namen des Events als AppEvents.Name:

AppEvents.shared.logEvent(AppEvents.Name("battledAnOrc"))

Event-Parameter

Meta hat eine Reihe nützlicher Event-Parameter für Standard-Events oder deine eigenen selbstdefinierten Events erstellt. Du kannst auch eigene Parameter angeben.

Wenn du App-Events zum Messen der Conversions von Dynamic Ads verwenden möchtest, lege den Parameter fb_content_id so fest, dass er der in der zugehörigen Dynamic Ad verwendeten Produkt-ID entspricht.

Diese vordefinierten Parameter dienen als Leitlinien für gängige Protokollierungsmuster und weisen möglicherweise eine besser lesbare Form in der Berichterstellung und anderen UIs auf. Protokolliere die Parameter, die du aufschlüsseln möchtest. Die empfohlene Beschreibung dieser Parameter dient lediglich als Leitlinie. Du kannst die Parameter so einsetzen, wie es für deine App sinnvoll ist.

Die Parameter werden über ein Dictionary übergeben, wobei der Schlüssel den Parameternamen als AppEvents.ParameterName enthält und der Wert entweder ein String oder eine Zahl (Int, Double usw.) sein muss.

Schritt 8: Teste deine Events

Mit dem App Ads-Hilfstool kannst du die App-Events in deiner App testen, um sicherzustellen, dass deine App-Events an Facebook sendet.

1. Öffne das App Ads-Hilfstool.
2. Wähle unter App auswählen deine App aus und wähle dann Senden aus.
3. Scrolle nach unten und wähle Event testen aus.
4. Starte deine App und sende ein Event. Das Event sollte auf der Webseite angezeigt werden.

Mehr dazu

• Leitfaden für Best Practices: Sieh dir viele verschiedene Beispiel-Apps an und erfahre, wie die einzelnen Apps mit App-Events umgehen.
• FAQ: Sieh dir unsere häufig gestellten Fragen an.
• Meta Blueprint-Kurs: Das SDK und App-Events für iOS konfigurieren
• Meta Blueprint-Kurs: App Events zum Ansprechen von Zielgruppen, Optimieren und Messen verwenden

Beispiel-Apps

Wir haben einige Beispiele für unterschiedliche App-Typen erstellt, um dir besser zu zeigen, wie du App-Events einsetzen kannst. Jede der Beispiel-Apps bietet eine Aufschlüsselung der verschiedenen Events und Parameter, die auf den einzelnen Bildschirmen erfasst werden können. Am Ende jedes Abschnitts werden die empfohlenen Events und Parameter für jede App in einer Tabelle aufgelistet. Bei Bedarf kannst du auch deine eigenen Events und Parameter erstellen.