Meta Conversions API für Affiliates: Setup & Deduplizierung
Wie die Meta Conversions API funktioniert, wenn die Conversion auf der Website eines Operators stattfindet: Postback an die CAPI, Fallen bei der Deduplizierung per event_id, Match-Qualität, Setup.

Die Meta Conversions API (CAPI) ist Metas Server-to-Server-Kanal für Conversion-Events. Ihr Tracker oder Server sendet eine Registrierung oder eine Einzahlung direkt an Meta, sodass die Optimierung nicht davon abhängt, dass ein Browser-Pixel auf einer Seite auslöst, die Sie kontrollieren. Für Affiliates, deren Conversions auf der Website eines Operators stattfinden, ist das oft der einzige Weg, sie zu melden.
Dieser Leitfaden behandelt genau diesen Fall: Ihnen gehören die Anzeige und die Landingpage, dem Operator gehören die Registrierung und der Kassenbereich, und die Conversion erreicht Sie als Postback.
Was ist die Meta Conversions API
Meta beschreibt die Conversions API als Verbindung zwischen den Marketingdaten eines Werbetreibenden und den Systemen von Meta. Die Daten können von einem Server, einer Website-Plattform, einer mobilen App oder einem CRM stammen und Website-Events, App-Events, Business-Messaging-Events und Offline-Conversions abdecken.
Früher hieß sie Facebook Conversions API, davor Server-Side API. „Facebook conversion API“, „conversion API Meta“ und „CAPI“ bezeichnen alle denselben Endpoint in Metas Marketing API.
Für die Einrichtung sind zwei Begriffe wichtig:
Dataset. Server-Events werden im Events Manager mit einer Dataset-ID verknüpft. Das Dataset enthält auch Ihr Meta Pixel, und Meta gibt vor, für Browser- und Server-Events dieselbe Pixel ID zu verwenden.
Offline-Events. Meta führt Offline-Conversions unter den Daten auf, die die Conversions API überträgt, daher ist die „Meta offline conversions API“ an derselben Stelle dokumentiert.
So funktioniert die CAPI für Affiliates
Ein Affiliate-Funnel läuft über zwei Domains, und nur eine davon gehört Ihnen, also leitet Ihr Tracker jede Conversion an Meta weiter:
Klick. Ein Nutzer klickt auf Ihre Anzeige. Meta hängt den Parameter
fbclidan die Landingpage-URL an.Der Tracker speichert den Klick. Er speichert seine eigene Click ID zusammen mit der
fbclid, der IP-Adresse des Besuchers, dem User Agent und dem Zeitstempel und übergibt die Click ID dann als Sub-ID an den Operator-Link.Conversion auf der Website des Operators. Der Spieler registriert sich und tätigt eine erste Einzahlung. Der Operator verbucht beides auf Ihre Sub-ID.
Postback. Das System des Operators ruft Ihren Tracker mit der Sub-ID und dem Event-Typ auf. Unser Leitfaden zum Postback-Tracking erklärt, wie dieser Aufruf aufgebaut ist.
Der Tracker ruft Meta auf. Der Tracker sucht den gespeicherten Klick, wandelt die
fbclidin den Wertfbcum, den Meta erwartet (ein Präfixfb., ein Subdomain-Index, ein Erstellungszeitstempel und diefbclid, durch Punkte verbunden), und sendet das Event mit Name, Zeit, ID und Nutzerdaten.Meta versucht das Matching. Meta sucht die Person, die die Anzeige gesehen oder angeklickt hat; gematchte Conversions erscheinen im Reporting und fließen in die Auslieferung ein.
Die Schwachstelle ist Schritt 2. Meta akzeptiert ein Event aus einem ohne fbclid gespeicherten Klick weiterhin, hat aber kaum etwas, womit es matchen kann, sofern Sie nicht zusätzlich Kontaktdaten senden.
Meta Pixel vs. Conversions API
Das Pixel läuft im Browser des Besuchers und meldet, was auf dieser Seite passiert. Die CAPI ist eine Anfrage, die Ihr eigenes System sendet, sobald es von einer Conversion erfährt, egal wo sie stattgefunden hat.
| Meta Pixel | Conversions API | |
|---|---|---|
| Wird ausgelöst | Im Browser, auf einer Seite, die Sie kontrollieren | In Ihrem Tracker oder auf Ihrem Server |
| Hauptfehlerquelle | Adblocker, Datenschutzgrenzen des Browsers, Einwilligungsentscheidungen | Verlorene Click IDs oder unvollständige Daten, die Sie senden |
| Registrierungen und Einzahlungen auf der Website des Operators | Unsichtbar | Über den Postback gemeldet |
| Besucherdaten | Cookies, IP und User Agent werden automatisch ergänzt | Nur was Sie senden, einschließlich IP und User Agent |
| Was Sie brauchen | Code oder ein Tag auf Ihren Seiten | Tracker-Integration und ein Access Token oder Metas Ein-Klick-Option für Web-Events |
| Deduplizierung | Allein nicht nötig | Nötig, wenn beide dasselbe Event melden |
Metas Best-Practices-Seite empfiehlt, die Conversions API zusätzlich zum Pixel zu betreiben und dieselben Events über beide zu teilen. Affiliates müssen das anpassen, weil das Pixel die Events, für die bezahlt wird, nicht sehen kann.
Meta Pixel oder Conversions API: Was brauchen Sie?
Die meisten iGaming-Affiliates brauchen beides: das Pixel für das Verhalten auf der Seite, die CAPI für Registrierungen und Einzahlungen. Entscheidend ist die Frage, wo die Conversion erfasst wird.
Auf der Website des Operators. Das betrifft den Großteil des Affiliate-Traffics für Casinos und Sportwetten. Das Pixel sieht nur Ihre Seiten, also optimieren Sie ohne CAPI auf Klicks nach außen, und Meta lernt, Menschen zu finden, die klicken, statt Menschen, die einzahlen.
Überwiegend iPhone- und Safari-Traffic. Datenschutzgrenzen des Browsers verkürzen die Lebensdauer von Cookies und begrenzen, wie viel ein Pixel melden kann, daher hat das Serversignal mehr Gewicht.
Hohes Volumen. Jedes fehlende Event ist Signal, das das Auslieferungssystem nie erhält, und die Auslieferung stützt sich auf dieses Signal, wie unser Leitfaden zu Meta Andromeda erklärt.
Ein kleiner Test mit einem eigenen Formular. Wird der Lead in einem Schritt auf Ihrer eigenen Seite erfasst, reicht für den Anfang das Pixel allein. Ergänzen Sie die CAPI, sobald sich der Test ein Budget verdient hat.
Ein Media Buyer, der iGaming-Angebote auf Meta schaltet, landet fast immer in der ersten Gruppe.
So richten Sie die Conversions API mit einem Tracker ein
Die Einrichtung mit einem Tracker läuft in vier Schritten: Dataset, Verbindungsmethode, Events und Token, dann Tracker-Einstellungen und ein Test-Event. Die Ansichten im Events Manager ändern sich, prüfen Sie sie also unterwegs.
1. Dataset auswählen oder erstellen
Sie brauchen eine Meta Business Suite und eine Pixel ID. Verbinden Sie im Events Manager eine Web-Datenquelle oder verwenden Sie das Dataset weiter, das bereits Ihr Pixel enthält. Verbinden Sie jedes Werbekonto, das auf diese Events optimieren soll, mit diesem Dataset.
2. Verbindungsmethode wählen
Metas Hilfebereich nennt drei Wege: eine Partnerintegration, eine von Meta aktivierte Option für Web-Events und die manuelle Einrichtung. Meta bietet außerdem ein Conversions API Gateway an, und manche Teams nutzen serverseitiges Tagging, etwa einen serverseitigen Google-Tag-Manager-Container.
Für einen Tracker, der Postbacks von Operatoren empfängt, passt die manuelle Einrichtung: Die Events entstehen aus Postbacks, also baut der Tracker die Anfragen selbst. Das Gateway, gehostet in einem Cloud-Konto, das Ihnen gehört, erhält seine Events über das Pixel aus Browsern, nicht aus dem Postback eines Operators. Ein serverseitiger Tag-Container könnte sie annehmen, würde aber die Arbeit des Trackers doppelt erledigen.
3. Events und Access Token
Wählen Sie nur Events, die Ihre Postbacks tatsächlich melden können. Ein gängiges Mapping ist CompleteRegistration für eine Registrierung und Purchase für eine erste Einzahlung.
Generieren Sie den Access Token im Events Manager unter der manuellen Einrichtung. Nur Personen mit Entwicklerrechten im Unternehmen sehen diesen Link. Meta erstellt dann für Sie eine Conversions-API-App und einen Systemnutzer, ohne App Review. Wenn Sie bereits eine eigene App betreiben, weisen Sie das Pixel in Business Suite einem vorhandenen Systemnutzer zu und generieren den Token dort.
Wer den Token besitzt, kann Events in Ihr Dataset senden. Bewahren Sie ihn in den Einstellungen des Trackers auf, niemals im Seitencode oder in einer geteilten Tabelle, und ersetzen Sie ihn, wenn jemand mit Zugriff ausscheidet.
4. Tracker-Seite und Test-Events
Tragen Sie Pixel ID und Token in die Meta-Integration des Trackers ein und ordnen Sie jedem Postback-Status einen Event-Namen zu. Prüfen Sie, dass der Tracker fbclid, IP und User Agent zum Klickzeitpunkt speichert und diese sendet statt der IP seines eigenen Servers.
Jedes Event braucht außerdem action_source, das Meta als Pflichtfeld kennzeichnet; für einen Web-Funnel ist der übliche Wert website. Mit der Nutzung der API erklären Sie, dass der Wert nach bestem Wissen zutrifft.
Setzen Sie für Website-Events event_source_url auf Ihre eigene Landingpage: Meta verlangt das und sagt, der Wert solle zu Ihrer verifizierten Domain passen, die URL des Operators gehört dort also nicht hin. Senden Sie dann eine Test-Conversion und prüfen Sie im Events Manager, dass sie ankommt, dedupliziert und gematcht wird.
Deduplizierung: So vermeiden Sie doppelt gezählte Events
Meta zählt ein Browser-Event und ein Server-Event als eine Conversion, wenn die eventID des Pixels der event_id des Servers entspricht und das Event des Pixels dem event_name. Rund um diesen Abgleich gilt:
48-Stunden-Fenster. Meta dedupliziert nur Events, die innerhalb von 48 Stunden eingehen; eine spätere Kopie mit derselben ID zählt erneut.
Das zuerst empfangene gewinnt. Wenn sich die beiden Kopien nicht wesentlich unterscheiden, behält Meta in der Regel diejenige, die zuerst eingegangen ist.
Eine zweite Methode. Meta gleicht auch über
event_nameplusfbpund/oderexternal_idab, wenn diese auf beiden Seiten konsistent verwendet werden. Das funktioniert in der Regel nur, wenn das Browser-Event zuerst gesendet wird; ein Server-Event ohne Browser-Event in den vorangegangenen 48 Stunden wird behalten.Eine Quelle, keine Deduplizierung. Meta dedupliziert keinen reinen Browser- oder reinen Server-Stream. Zwei identische Server-Events werden beide behalten.
Wo Affiliate-Setups scheitern:
Ein Name, zwei Aktionen. Das Pixel feuert
Lead, wenn ein Besucher zum Operator klickt, und der Tracker sendetLeadfür Registrierungen. Meta lernt nun aus zwei verschiedenen Aktionen unter einem Label. Geben Sie jeder Aktion einen eigenen Namen.IDs, die nie zusammenfinden. Die Seite erzeugt eine
event_idund der Tracker eine andere. Die Deduplizierung braucht auf beiden Seiten denselben Event-Namen und dieselbe ID; eine Abweichung bei einem von beiden hinterlässt zwei Events. Wenn eine Aktion wirklich an beiden Stellen auslöst, erzeugen Sie die ID einmal, beim Klick oder auf der Seite, und übergeben Sie genau diesen Wert an das Pixel und an den Postback.Späte Postbacks. Einzahlungen werden oft erst Tage nach dem Klick bestätigt. Ein Postback, der nach mehr als 48 Stunden eintrifft, kann nicht mehr mit einem früheren Browser-Event zusammengeführt werden, also zählen beide. Halten Sie Events auf Einzahlungsebene rein serverseitig.
Wiederholte Postbacks. Operatoren senden Postbacks erneut oder schicken Status-Updates für denselben Spieler. Reine Server-Duplikate werden behalten, also muss der Tracker jeden Event-Typ pro Klick einmal senden.
Veraltete Events.
event_timedarf höchstens sieben Tage zurückliegen. Ist ein Event in einer Anfrage älter, gibt Meta für die gesamte Anfrage einen Fehler zurück und verarbeitet nichts davon; senden Sie Events also, sobald sie eintreffen, statt einen Rückstau gebündelt nachzuschicken.
Der Ads Manager zählt Conversions nach Ihrer Attributionseinstellung, daher wird er nie exakt mit einer Postback-Zählung übereinstimmen. Unter Berücksichtigung dessen vergleichen Sie Registrierungen und Einzahlungen pro Kampagne über dieselben wenigen Tage: Ein dauerhafter Überschuss bei Meta deutet auf Duplikate hin, ein dauerhaftes Defizit auf abgelehnte oder nicht gematchte Events. Aufgeblähte oder erfundene Events verfälschen die Optimierung und gefährden das Werbekonto, und Operatoren suchen nach denselben Mustern, wie in Affiliate-Betrug im iGaming beschrieben.
Metas Ein-Klick-CAPI und Tracker-Postbacks
Laut Metas Dokumentation können Sie, wenn Sie ein Pixel haben, die Conversions API mit Meta für Website-Events mit einem Klick einrichten, ohne Code, Konfiguration oder Einrichtungsgebühren. Sie baut auf Ihrem Pixel auf und deckt nur Website-Events ab. Für einen Shop mit eigenem Checkout ist das der gesamte Funnel; für einen Affiliate ist es die Landingpage, und Registrierungen und Einzahlungen auf der Domain des Operators kommen weiterhin nur über Tracker-Postbacks.
Das Risiko ist die Überschneidung. Meta führt Events nur nach den oben genannten Regeln zusammen, daher wird ein Tracker-Event mit eigener event_id nicht mit einer Pixel-basierten Kopie derselben Aktion zusammengeführt. Bevor Sie sie neben einer Tracker-Integration aktivieren, geben Sie jeder Aktion einen Namen und eine gemeinsame ID und vergleichen Sie dann einige Tage lang den Tracker mit dem Ads Manager.
Event Match Quality
Event Match Quality (EMQ) ist ein Score von maximal 10 Punkten, den Meta im Events Manager pro Event anzeigt. Er gibt an, wie nützlich die Kundeninformationen Ihrer Server-Events für das Matching sind, und deckt derzeit nur Web-Events ab. Laut Meta kann das Senden zusätzlicher Kundeninformationsparameter ihn erhöhen; als Beispiele nennt Meta E-Mail, IP-Adresse, Name und Telefonnummer.
Für einen Affiliate sind diese Parameter nutzbar:
fbc, gebildet aus der gespeichertenfbclid. Der Schlüssel, der am direktesten mit dem Anzeigenklick verbunden ist.fbp, das Browser-Cookie des Pixels, sofern Ihre Landingpage es setzt und der Tracker es erfasst.IP-Adresse und User Agent aus dem Klick. Der User Agent ist für Website-Events Pflicht.
E-Mail und Telefonnummer, nur wenn der Operator sie übermittelt und Ihre Bedingungen es erlauben.
Metas Seite zu den Kundeninformationsparametern legt die Regeln für den Umgang fest. Normalisieren Sie Kontaktdaten (E-Mail ohne Leerzeichen am Rand und in Kleinbuchstaben, Telefonnummer als Ziffern mit Ländervorwahl) und hashen Sie sie dann mit SHA-256. IP, User Agent, fbc und fbp werden ungehasht gesendet. Gehashte Kontaktdaten bleiben personenbezogene Daten, senden Sie also nur, was Ihre Datenschutzerklärung und die Programmbedingungen Ihnen weiterzugeben erlauben.
Glücksspielwerbung: Was die CAPI nicht ändert
Metas Richtlinie Online Gambling and Games erlaubt Glücksspiel- und Gaming-Anzeigen nur, wenn das Werbekonto Metas Autorisierung hat. Das umfasst auch Anzeigen, deren Landingpages für Glücksspiel werben, ohne es anzubieten, und die Richtlinie nennt Affiliate- und Aggregator-Seiten als Beispiele.
Werbetreibende beantragen die Autorisierung im Tab Authorizations and Verifications der Meta Business Suite, mit Nachweisen, dass die Tätigkeit dort, wo sie ihre Anzeigen ausrichten wollen, lizenziert oder anderweitig rechtmäßig ist. Bevor sie erstmals eine neue Rechtsordnung ansprechen, müssen sie diese Absicht erklären. Autorisierte Anzeigen dürfen weder Personen unter 18 noch die Märkte ansprechen, die Meta als nicht unterstützt aufführt. Bei US-Kampagnen hängt die Rechtslage vom Bundesstaat ab, wie unser Überblick zu Online-Glücksspiel in den USA zeigt.
Serverseitiges Tracking misst Ergebnisse; es autorisiert keine Anzeigen. Dies ist eine Zusammenfassung von Metas veröffentlichter Richtlinie mit Stand Oktober 2026, keine Rechtsberatung.
Checkliste vor dem Launch
Prüfen Sie vor dem Launch, dass jedes Event Meta einmal erreicht, mit Klickdaten, eigenem Namen und gemeinsamer ID:
Jedes optimierende Werbekonto ist mit dem Dataset verbunden.
Der Token liegt nur im Tracker.
Jedes Event enthält
fbc, IP und User Agent aus dem Klick sowieaction_source.Jede Aktion hat ihren eigenen Event-Namen. Wo Pixel und Tracker sie beide melden, senden sie denselben Namen und dieselbe
event_id.Der Tracker sendet ein Event pro Typ und Klick, in Echtzeit.
event_source_urlzeigt auf Ihre Landingpage-Domain.Ein Test-Event ist angekommen und wurde gematcht, und ein regelmäßiger Abgleich zwischen Tracker und Ads Manager ist eingeplant.
Häufige Fragen
Was ist die Meta Conversions API (CAPI)?
Die Conversions API ist Metas API, um Conversion-Events aus Ihren eigenen Systemen, etwa einem Server, Tracker oder CRM, direkt an Meta zu senden. Die Facebook Conversions API ist dasselbe Produkt unter seinem früheren Namen.
Wie tracken Sie Conversions von Meta-Anzeigen ohne Pixel auf dem Angebot?
Ihr Tracker speichert die fbclid jedes Anzeigenklicks, übergibt Ihre Click ID als Sub-ID an den Operator und leitet den Postback des Operators mit den gespeicherten Klickdaten an die Conversions API weiter.
Kann ich nur die CAPI ohne das Pixel nutzen?
Die CAPI funktioniert ohne das Pixel, und bei Events auf Operator-Seite machen Sie es ohnehin so. Behalten Sie das Pixel trotzdem auf Ihrer Landingpage: Ohne es gibt es kein Cookie fbp, das Ihre Server-Events als Match-Schlüssel mitführen könnten, und Meta rät, beides zu betreiben.
Hat Meta eine API, und ist die Conversions API kostenlos?
Ja: Die Conversions API ist Teil von Metas Marketing API. Meta beschreibt die Ein-Klick-Option als frei von Einrichtungsgebühren. Eine direkte Integration kostet, was Ihr Tracker, Ihr Server oder Ihr Partner-Tool kostet.
Was passiert, wenn ich die Ein-Klick-CAPI zusätzlich zu Tracker-Postbacks aktiviere?
Die Ein-Klick-CAPI deckt Website-Events ab, die an Ihr Pixel gebunden sind, nicht Conversions auf der Website des Operators. Doppelzählungen entstehen, wenn Pixel und Tracker dieselbe Aktion unter unterschiedlichen IDs oder Namen melden; gleichen Sie diese zuerst an und vergleichen Sie dann den Tracker mit dem Ads Manager.
Was ist Event Match Quality und warum ist sie wichtig?
Event Match Quality ist Metas Score von maximal 10 Punkten dafür, wie gut sich die Kundendaten Ihrer Server-Events Personen zuordnen lassen. Events, die sich nicht zuordnen lassen, haben in Reporting und Optimierung wenig Gewicht.
Quellen
Meta, Conversions API overview
Meta, Server event parameters
Meta, Conversions API Gateway
Meta Business Help Center, Set up and install the Meta Pixel
Meta Transparency Center, Online Gambling and Games (checked October 28, 2026)
Meta Business Help Center, Apply for permission to promote online gaming or gambling



