Facebook Conversions API: Implementierungsleitfaden für 2026
Facebooks Conversions API (CAPI) fungiert als serverseitiges Pendant zum Browser-Pixel. Nachdem iOS 14.5 browserbasierten Tracking schwer beschädigt hat, wurde CAPI zur einzigen Möglichkeit, die von Meta verlorenen Conversions zurückzugewinnen. Im Jahr 2026 lassen Advertiser, die nur mit Pixel arbeiten, zwischen 30 und 60 Prozent ihrer erfassten Conversions liegen. Diese Anleitung zeigt eine komplette CAPI-Implementierung von Anfang bis Ende.
Was CAPI wirklich leistet
CAPI sendet Conversion-Events direkt von Ihrem Server an Meta, ohne den Browser zwischenzuschalten. Dadurch erreichen Events ihr Ziel auch dann, wenn das Browser-Pixel blockiert wird, wenn das iOS-Gerät eines Nutzers Tracking beschränkt, oder wenn Netzwerkprobleme das Pixel zum Erliegen bringen.
- Stellt iOS-Conversions wieder her. Nutzer mit ATT-Beschränkungen lösen Server-Events aus.
- Umgeht Ad-Blocker. Server-zu-Server-Events werden nicht blockiert.
- Bessere Datenqualität. Server-Events können First-Party-Identifikatoren enthalten (gehashte E-Mail, Telefon, Kunden-ID) für stärkeres Matching.
- Verbesserte Deduplizierung. In Kombination mit dem Pixel mithilfe von
event_iddedupliziert Meta die Events und zählt jede Conversion einmalig.
Drei Implementierungswege
1. Native Plattformintegrationen (am einfachsten)
Shopify, WooCommerce, BigCommerce, Magento, Wix und Squarespace bieten alle native Meta-CAPI-Konnektoren. Aktivieren Sie die Integration in Ihrer Plattform, geben Sie das Access Token ein, fertig. Ideal für Teams ohne Entwickler.
2. Serverseitiger Tag Manager (empfohlen)
Nutzen Sie Stape oder Google Tag Manager Server-Side, um CAPI-Events aus einem sGTM-Container zu versenden. Sie erhalten volle Kontrolle über Events, Deduplizierung und Advanced Matching, ohne Server-Code zu schreiben. Der Standard für professionelle Anwender.
3. Direkte API-Integration (maximale Kontrolle)
Senden Sie POST-Anfragen direkt an https://graph.facebook.com/v18.0/{pixel_id}/events von Ihrem Backend aus. Perfekt für SaaS, benutzerdefinierte Anwendungen und alles, das nicht auf einer großen Handelsplattform aufgebaut ist.
Schritt für Schritt: Direkte API-Integration
- Erstellen Sie ein Zugriffstoken für die CAPI. Events Manager > Ihr Pixel > Einstellungen > Conversions API > Zugriffstoken generieren.
- Wählen Sie die Events aus, die serverseitig übermittelt werden sollen. Senden Sie immer Purchase, Lead und CompleteRegistration. Optional sind ViewContent, AddToCart und InitiateCheckout für aussagekräftigere Zuordnungen.
- Erstellen Sie die Event-Payload. Erforderlich:
event_name,event_time,action_source("website"),event_id(zur Deduplizierung) unduser_data(gehashte E-Mail, Telefon oder externe ID). - Hashen Sie alle user_data Felder mit SHA-256. E-Mail, Telefon, Name, Stadt, Bundesland, Postleitzahl, alles mit SHA-256 gehashed, in Kleinbuchstaben, ohne Leerzeichen.
- Senden Sie einen POST-Request an den Graph API Endpunkt. Fügen Sie das Zugriffstoken als Query-Parameter oder in der Kopfzeile hinzu.
- Implementieren Sie eine Wiederholungslogik. Fehlgeschlagene POST-Requests mit 5xx Fehlern sollten mit exponentieller Backoff-Strategie bis zu 3 Mal wiederholt werden.
- Protokollieren Sie jedes Event zur Nachverfolgung. Speichern Sie die Event-Payload und die Antwort von Meta, um Attribution später debuggen zu können.
Event-Deduplizierung: Das entscheidende Detail
event_id + event_name Kombination. Ohne korrekte IDs wird jede Conversion doppelt gezählt.- Generieren Sie eine eindeutige
event_idfür jede Conversion (zum Beispiel Ihre Bestellnummer). - Übermitteln Sie dieselbe
event_idsowohl im Browser-Pixel-Aufruf als auch im CAPI-Event. - Überprüfen Sie, dass die
event_nameexakt übereinstimmt, also "Purchase" und nicht "purchase". - Überprüfen Sie, dass die
event_timezwischen den beiden Events innerhalb von 1 Minute liegt, damit die Deduplizierung sauber funktioniert. - Nutzen Sie den Deduplication-Report im Events Manager, um zu bestätigen, dass die Quoten gesund sind (Browser plus Server entsprechte Events sollten die dominanteste Gruppe bilden).
Advanced Matching: Warum gehashte Identifizierer entscheidend sind
Über CAPI übermittelst du bei jedem Event Nutzeridentifizierer, gehashte E-Mail-Adressen, Telefonnummern, Namen, Städte und weitere Daten. Meta nutzt diese Informationen, um die Konversion dem Nutzer zuzuordnen, der die Anzeige angeklickt hat, auch wenn der Browser-Cookie verloren gegangen ist.
- E-Mail (em): Das wirkungsvollste Identifizierungsmerkmal überhaupt. Sende es bei jedem Event, das möglich ist.
- Telefon (ph): Nur Ziffern, ohne Formatierung, mit Ländervorwahl (beispielsweise 14155551234).
- Vorname (fn) und Nachname (ln): Kleinbuchstaben.
- Stadt (ct), Bundesland (st), Postleitzahl (zp), Land (country): Ausschliesslich Kleinbuchstaben, keine Leerzeichen.
- Externe Kennung (external_id): Deine interne Kundennummer, gehashed. Perfekt dafür geeignet, Wiederholungskäufer zu identifizieren.
- Click-ID (fbc) und Browser-ID (fbp): Auslesen aus den Browser-Cookies und bei jedem Server-Event weitergeben für präzisere Zuordnungen.
CAPI in Betrieb nehmen und prüfen
- Events Manager, Reiter Diagnostics. Sollte keine kritischen Warnungen anzeigen.
- Events Manager, Event Quality beziehungsweise Event Match Quality. Zielwert: 7 oder höher auf einer Skala von 10.
- Events Manager, Balkendiagramm für eingegangene Events. Überprüfe, dass sowohl der Browser-Balken als auch der Server-Balken Werte aufweisen.
- Test-Events durchführen Erstelle einen test_event_code, löse eine echte Konversion aus und beobachte in Echtzeit, wie sie eintrifft.
- Nach 7 Tagen: Vergleiche die zugeordneten Konversionen im Ads Manager vor und nach CAPI. Ein Anstieg um mindestens 20 Prozent bei zugeordneten Konversionen bestätigt, dass CAPI Daten zurückgewinnt.
CAPI ist nicht mehr optional. Wer 2026 nur mit Pixel-Tracking arbeitet, konkurriert mit Scheuklappen. Wähle den Implementierungsweg, der zu deinem System passt, dedupliciere richtig und validiere mit Event Match Quality. Zwei Tage Arbeit zahlen sich dauerhaft aus.
CAPI richtig implementieren lassen?
Die Tracking-Fachleute von Unled Network liefern vollständige Pixel- und CAPI-Implementierungen, Server-seitiges GTM, direkte API-Anbindung oder native Plattform-Integration, jeweils mit Deduplication und Advanced Matching optimiert für Event Match Quality 8+.
Kommentare
Haben Sie eine Frage oder eigene Erfahrung? Diskutieren Sie mit. Ihre E-Mail wird nie gezeigt oder weitergegeben.
Really helpful breakdown. Been looking for clear info on this topic.
Great question! This is something we see frequently with our clients. The key is consistency rather than a one-time fix.