Adwize

Meta-trackinggids 2026

De Meta Conversions API, uitgelegd.
Wat hij verstuurt, waarom hij bij de pixel hoort, hoe je hem instelt.

Wat de Conversions API (CAPI) is, hoe deduplicatie met event_id en de kwaliteit van gebeurtenismatches werken, en de vier manieren die Meta biedt om hem in te stellen. Gecheckt in de documentatie van Meta.

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.

Voorbeeld

Browser · Meta Pixel

event
"Purchase"
eventID
"order-1042"

Server · Conversions API

event_name
"Purchase"
event_id
"order-1042"

1 aankoop geteld

Dezelfde eventnaam en dezelfde event-ID, binnen 48 uur ontvangen: Meta houdt de eerste.

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.

Opties om de Conversions API in te stellen, zoals Meta ze vergelijkt
OptieWie het insteltKostenEventsDeduplicatie
Commercepartner (Shopify, WooCommerce…)Jij, in een paar klikkenGeen extra kostenHangt af van de partnerHangt af van de partner
Door Meta ingeschakelde Conversions APIJij, met één klikGratisAlleen webAutomatisch
Conversions API GatewayJij, zonder codeCloudkosten, vanaf $ 30 per maandWebAutomatisch
Directe integratieEen developer, 2 tot 4 wekenJe eigen ontwikkeling en onderhoudWeb, app, offline, CRM, messagingJij 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.

Adwize leest de resultaten die je events opleveren

Adwize stelt de Conversions API niet in. Zodra je events bij Meta aankomen, leest Adwize je campagneresultaten, schrijft rapporten in gewone taal en signaleert wat afwijkt. Er verandert niets tot jij het goedkeurt.

Vragen over de Meta Conversions API

Twijfel je nog? Mail ons. Een echt mens antwoordt.

Meta raadt aan beide te houden. De best practices van Meta beschrijven een redundante opzet waarin de pixel en de Conversions API dezelfde events delen, omdat de Conversions API events kan opvangen die de pixel mist door netwerkproblemen of laadfouten van de pagina. Deduplicatie houdt daarna één kopie van elk event over.

Bronnen

Elk feit op deze pagina komt uit het helpcentrum van Meta en van Meta for Developers. De pagina is voor het laatst gecontroleerd op 11 oktober 2026; bij elke bron staat de datum waarop we die volledig hebben gelezen. Als Meta een regel of een cijfer wijzigt, verandert de pagina mee.

  1. Meta Business Helpcentrum: About Conversions API
  2. Meta Business Helpcentrum: Compare Conversions API setup options
  3. Meta Business Helpcentrum: Best practices for Conversions API
  4. Meta Business Helpcentrum: About event match quality
  5. Meta Business Helpcentrum: About Conversions API Gateway
  6. Meta for Developers: Handling Duplicate Pixel and Conversions API Events
  7. Meta for Developers: Conversions API Gateway
  8. Meta for Developers: Verifying Your Setup
  9. Meta for Developers: Using the API
  10. Meta for Developers: Best Practices for the Conversions API
  11. Meta for Developers: Customer Information Parameters
  12. Meta for Developers: End-to-End Implementation of the Conversions API

Meta Ads, makkelijk gemaakt

Lanceer je volgende campagne in 2 minuten.

Meta Ads