Meta Conversions API (CAPI): ein praktischer Leitfaden

Mit der Meta Conversions API (CAPI) sendet dein Server Events wie Purchase direkt an Meta. Das Meta-Pixel sendet dieselben Events aus dem Browser des Käufers. CAPI sendet sie von deinem Server, sodass sie auch dann ankommen, wenn ein Adblocker das Pixel stoppt, ein Cookie fehlt oder die Dankeseite nie lädt.

Dieser Leitfaden behandelt, was ein Event der Conversions API enthält, wie du sie mit einer einzigen event_id neben dem Pixel betreibst, welche Parameter Meta verlangt und empfiehlt, wie du mit Test events testest und welche Fehler am häufigsten auftreten.

Was ist die Meta Conversions API?

Die Conversions API ist Teil der Graph API von Meta. Dein Server sendet eine HTTPS-POST-Anfrage an graph.facebook.com/VERSION/PIXEL_ID/events mit einem Access Token und einer data-Liste mit bis zu 1,000 Events. Jedes Event beschreibt eine Aktion, etwa einen Kauf, in drei Teilen: was passiert ist, wer es getan hat und die Details.

Ein gekürztes Purchase-Event sieht so aus:

{
  "data": [{
    "event_name": "Purchase",
    "event_time": 1792929600,
    "event_id": "order-1042",
    "action_source": "website",
    "event_source_url": "https://yourstore.com/checkouts/thank-you",
    "user_data": {
      "em": ["<SHA-256 of the normalized email>"],
      "ph": ["<SHA-256 of the normalized phone>"],
      "client_ip_address": "203.0.113.24",
      "client_user_agent": "Mozilla/5.0 (iPhone; ...)",
      "fbp": "fb.1.1792928400000.1234567890",
      "fbc": "fb.1.1792928400000.AbCdEf123"
    },
    "custom_data": { "value": 74.00, "currency": "USD" }
  }]
}

Kontaktfelder wie E-Mail-Adresse und Telefonnummer werden normalisiert und mit SHA-256 gehasht, bevor sie deinen Server verlassen. IP-Adresse, User Agent, fbp und fbc werden unverändert gesendet.

Warum die Conversions API neben dem Pixel betreiben?

Meta empfiehlt, die Conversions API neben dem Pixel zu betreiben und dieselben Events über beide zu senden. Jede Seite sieht etwas, das die andere nicht sieht, und zusammen liefern sie Meta vollständigere Daten.

Der Preis dafür, beides zu betreiben: Meta erhält jetzt zwei Kopien jedes Events. Der nächste Abschnitt zeigt, wie Meta nur eine behält.

Wie funktioniert die Deduplizierung mit einer event_id?

Meta behandelt ein Browser-Event und ein Server-Event als dasselbe Event, wenn zwei Dinge übereinstimmen: der Eventname und die Event-ID. Im Pixel steht die ID in der Option eventID. In der Conversions API steht derselbe Wert in event_id.

fbq('track', 'Purchase', { value: 74.00, currency: 'USD' }, { eventID: 'order-1042' });

Meta dedupliziert ein passendes Paar nur, wenn die beiden Kopien innerhalb von 48 Stunden nacheinander eintreffen. Ein paar Regeln sorgen dafür, dass das in der Praxis funktioniert:

• Erzeuge die ID nur einmal. Bilde sie aus etwas, das beide Seiten kennen, etwa der Bestellnummer, und gib sie an den Browser und den Server weiter. Zwei Systeme, die jeweils ihre eigene ID erzeugen, passen nicht zusammen.
• Verwende ein einheitliches Format. order-1042 und 1042 sind unterschiedliche IDs.
• Der Event-Name muss exakt übereinstimmen. Purchase und purchase sind verschiedene Events.
• Sende das Server-Event zügig. Ein Server-Event, das mehr als 48 Stunden nach dem Browser-Event eintrifft, wird ein zweites Mal gezählt.

Meta beschreibt außerdem eine zweite Methode, die Events über fbp oder external_id paart. Laut Meta funktioniert sie in der Regel nur, wenn das Browser-Event vor dem Server-Event eintrifft, deshalb ist eine gemeinsame event_id die zuverlässigere Wahl. Wenn Meta trotzdem mehr Käufe meldet, als dein Shop hatte, listet unser Leitfaden zu doppelten Purchase-Events die üblichen Ursachen auf.

Welche Parameter sind erforderlich, und welche werden empfohlen?

Die Pflichtfelder machen ein Event gültig. Die empfohlenen Felder entscheiden, wie viele deiner Events Meta einer Person zuordnen kann, und nur zugeordnete Events lassen sich für die Attribution und die Anzeigenauslieferung nutzen.

Drei Details verursachen die meisten Probleme:

• Normalisiere, bevor du hashst. Meta erwartet die E-Mail-Adresse ohne Leerzeichen am Rand und in Kleinbuchstaben, Telefonnummern als Ziffern mit Ländervorwahl. Anna@Example.com und anna@example.com ergeben unterschiedliche Hashes, und nur der zweite kann zugeordnet werden.
• Hashe keine Browser-Kennungen. fbp, fbc, die IP-Adresse und der User Agent werden als Klartextwerte übergeben.
• Behalte die Click-ID genau so, wie sie ist. Der Wert fbc besteht aus fb.1., dem Erstellungszeitpunkt in Millisekunden, einem Punkt und der fbclid aus der URL der Landingpage. Die fbclid unterscheidet Groß- und Kleinschreibung. Speichere sie, wenn der Besucher landet, denn beim Checkout steht sie nicht mehr in der URL.

Wie gut diese Felder zugeordnet werden, misst der Event-Match-Quality-Score von Meta. Unser Leitfaden zur Event Match Quality behandelt jeden Parameter, die Hashing-Regeln und den Score, den du anstreben solltest.

Wie testest du Events mit Test events?

Der Events Manager hat einen Tab Test events, der Events zeigt, sobald sie ankommen. Nutze ihn, bevor du dich auf ein neues Setup verlässt.

1. Test events öffnen

   Wähle im Events Manager dein Dataset (Pixel) aus und öffne den Tab Test events. Kopiere den dort angezeigten Testcode.

2. Den Code zu deinen Server-Events hinzufügen

   Sende ihn in der Anfrage als test_event_code. In ROASaurus fügst du ihn in das Feld Test event code des Meta-Pixels ein.

3. Eine Testbestellung aufgeben

   Besuche den Shop, lege ein Produkt in den Warenkorb und bezahle, damit sowohl das Pixel als auch der Server ein Purchase senden.

4. Die beiden Kopien vergleichen

   Beide Kopien sollten denselben Eventnamen, dieselbe Event-ID, denselben Wert und dieselbe Währung zeigen.

5. Die Kundeninformationen prüfen

   Das Server-Event sollte gehashte E-Mail-Adresse und Telefonnummer, die IP-Adresse, den User Agent und fbp enthalten, dazu fbc, wenn der Besuch mit einem Anzeigenklick begann.

6. Den Testcode entfernen

   Meta sagt, das Feld sei nur zum Testen gedacht, entferne es also, bevor du dich auf die Events verlässt.

Häufige Fehler der Conversions API und wie du sie behebst

Öffne nach ein paar Tagen mit Live-Traffic den Tab Diagnostics im Events Manager. Meta listet dort Probleme mit Empfehlungen zur Behebung auf. Vergleiche danach die tägliche Purchase-Zahl im Events Manager mit den bezahlten Bestellungen in deinem Shop für dieselben Tage. Liegt Meta deutlich höher, listet unser Hilfeartikel zum Vermeiden von Doppelzählungen die Einstellungen auf, die du prüfen solltest.

So richtest du die Conversions API mit ROASaurus ein

ROASaurus sendet Events der Conversions API aus den Bestelldaten deines Shops, sodass du die Server-Seite nicht selbst bauen musst. Klicke unter Tracking & platforms auf Connect with Facebook und wähle dein Werbekonto und dein Pixel, oder füge die ID des Pixels (Datasets) und ein Conversions-API-Token ein. Die Einrichtungsanleitung für Meta führt durch beide Optionen, und die Seite zur Meta-Integration listet jedes gesendete Feld auf.

• Eine ID auf beiden Seiten. Browser- und Server-Events teilen sich eine Event-ID. Bei einem Kauf ist es order- gefolgt von der Bestell-ID.
• Eine kurze Wartezeit vor dem Kauf. Das Server-Purchase wartet nach dem Eingang der Bestellung einen kurzen Moment, damit zuerst das Browser-Event des Kaufs zugeordnet werden kann. Dessen IP-Adresse, User Agent und Seiten-URL werden dann zusammen mit den für den Besucher gespeicherten fbp und fbc mit dem Server-Event gesendet.
• Kundeninformationen aus der Bestellung. E-Mail-Adresse, Telefonnummer, Name und Adresse werden normalisiert und mit SHA-256 gehasht. Die Kunden-ID des Shops und die ROASaurus-Besucher-ID werden gehasht als external_id mitgeschickt.
• Events, die Meta nicht zuordnen kann, werden übersprungen. Ein Event ohne fbc, fbp, E-Mail-Adresse, Telefonnummer oder IP-Adresse wird nicht gesendet.

Im Event log siehst du jede Server-Zustellung mit der Anfrage und der Antwort von Meta. Wenn sich deine Margen zwischen Produkten stark unterscheiden, kannst du neben jedem Kauf auch einen Gewinnwert senden: Unser Leitfaden zur Meta-Wertoptimierung für Gewinn erklärt, wie. Den gesamten Datenweg vom Klick bis zur Bestellung findest du unter Server-Side-Tracking.

Quellen

1. Meta for Developers: Handling Duplicate Pixel and Conversions API Events
2. Meta for Developers: Server Event Parameters
3. Meta for Developers: Customer Information Parameters
4. Meta for Developers: Using the API - Conversions API
5. Meta for Developers: ClickID and the fbp and fbc Parameters

In ROASaurus

• Meta-Integration
• Hilfe: Meta verbinden
• Hilfe: Doppelzählung verhindern
• Server-Side-Tracking

Weiterlesen