Data & Tracking
Meta Conversions API: zo zet je CAPI correct op naast je Pixel
Kopieer voor AI
De Meta Conversions API (CAPI) stuurt conversies vanaf je server rechtstreeks naar Meta.
Het is een server-naar-server-koppeling. Een lead, een demo-aanvraag of een aankoop vertrekt dan vanaf je server of CRM, niet alleen vanuit de browser.
Ons oordeel: zet CAPI altijd naast de Meta Pixel, nooit in de plaats ervan. Geef elk event hetzelfde ID in browser en server, en test het in Events Manager.
Zo leert Meta Ads op meer en betere conversiedata dan de browser alleen doorgeeft.
Deze gids gaat over de serverkant: hoe je CAPI kiest, opzet, ontdubbelt en controleert.
Wat doet de Meta Conversions API precies?
Hij verbindt je eigen marketingdata met de systemen waarmee Meta advertenties optimaliseert.
Volgens de documentatie van Meta komt die data van je server, je websiteplatform, een app of je CRM.
Server-events worden gebruikt voor meting, rapportage en optimalisatie, net zoals Pixel-events.
Het verschil zit in de route
De Pixel draait in de browser van je bezoeker. Daar spelen:
- adblockers
- de trackingbeperkingen van Safari
- scripts die niet of te laat laden
CAPI vertrekt vanaf jouw kant: je eigen server, je server-side tagging-container of je CRM.
Drie gevolgen voor B2B
Dat heeft drie gevolgen die voor B2B tellen:
- Minder gemiste leads. Een formulier dat de browser niet doorgeeft, kan je server nog wel melden.
- Conversies buiten de website. Een lead die drie weken later een gekwalificeerde opportunity wordt in je CRM, kun je als event terugsturen.
- Controle over wat je deelt. Je bepaalt zelf welke velden vertrekken, gehasht en wel.
Dat laatste maakt CAPI ook een onderdeel van je first party data-aanpak.
Welke opzet kies je: partner, Gateway of server-side GTM?
Voor de meeste B2B-bedrijven: server-side Google Tag Manager, met een CRM-route voor late conversies.
Meta noemt drie manieren om CAPI te koppelen:
- een partnerintegratie
- de Conversions API Gateway
- een directe integratie
In de praktijk zien we bij Belgische en Nederlandse bedrijven vier varianten:
| Opzet | Hoe het werkt | Past bij | Let op |
|---|---|---|---|
| Partnerintegratie | Je CMS of shop (Shopify, WooCommerce-plug-in) stuurt events zelf door | Webshops met een standaardplatform | Weinig controle over eventnamen en deduplicatie |
| Conversions API Gateway | Een door Meta beheerde server in je eigen cloudomgeving | Teams zonder eigen tagging-server | Alleen Meta, geen andere platformen |
| Server-side Google Tag Manager | Je GTM-servercontainer stuurt events naar Meta, LinkedIn, Google Ads | B2B met meerdere advertentiekanalen | Vraagt hosting en een schone data layer |
| Directe integratie vanuit je CRM | Je CRM of backend roept de API aan | Offline en late conversies (SQL, deal) | Ontwikkelwerk en onderhoud |
Waarom server-side GTM de logische basis is
Adverteer je ook op Google Ads en LinkedIn? Dan is server-side GTM de logische basis.
Je bouwt één server-side laag en voedt daar alle platformen mee.
Hoe die laag werkt, lees je in onze gids over server-side tracking. De basis van Google Tag Manager zelf staat in een aparte gids.
Late conversies via je CRM
Wordt een lead pas na een salesgesprek gekwalificeerd? Dan komt de CRM-route erbij.
Let daarbij op de tijdslimiet. In de parameterdocumentatie van Meta staat dat event_time tot 7 dagen in het verleden mag liggen.
Is één event in een request ouder dan 7 dagen, dan geeft Meta een fout voor de volledige request en verwerkt het geen enkel event.
Gevolg: een deal die na 6 weken sluit, stuur je niet meer als website-event door.
Hoe snel moet je events sturen?
Zo snel mogelijk. Meta raadt aan om elk event te sturen zodra het gebeurt, idealiter binnen 1 uur (Meta over de API).
Nog drie getallen uit dezelfde documentatie:
- Batch: maximaal 1.000 events per request.
- Offline en fysieke winkel: uploaden binnen 62 dagen na de conversie.
- Website-events: event_time maximaal 7 dagen terug.
Hoe zet je de Meta Conversions API op, stap voor stap?
In zeven stappen, van conversies kiezen tot testen.
Dit is de volgorde die we bij elke opzet volgen.
Stap 1: Breng je conversies in kaart
Welke events tellen echt? Voor B2B is dat meestal:
- Lead voor een formulier
- Schedule of een custom event voor een geboekte demo
- eventueel CompleteRegistration voor een webinar
Een paginaweergave is geen conversie.
Stap 2: Zorg voor een data layer
Elk formulier pusht een event met dezelfde naam en een uniek event-ID in de data layer.
Zonder dat ID kan Meta niet ontdubbelen.
Hoe je formulieren zonder bedankpagina betrouwbaar meet, staat in onze gids over formulierconversies zonder bedankpagina.
Stap 3: Stuur hetzelfde event via de Pixel
De Pixel-tag krijgt het event-ID mee als eventID.
Stap 4: Stuur hetzelfde event via de server
In je server-side container of integratie gaat het event naar CAPI met deze velden:
- event_name, event_time en event_id
- action_source website
- event_source_url
- de klantgegevens
Stap 5: Voeg klantgegevens toe
Meta koppelt een event aan een persoon via klantgegevens. Denk aan:
- een gehasht e-mailadres (em)
- een gehasht telefoonnummer (ph)
- de fbp- en fbc-waarden
- het IP-adres en de user agent van de bezoeker
Meta vereist client_user_agent voor website-events. Contactgegevens hash je met SHA-256; fbp, fbc, IP en user agent hash je niet (Meta over klantparameters).
Stap 6: Respecteer toestemming
De server-side tag vuurt alleen als de bezoeker toestemming gaf voor marketing.
Daarover meer verder in dit artikel.
Stap 7: Test en controleer
Gebruik de testeventscode in Events Manager voor je live gaat.
Let op: haal die code weg in productie. Volgens Meta worden testevents niet weggegooid: ze komen in Events Manager terecht en tellen mee voor targeting en meting.
Volg daarna de deduplicatie en de matchkwaliteit op.
Hoe werkt deduplicatie tussen Pixel en CAPI?
Meta telt een event één keer als browser en server hetzelfde ID en dezelfde naam meesturen, binnen 48 uur.
Stuur je hetzelfde event via browser en server, dan ontvangt Meta het twee keer. Deduplicatie zorgt dat het maar één keer telt.
De vier regels
De regels staan in de deduplicatiegids van Meta:
- het eventID van de Pixel is gelijk aan het event_id van CAPI
- de eventnaam van de Pixel is gelijk aan event_name in CAPI
- het tweede event komt binnen 48 uur na het eerste met dat ID
- Meta houdt meestal het event dat eerst binnenkwam
Zo ziet dat er in de praktijk uit:
Waar maak je het ID aan?
Het ID maak je in de browser aan, op het moment dat het formulier verstuurd wordt.
Je geeft het via de data layer door aan zowel de Pixel-tag als de server-side tag.
Let op: een timestamp alleen is geen goed ID. Twee leads in dezelfde seconde krijgen dan hetzelfde nummer.
De alternatieve methode
Meta beschrijft ook een methode met event_name plus fbp of external_id.
Die werkt, maar is minder voorspelbaar. Wij gebruiken altijd een expliciet event-ID.
De twee termijnen naast elkaar
Twee termijnen uit de documentatie van Meta bepalen je opzet:
Welke fouten zien we het vaakst bij CAPI?
Dubbel tellen, ontbrekende klantgegevens en toestemming die omzeild wordt.
In accounts die we nalopen, komen telkens dezelfde problemen terug.
Fouten in de opzet
Drie fouten zitten in de techniek:
- Dubbel tellen. Pixel en CAPI sturen hetzelfde event zonder gedeeld ID.
- Twee bronnen voor hetzelfde event. De Shopify- of WordPress-plug-in stuurt CAPI-events én je server-side container doet het ook.
- Geen klantgegevens. CAPI-events zonder e-mail, fbp of fbc kan Meta slecht aan een persoon koppelen.
Bij dubbel tellen verdubbelt het aantal leads in Ads Manager. De kost per lead halveert op papier, en het algoritme leert op een vertekend beeld.
Vuistregel: één bron per event, niet twee.
Fouten in de data
Drie andere fouten zitten in wat je meestuurt:
- Ongehashte of verkeerd gehashte velden. Een e-mailadres met hoofdletters of spaties geeft een andere hash.
- Elke formulierklik als Lead. Ook nieuwsbriefinschrijvingen en sollicitaties komen dan als lead binnen.
- Toestemming omzeilen. “Het is server-side, dus de cookiebanner telt niet” is een misverstand.
Normaliseer dus eerst (kleine letters, spaties weg) en hash daarna.
Telt alles als Lead, dan optimaliseert Meta op de goedkoopste lead, niet op de beste. Dat lijkt sterk op wat we beschrijven in valse positieve conversies opschonen.
Hoe test je of de Conversions API werkt?
Met vijf controles, van Test Events tot een vergelijking met je CRM.
Controleer in deze volgorde:
- Test Events in Events Manager. Vul je testeventscode in je server-side tag in, verstuur een testformulier en kijk of het event via browser én server binnenkomt.
- Deduplicatie. In het overzicht van je dataset zie je per event of browser- en server-events ontdubbeld worden.
- Matchkwaliteit. Events Manager toont per event een score voor de kwaliteit van de klantgegevens.
- Preview in GTM. In de preview van je web- en servercontainer zie je of het event-ID in beide tags hetzelfde is.
- CRM-vergelijking. Leg het aantal Meta-leads per week naast het aantal leads uit Meta in je CRM.
In Events Manager ziet de testomgeving er zo uit:
Wat de uitkomsten betekenen
Drie signalen om op te letten:
- Twee losse events: het ID of de eventnaam klopt niet.
- Lage matchscore: kijk of e-mail, fbp en fbc meegaan.
- Groot verschil met je CRM: dubbels of gemiste events.
Een volledige check van je meting, inclusief Google Ads en GA4, doen we in een tracking-audit.
Wil je zelf beginnen? Gebruik dan onze checklist voor een conversietracking-audit.
Mag je CAPI gebruiken zonder cookietoestemming?
Nee, niet voor marketing.
De Belgische Gegevensbeschermingsautoriteit stelt dat geen cookie of andere tracker geplaatst of gelezen mag worden zonder voorafgaande informatie en toestemming. Alleen wat strikt noodzakelijk is, valt daarbuiten.
In Nederland hanteert de Autoriteit Persoonsgegevens dezelfde lijn.
Server-side verandert het doel niet
Dat de data via je server loopt, verandert niets aan het doel: advertentiemeting en targeting.
Laat je server-side tag dus afhangen van dezelfde toestemming als je Pixel.
Wat CAPI wel oplost
CAPI herstelt de verliezen die niet door weigering komen:
- adblockers
- browserbeperkingen
- scripts die te laat laden
Hoe je je banner en Google-signalen goed inricht, lees je in onze gids over Consent Mode v2 en in is een cookiebanner verplicht in België.
Hoe stuur je CRM-data terug naar Meta?
Door fbc, fbp en een gehasht e-mailadres bij de lead te bewaren en een diepere CRM-fase als event terug te sturen.
Voor B2B is de echte winst niet het formulier, maar wat erna gebeurt.
Een lead die nooit opneemt, is voor Meta even waardevol als een lead die klant wordt. Tenzij je het verschil terugstuurt.
Vier stappen
- Bewaar bij elke lead de fbc-waarde (afgeleid van de fbclid in de URL), de fbp-cookie en een gehasht e-mailadres in je CRM.
- Bepaal welke CRM-fase je terugstuurt, bijvoorbeeld “gekwalificeerd” of “demo gehouden”.
- Stuur die fase als event met action_source system_generated of website, binnen de termijn die Meta toelaat.
- Optimaliseer je campagnes op dat diepere event zodra er genoeg volume is.
Welke fase geschikt is, hangt af van hoe je CRM je leads indeelt. HubSpot definieert de standaardfases zo:
De lifecycle stage-definities van HubSpot, gecontroleerd op 18 oktober 2026.
Een SQL of een opportunity is voor B2B meestal het zinvolste signaal.
Dezelfde logica als bij Google Ads
Dezelfde logica gebruiken we voor Google Ads in offline conversies importeren uit je CRM.
Bij Kaizo bouwden we de Meta-meting op dezelfde geboekte demo als Google Ads. Zo optimaliseren beide kanalen op dezelfde gebeurtenis: lees de Kaizo-tracking case.
En hoe één kapotte formulier-listener tegelijk GA4, Google Ads, Meta en LinkedIn stillegde, lees je in de Suivo-case.
Wanneer heb je de Conversions API (nog) niet nodig?
Als Meta nog geen echt kanaal is, of je leads via Lead Ads binnen Meta zelf komen.
Twee situaties:
- Je adverteert nauwelijks op Meta. Dan levert een server-side laag weinig op.
- Je leads komen via Lead Ads-formulieren binnen Facebook en Instagram. Dan levert CAPI voor websiteformulieren weinig op.
Die Lead Ads-leads koppel je wel best aan je CRM, zoals we uitleggen in Lead Ads aan je CRM koppelen.
Bij heel lage volumes
Krijg je een handvol leads per maand? Dan is een correcte Pixel met goede eventnamen belangrijker dan een server-side laag.
Een schone CRM-registratie hoort daarbij.
Begin daar, en voeg CAPI toe zodra Meta een echt kanaal wordt in je Meta Ads-aanpak. Wanneer Meta voor B2B loont, lees je in Meta-advertenties voor B2B naast LinkedIn.
Laat het opzetten
Wil je CAPI laten opzetten samen met je Google Ads-, LinkedIn- en GA4-meting?
Onze tracking specialist doet dat in één server-side opzet, op maat en op aanvraag. Neem contact op voor een eerste check.
Adverteer je op meerdere platformen? Lees dan ook onze gidsen over:
Veelgestelde vragen
Wat is het verschil tussen de Meta Pixel en de Conversions API?
De Pixel meet in de browser van de bezoeker, de Conversions API stuurt events vanaf je server of CRM. Meta raadt aan om beide te gebruiken en ze te ontdubbelen met een gedeeld event-ID.
Heb ik server-side Google Tag Manager nodig voor CAPI?
Nee. Een partnerintegratie of de Conversions API Gateway kan ook. Server-side GTM is vooral interessant als je naast Meta ook Google Ads, LinkedIn of TikTok server-side wilt voeden vanuit één container.
Waarom zie ik dubbele conversies na het installeren van CAPI?
Meestal ontbreekt het gedeelde event-ID, verschilt de eventnaam tussen Pixel en server, of sturen twee integraties (bijvoorbeeld een plug-in en je servercontainer) hetzelfde event.
Kan ik offline conversies via de Conversions API sturen?
Ja, zolang het event binnen de termijn valt die Meta toelaat. Voor late B2B-conversies bewaar je fbc, fbp en een gehasht e-mailadres bij de lead in je CRM, zodat Meta de conversie aan de juiste persoon kan koppelen.
Werkt CAPI als een bezoeker cookies weigert?
Technisch kan de server events sturen, maar in België en Nederland mag je dat voor marketing niet zonder toestemming. CAPI herstelt vooral verliezen door adblockers en browserbeperkingen, niet door weigering.
Gratis website-scan
Geef je website in en krijg binnen enkele minuten een automatische scan met concrete technische en SEO-verbeterpunten. Geen verkooppraatje.
Je gegevens gebruiken we alleen voor je scan. Geen spam, uitschrijven kan altijd.