Erste Schritte mit App-Events (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 beginnst

Was du benötigst:

• Ein Facebook-Entwicklerkonto
• Ein Facebook-Werbekonto
• Ein Facebook-Unternehmenskonto (erstelle ein neues Unternehmenskonto, 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 Unternehmenskonten

Um Werbeanzeigen zu schalten und Installationen im Werbeanzeigenmanager zu messen, musst du mindestens ein Werbekonto und ein Unternehmenskonto 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

Füge deine Bundle-ID hinzu und aktiviere Single Sign-On für deine App.

Schritt 5: Konfiguriere dein Projekt

Schritt 6: Verbinde deinen App Delegate und Scene Delegate

    
// AppDelegate.swift
import UIKit
import FacebookCore

@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 FacebookCore
  ...
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

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

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

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.