Wat is de Meta Conversions API, en heb je hem nodig?
De Meta Conversions API (CAPI) stuurt conversie-events naar Meta vanaf je server, je websiteplatform, je app of je CRM, in plaats van alleen te leunen op de browser van de bezoeker zoals de Meta-pixel.
Lees het hele antwoord
Meta raadt aan beide te gebruiken, een opzet die Meta redundant noemt: de pixel en de Conversions API delen dezelfde events, en de Conversions API kan website-events opvangen die de pixel kan missen door netwerkproblemen of laadfouten van de pagina. Om een aankoop niet dubbel te tellen, geef je de browser- en de serverkopie dezelfde eventnaam en dezelfde event-ID; Meta houdt er één over als beide binnen 48 uur binnenkomen. De kwaliteit van gebeurtenismatches (Event Match Quality), een score van 1 tot 10, laat zien hoe goed de klantgegevens die je stuurt events koppelen aan Meta-accounts. Je kunt de Conversions API instellen via een partner zoals Shopify in een paar klikken, met de Conversions API Gateway zonder code, of via een directe integratie die een developer bouwt.
Hoe maakt Meta van twee kopieën van een aankoop er één?
Dezelfde aankoop komt twee keer bij Meta binnen: één keer vanuit de browser, één keer vanaf je server. Meta telt hem één keer als de naam en de ID overeenkomen.
Browser · Meta Pixel
event"Purchase"eventID"order-1042"
Server · Conversions API
event_name"Purchase"event_id"order-1042"
1 aankoop geteld
Wat is de Meta Conversions API?
De Meta Conversions API is een directe verbinding tussen je marketingdata en de advertentiesystemen van Meta. In plaats van alleen te leunen op code in de browser van de bezoeker, stuurt hij events zoals aankopen, leads of toevoegingen aan de winkelwagen vanaf je server, je websiteplatform, je app of je CRM, zodat Meta je advertenties kan meten en optimaliseren.
Lees verder
Meta presenteert hem als een manier om de targeting van advertenties te optimaliseren, de kosten per resultaat te verlagen en resultaten te meten over al zijn technologieën. Eén API vervoert website-events, app-events, offline conversies en messaging-events. Je ziet hem afgekort als CAPI, en vaak heet hij de Facebook Conversions API.
Meta meldt ook dat de Offline Conversions API in mei 2025 is stopgezet: offline events lopen nu via de Conversions API, in datasets.
Waarom de Conversions API naast de pixel gebruiken?
Omdat de pixel op zichzelf events mist. Volgens de best practices van Meta kan de Conversions API website-events opvangen die de pixel kan missen door netwerkproblemen of laadfouten van de pagina. Meta raadt een redundante opzet aan: stuur dezelfde events, zoals aankoop, start van de checkout of contact, via de pixel én via de Conversions API.
Lees verder
Meta geeft zelfs een doel voor die pariteit: mik op een eventdekking van 75% van Conversions API-events ten opzichte van events van de Meta-pixel. Die verhouding volg je in Gebeurtenisbeheer (Events Manager).
Meta vraagt ook om events in realtime te delen, of zo dicht mogelijk bij realtime, zodat het leveringssysteem kan inschatten wie waarschijnlijk in actie komt na het zien van een advertentie.
Hoe werkt deduplicatie met event_id?
Als pixel en Conversions API dezelfde aankoop melden, moet Meta weten dat het één aankoop is, niet twee. Meta vergelijkt twee velden: de eventID van de pixel moet overeenkomen met de event_id van de Conversions API, en het event van de pixel met de event_name. Komen beide overeen, dan houdt Meta één event over en gooit het duplicaat weg.
Lees verder
Meta dedupliceert alleen events die binnen 48 uur na het eerste binnenkomen, en houdt meestal het event dat het eerst ontving.
Meta beschrijft een tweede methode, waarbij beide bronnen dezelfde waarden voor fbp of external_id sturen, maar die werkt alleen als het browser-event vóór het server-event aankomt. Meta raadt de methode met event-ID en eventnaam aan.
Duplicaten die erdoor glippen blazen de gerapporteerde conversies op, en je ROAS erbij. Als je cijfers te mooi lijken, of plots dalen, lees je Meta-rapport regel voor regel.
Wat is de kwaliteit van gebeurtenismatches (Event Match Quality)?
De kwaliteit van gebeurtenismatches is een score van 1 tot 10 die laat zien hoe goed de klantgegevens die je met je server-events meestuurt die events koppelen aan Meta-accounts. Meta berekent hem uit de kwaliteit van die gegevens en het aandeel gekoppelde events, op basis van de data van de laatste 48 uur, dus events moeten regelmatig binnenkomen.
Lees verder
Hij geldt voor website-events die via de Conversions API worden gestuurd met de actiebron ingesteld op Website. Volgens Meta helpt betere matching om advertenties te tonen aan mensen die eerder converteren en om conversies aan je advertenties toe te schrijven, en kan het de gerapporteerde extra conversies verhogen.
Om hem te verhogen, stuur je meer parameters met klantgegevens, gehasht zoals de ontwikkelaarsdocumentatie van Meta uitlegt, en alleen met de wettelijk vereiste machtigingen en toestemmingen. Meta rangschikt hun prioriteit:
- Hoog: e-mail en klik-ID.
- Gemiddeld: Facebook Login-ID, geboortedatum, land, telefoonnummer, externe ID en browser-ID.
- Laag: lead-ID, voornaam, achternaam, stad en postcode.
Hoe stel je de Conversions API in?
Meta noemt meerdere routes en zegt dat je voor veel ervan geen developer nodig hebt. De juiste hangt af van waar je site draait en wie hem onderhoudt: een partner voor commerceplatforms, de door Meta ingeschakelde Conversions API met één klik, de Conversions API Gateway zonder code, of een directe integratie die tegen de API wordt geprogrammeerd.
Lees verder
- Partnerintegraties. Op Shopify, WooCommerce, Wix of BigCommerce kost het instellen volgens Meta een paar klikken, zonder extra kosten. Adobe, Google Tag Manager, Tealium en andere partners kunnen hem ook koppelen.
- Door Meta ingeschakelde Conversions API. Een optie alleen voor websites die de server-side verbinding met één klik gratis maakt en dezelfde events en parameters stuurt als je pixel, automatisch gededupliceerd.
- Conversions API Gateway. Een opzet zonder code die je kiest in Gebeurtenisbeheer, gehost in je eigen AWS- of Google Cloud-account. Volgens Meta brengt hij het instellen terug van weken naar minder dan 30 minuten en dedupliceert hij automatisch; de cloudkosten, zijn enige kosten, beginnen bij $30 per maand.
- Directe integratie. Een developer stuurt je events naar de API. Meta rekent op 2 tot 4 weken voor een nieuwe integratie, en het is de enige optie voor events uit apps en fysieke winkels.
Meta raadt de Gateway aan als je de pixel al gebruikt, nog geen web-events via de Conversions API stuurt, meer dan $ 300 per maand uitgeeft aan campagnes die geoptimaliseerd zijn voor web-events, en niet met een e-commercepartner werkt. Beheert een partner zoals Shopify je pixel al, dan raadt Meta de integratie van die partner aan.
| Optie | Wie het instelt | Kosten | Events | Deduplicatie |
|---|---|---|---|---|
| Commercepartner (Shopify, WooCommerce…) | Jij, in een paar klikken | Geen extra kosten | Hangt af van de partner | Hangt af van de partner |
| Door Meta ingeschakelde Conversions API | Jij, met één klik | Gratis | Alleen web | Automatisch |
| Conversions API Gateway | Jij, zonder code | Cloudkosten, vanaf $ 30 per maand | Web | Automatisch |
| Directe integratie | Een developer, 2 tot 4 weken | Je eigen ontwikkeling en onderhoud | Web, app, offline, CRM, messaging | Jij stuurt event_id |
Kosten en doorlooptijden zijn de eigen cijfers van Meta. De cloudkosten van de Gateway variëren met je regio en je verkeer.
Hoe controleer je in Gebeurtenisbeheer of de Conversions API werkt?
Open Gebeurtenisbeheer, ga naar Data Sources, kies de pixel waarnaar je server-events stuurt en klik op Overview. Volgens Meta zou je server-events binnen 20 minuten na verzending moeten kunnen controleren. Overview telt de events die Meta heeft ontvangen en toont onder Connection Method via welk kanaal elk event is verstuurd. Klik op een event voor details.
Lees verder
Voordat je op live data vertrouwt, gebruik je de tool Test Events: Gebeurtenisbeheer > Data Sources > je pixel > Test Events. Die maakt een test-ID die je met je server-events meestuurt in de parameter test_event_code; die events verschijnen dan in het venster Test Events. Meta noemt drie toepassingen: bevestigen dat je server-events goed zijn ingesteld en aankomen, de deduplicatie controleren door te zien welke events zijn verwerkt en welke gededupliceerd, en ongewone activiteit debuggen.
Meta geeft twee waarschuwingen. Haal test_event_code weg als je klaar bent met testen: events die ermee worden verstuurd, worden niet weggegooid, ze komen in Gebeurtenisbeheer terecht en worden gebruikt voor targeting en advertentiemeting. En test met je eigen klantgegevens, zoals je naam, e-mail of telefoonnummer, want test-events kunnen worden geweigerd als ze niet bij een Facebook- of Meta-account passen.
Om deduplicatie in je live data te zien, open je vanuit Overview de Event Details van een eventtype en ga je naar het tabblad Event Deduplication. Het toont het percentage gededupliceerde events per bron, waarbij hoger volgens Meta beter is en er een waarschuwing verschijnt als het te laag is, en het gebruikspercentage van de deduplicatiesleutels. Een lage Overlap betekent volgens Meta dat een of beide bronnen geen unieke sleutels sturen, of dat maar één bron een sleutel stuurt.
Dezelfde pagina Event Details heeft een tabblad Event Freshness, met de gemiddelde vertraging tussen een event en de verzending ervan, op een schaal van Real Time tot Weekly. Meta raadt aan events zo dicht mogelijk bij realtime te delen.
Welke gegevens stuurt de Conversions API, en wat moet je hashen?
Elk server-event bevat het event zelf, zoals de naam, het tijdstip, de bron-URL en de actiebron, plus parameters met klantgegevens die Meta helpen het aan een account te koppelen. Contactgegevens moeten worden genormaliseerd en daarna met SHA-256 gehasht: volgens Meta zijn de systemen zo ontworpen dat ze ongehashte contactgegevens niet accepteren, die Meta alleen gebruikt om te matchen. Met de Meta Business SDK gebeurt het hashen automatisch.
Lees verder
Eerst komt het normaliseren, zoals Meta’s pagina Customer Information Parameters beschrijft. E-mail: spaties aan begin en eind weghalen en alles in kleine letters. Telefoonnummer: symbolen, letters en voorloopnullen weghalen en altijd de landcode toevoegen. Land: de ISO 3166-1-code van twee letters in kleine letters, zoals nl.
Meta deelt de parameters in drie groepen in:
- Hashen met SHA-256: e-mail, telefoonnummer, voornaam, achternaam, geboortedatum, geslacht, stad, staat of provincie, postcode en land.
- Hashen aanbevolen: externe ID, je eigen klant-ID, zoals een klantenkaart- of gebruikers-ID.
- Nooit hashen: IP-adres van de klant, user agent van de klant, klik-ID (
fbc), browser-ID (fbp), abonnements-ID, Facebook Login-ID en lead-ID.
IP-adres en user agent worden automatisch toegevoegd aan browser-events, maar volgens Meta moet je ze bij server-events zelf invullen, en de user agent is verplicht voor website-events. De waarden fbc en fbp komen uit first-party cookies die de pixel op je domein plaatst, en Meta vraagt ze regelmatig te vernieuwen als je ze verstuurt.
Hashen vervangt geen toestemming. Als je regelt wat je pixel deelt op basis van toestemming, vraagt Meta dezelfde logica toe te passen op de Conversions API. Voor gebruikers in de Verenigde Staten documenteert Meta opties voor gegevensverwerking, toe te voegen in elk event, om Limited Data Use aan te zetten.
Wat lees je hierna?
Schone events zijn alleen de input. Wat daarna telt, is de resultaten lezen die ze opleveren.
