Conversions API für App-Events

Mit der Conversions API können Werbetreibende Web-Events, App-Events, Events in physischen Stores und Business-Messaging-Events über einen einzigen Endpunkt statt über mehrere Quellen an Meta senden. Diese Konsolidierung vereinfacht die technischen Anforderungen für Werbetreibende. Außerdem wird mit der Verwendung von Datensätzen eine umfassendere Ansicht im Meta Events Manager erstellt.

Diese Dokumentation enthält eine Anleitung zur Integration von App-Events in die Conversions API.

Voraussetzungen

1. Datensatz

Über die Conversions API gesendete App-Events müssen mit einem Datensatz verbunden sein.

Du kannst den GET-Aufruf unter https://graph.facebook.com /v16.0/{ads-pixel-id}/is_consolidated_container tätigen, um festzustellen, ob der Datensatz des Werbetreibenden konsolidiert und somit zur Weitergabe von App-Events über die Conversions API autorisiert ist.

2. Berechtigungen

• Um als Werbetreibender eine direkte Integration zu implementieren, befolge bitte die Anweisungen hier zu den Voraussetzungen und Berechtigungen.

• Für die Implementierung einer Partnerplattform-Integration befolge bitte die Anweisungen hier zu den Voraussetzungen und Berechtigungen.

Konfiguration

Senden von App-Events an die Conversions API

a. Verlinken von Datensatz-ID und App-ID

Im Events Manager gibt es zwei Möglichkeiten, deine App mit einem Datensatz zu verlinken:

• Wähle den Tab „Datenquellen“ aus, suche den Tab „Einstellung“ deiner App und führe die Verlinkung durch.
• Wähle den Tab „Datenquellen“ im Tab „Übersicht“ deiner App aus und verwende den Button „Link zum Datensatz“ im Bereich „Alle Aktivitäten“.

Sobald du die Verlinkung abgeschlossen hast, enthält der Datensatz die verbundene App.

b. Erforderliche Felder

Du kannst hier auf den aktuellen Satz Parameter verweisen, der über die Conversions API gesendet werden kann. Zum Senden von App-Events können die folgenden server_event Felder im Payload geteilt werden:

• Der Parameter action_source muss den Wert app für App-Events enthalten.
• Die event_id ist für die Deduplizierungs-Einrichtung erforderlich.
• app_data fields
• user_data fields
• custom_data fields

App-Datenfelder

Parameter für Kund*inneninformationen

Selbstdefinierte Daten

Insgesamt sind für die App-Events, die mit der Conversions API geteilt werden, die folgenden Datenparameter erforderlich:

• action_source: Muss auf „App“ eingestellt sein. (Indem du die Conversions API verwendest, versicherst du, dass der Parameter action_source nach bestem Wissen und Gewissen richtig ist.)
• event_id: Für die Einrichtung der Deduplizierung erforderlich, siehe Details unter „Einrichten der Deduplizierung für mehrere Kanäle“.
• advertiser_tracking_enabled
• application_tracking_enabled
• extinfo

Nachstehend findet du ein Beispiel für extinfo. Stelle sicher, dass alle nachstehenden Unterparameter angegeben sind und in sequentieller Reihenfolge aufgeführt werden. Falls etwas fehlt, füge einen leeren String als Platzhalter ein.

c. Einrichten der Deduplizierung für mehrere Kanäle

Der Deduplizierungsmechanismus ist erforderlich, um den duplizierten Event-Traffic zwischen der Conversions API-Integration und deinen anderen bestehenden Integrationen mit App Events, einschließlich SDK, MMPs und App Events API, zu entfernen.

Für App-Events wenden wir dieselbe Deduplizierungsfunktion an wie für Web-Events. Die Logik nutzt die auf den Feldern event_id und event_name basierte Deduplizierung (Conversions API und SDK / App Events API-Events, die über dieselbe event_id verfügen). Der event_id-Parameter ist eine ID zur eindeutigen Unterscheidung ähnlicher Events. Ungenaue Event-IDs können zu einer fehlerhaften Deduplizierung deiner Conversion führen. Dies kann sich auf das Conversion-Reporting und die Kampagnenperformance auswirken.

Informationen zur Einrichtung der Deduplizierung findest du in der folgenden Dokumentation für Entwickler*innen:

• So richtest du App-Events ein
• Beispiel für die Einrichtung der Deduplizierung

Hier findest du ein Beispiel für die Protokollierung von selbstdefinierten Events. Übergib hierfür den Namen des Events als AppEvents.Name an das iOS-SDK:

AppEvents.shared.logEvent(.achievedLevel, parameters: [AppEvents.ParameterName(rawValue: "event_id"): "123"])

Für App-Installations-Events gibt es bereits einen Deduplizierungsmechanismus, der sicherstellt, dass im letzten 90-Tage-Fenster nur eine Installation zugeordnet wird Wir behalten das erste Event und ignorieren die neueren Events unabhängig von ihrer Handlungs-Quelle. Die Deduplizierung für mit Installations-Events verwandten App-Events muss nicht zwingend implementiert werden.

d. Senden von Events

Tätige zum Senden neuer Events eine POST-Anfrage von folgendem Pfad an die Conversions API: https://graph.facebook.com/{API_VERSION}/{DATASET_ID}/events?access_token={TOKEN}. Wenn du in dieser Edge postest, erstellt Meta neue App-Server-Events. Mehr dazu findest du im folgenden Entwicklungsdokument.

Hier findest du eine Übersicht dazu, wie sich die Parameter in das Gesamtschema in der Payload einfügen:

{
    "data": [
        {
            "event_name": "Purchase",
            "event_time": 1684389752,
            "action_source": "app",
            "user_data": {
                "em": [
                    "30a79640dfd8293d4f4965ec11821f640ca77979ca0a6b365f06372f81a3f602"
                ],
                "ph": [
                    "74234e98afe7498fb5daf1f36ac2d78acc339464f950703b8c019892f982b90b",
                    "74234e98afe7498fb5daf1f36ac2d78acc339464f950703b8c019892f982b90b"
                ],
                "madid": "bbbbbbbbbbbb",
      "anon_id": "cccccccc"
            },
            "custom_data": {
                "currency": "USD",
                "value": "142.52"
            },
            "app_data": {
                "advertiser_tracking_enabled": "True",
                "application_tracking_enabled": "True",
                "campaign_ids": "aaaaaaaaa",
                "extinfo": [
                    "a2",
                    "com.some.app",
                    "771",
                    "Version 7.7.1",
                    "10.1.1",
                    "OnePlus6",
                    "en_US",
                    "GMT-1",
                    "TMobile",
                    "1920",
                    "1080",
                    "2.00",
                    "2",
                    "128",
                    "8",
                    "USA/New York"
                ]
            }
        }
    ]
}

Problembehandlung

Mit dem Payload-Hilfstool kannst du Payload-Daten generieren:

• Wähle gegebenenfalls die Handlungs-Quelle app.
• Gib Informationen zu den Events ein, die an Meta gesendet werden.
• Dadurch wird die Event-Payload generiert, die als Vorlage für deine Conversions API-Integration verwendet werden kann.

Verwende das Test-Events-Tool im Events Manager zum Testen.

Siehe auch

• Übersicht über die Conversions-API
• Die Conversions API nutzen
• Parameter der Conversions API
• Best Practices