Conversions API als Plattform einrichten

Wenn du das Meta-Pixel-Setup als Teil deiner Tag-Management-Dienste anbietest, empfiehlt sich möglicherweise die Nutzung der Funktionen der Conversions API Durch die Integration der Conversions API können deine Kund*innen Web-Events direkt an Facebook senden, ohne auf Browser-Pixel-Events angewiesen zu sein.

Server-Events versus Browser-Events

Bevor du beginnst, solltest du die Beziehung zwischen Server-Events und dem Meta Pixel verstanden haben. Server-Events werden über die Conversions API gesendet und für Messungen, Reporting und Optimierung auf dieselbe Weise verwendet wie Browser-Pixel-Events.

Vergleichst du das Senden von Browser-Pixel-Events mit dem Versenden von Luftpost-Paketen, entspricht das Senden von Server-Events dem Versenden von Paketen auf dem Land-/Seeweg. Beide Optionen sind Möglichkeiten für den Transport eines Pakets (Daten zu einem Event) an eine Zieladresse (eine Pixel-ID). Deshalb empfehlen wir dir aus folgenden Gründen, die Conversions API-Integration auf deiner Plattform als Erweiterung deines aktuellen Meta-Pixel-Angebotes (anstelle eines separaten Plugins oder eines eigenen Dienstes) einzurichten:

• Server-Events verwenden Pixel-IDs als Ziel
• Server-Events werden auf dieselbe Weise verarbeitet, wie Browser-Pixel-Events früher an Facebook gesendet wurden.
• Abgabe ist einfacher zu implementieren.
• Einfache Nutzung für Kund*innen. So können zum Beispiel Server-Events standardmäßig zusätzlich zu Browser-Events gesendet werden.

Nach der Integration deiner Plattform mit der Conversions API empfehlen wir dir, dieselben Web-Events über Browser und über Server zu senden. Mit dieser Redundanz sorgst du für verlässlichen Empfang. Events, die früher aus verschiedenen Netzwerk-bedingten Gründen auf der Browserseite verloren gegangen wären, werden jetzt über die Conversions API erfasst.

Um Events über Browser und Server zu senden, musst du dieselbe event_id für entsprechende Events richtig angeben. Dadurch kann Facebook deine Events richtig deduplizieren.

Voraussetzungen

1. Eine Webplattform, die Events auf Facebook teilen kann. Zum Beispiel Website Builder, Tag Manager oder AdTech-Plattform.
2. Geeignete Hinweise für deine Nutzer*innen und deren Einwilligung für das Teilen von Event-Daten mit Facebook gemäß der Nutzungsbedingungen für Facebook Business-Tools.
3. Ein Facebook-Vertreter
4. Die Standardvoraussetzungen für die Integration der Conversions API:
   • Business Manager
   • Eine Meta-App
   • Meta-Pixel
   • Ein Zugriffsschlüssel

Los geht's

Wenn du zum ersten Mal die Conversions API verwendest, befolge diese Schritte zum Erstellen eines Unternehmens, einer Meta-App, eines Meta-Pixels und eines Systemnutzers. Dann kannst du mit dem Zugriffsschlüssel deines Systemnutzers Server-Events über die Conversions API senden.

Schritt 1: Erstelle ein Unternehmen.

Schritt 2: Erstelle eine Meta-App unter deinem neu erstellten Unternehmen.

Schritt 3: Erstelle ein Meta-Pixel unter deinem neu erstellten Unternehmen:

• Gehe zu Events Manager.
• Wähle Neue Datenquelle hinzufügen.

Schritt 4: Erstelle einen Zugriffsschlüssel für Systemnutzer.

Schritt 5: Sende ein Server-Event an dein Meta-Pixel.

Sende Events im Namen von Kund*innen

Nachdem du ein Server-Event erfolgreich an dein eigenes Meta-Pixel gesendet hast, kannst du Events im Namen deiner Kund*innen senden.

Für Meta-Pixel, die dem Business Manager des Partners gehören oder von ihm verwaltet werden

1. Navigiere im Business Manager zum Bereich Nutzer und wähle den Tab Systemnutzer aus. Klicke auf den Systemnutzer, den du für die Conversions API verwendest.
2. Navigiere zum Dialog Asset zuweisen und wähle Pixel. Wähle dann die Pixel aus, für die du Events für andere senden möchtest.
3. Wähle für jedes Pixel die Berechtigung Pixel verwalten und klicke auf Änderungen speichern.
4. Gehe zurück zur Detailseite deines Systemnutzers. Überprüfe, ob die ausgewählten Pixel dort angezeigt werden.

Für Facebook-Pixel, die nicht vom Partner verwaltet werden

Du musst zunächst eine Autorisierung zum Senden von Events im Namen deiner Kund*innen beantragen. Für die Authentifizierung stehen dir folgende Optionen zur Verfügung:

Facebook Business Extension (empfohlen)

Mit dieser Option gibt Facebook Business Extension (FBE) alle notwendigen Informationen zurück, um Events im Namen des*der Kund*in über den folgenden Prozess zu senden. Die FBE stellt einen Endpunkt für den Abruf von Zugriffsschlüsseln für Systemnutzer bereit, die im Business Manager des*der Kund*in erstellt wurden. Dieser Prozess umfasst Berechtigungen für das Senden von Server-Events. Er erfolgt automatisch und ist sicher.

Der Endpunkt benötigt einen Nutzerzugriffsschlüssel als Eingabeparameter. Für neue FBE-Nutzer*innen rufst du diesen Endpunkt auf, um den Zugriffsschlüssel des Systemnutzers abzuholen, nachdem du die FBE eingerichtet hast. Bestehende Nutzer*innen müssen sich erneut authentifizieren lassen, um den neuen API-Endpunkt aufrufen zu können.

Systemnutzer-Zugriffsschlüssel von Kund*innen

Mit dieser Option muss dein*e Kund*in über die Conversions API in den Pixeleinstellungen manuell einen Systemnutzer-Zugriffsschlüssel erstellen. Mit diesem Token kannst du dann Events an das Pixel des Werbetreibenden senden.

Die App, mit der der Zugriffsschlüssel erstellt wird, muss von einem Systemnutzer oder Admin-Systemnutzer installiert werden. Bei dieser Einrichtung kann deine App APIs im Namen des Systemnutzers oder Admin-Systemnutzers aufrufen.

Befolge die in Dokumentation Los geht's genannten Schritte und fordere einen Systemnutzer-Schlüssel von deinem Werbetreibenden an. Verwende für Tests dein eigenes Meta-Pixel und deinen Zugriffsschlüssel.

Kund*innen teilen Meta-Pixel mit dem Business Manager des Partners

Mit dieser Option teilen Kund*innen ihr Meta-Pixel über die Business Manager-Einstellungen oder über die API mit dem Partner. Dann kannst du den Partnersystemnutzer dem Kund*innen-Pixel zuweisen und einen Zugriffsschlüssel zum Senden von Server-Events generieren.

Events mit dem partner_agent-Feld deiner Plattform zuordnen

Verwende zum Zuordnen von Conversions API-Events zu deiner Plattform partner_agent-Feld. So kannst du deine eigene Plattform-ID festlegen, wenn du Events im Namen eines*einer Kund*in sendest. Definiere gemeinsam mit deinem Facebook-Vertreter eine ID für deine Plattform. Sende diese dann zusammen mit jedem Server-Event.

Beispiel-Event-Payload

Wenn deine Plattform-ID datapartner lautet, wäre dies ein Beispiel für eine Kauf-Event-Payload, die im Namen deines*der Kund*in gesendet wird:

    
{
  "data": [
    {
      "user_data": {
        "em": "8159ea0e33c51a774b83104ee562784f9b1836c852102046e4bd8385706fe7ca"
      },
      "event_name": "PageView",
      "event_time": 1579645238
    },
    {
      "user_data": {
        "em": "8159ea0e33c51a774b83104ee562784f9b1836c852102046e4bd8385706fe7ca"
      },
      "custom_data": {
        "currency": "USD",
        "value": "50"
      },
      "event_name": "Purchase",
      "event_time": 1579645238
    }
  ],
  "partner_agent": "datapartner"
}

Häufig gestellte Fragen