Facebook Conversions API: Implementatiegids voor 2026

Door Marcus Chen

Specialisten in Performance Marketing Beoordeeld door Senior Media Buyers

AI-snelantwoord

Test 15 of meer creatieve varianten per week tegen een gecontroleerde hook-matrix, ververs zodra vermoeidheid zichtbaar wordt in de hook-rate, en laat het platform DCO winnaars hercombineren. Variantensnelheid verslaagt studiopoets op elke betaalde social- en search-plek die we hebben gemeten. Unled runt de testopstelling en de productielijn als één operatie.

Gepubliceerd 10 juli 2026

12 min leestijd · Installatie

Facebook's Conversions API (CAPI) is de server-side tegenhanger van de browserpixel. Nadat iOS 14.5 browsergebaseerde tracking om zeep hielp, werd CAPI de enige manier om de conversies terug te krijgen die Meta misliep. In 2026 laten adverteerders die alleen Pixel gebruiken 30-60% van de toegeschreven conversies liggen. Deze gids behandelt een complete, schone CAPI-installatie van begin tot eind.

Wat CAPI Echt Doet

CAPI stuurt conversiegebeurtenissen rechtstreeks van jouw server naar Meta, waarbij de browser volledig wordt omzeild. Dit betekent dat gebeurtenissen aankomen, zelfs wanneer de browserpixel is geblokkeerd, wanneer het iOS-apparaat van de gebruiker tracking beperkt, of wanneer netwerkcondities de pixel verstoren.

• Herstelt iOS-conversies. ATT-beperkte gebruikers activeren nog steeds servergebeurtenissen.
• Omzeilt adblockers. Server-naar-server gebeurtenissen worden niet geblokkeerd.
• Hogere datakwaliteit. Servergebeurtenissen kunnen first-party identifiers bevatten (gehashte e-mail, telefoon, klant-ID) voor sterkere matching.
• Betere deduplicatie. In combinatie met Pixel met behulp van event_id dedupliceert Meta en telt elke conversie één keer.

Drie Installatiemethoden

1. Native platformintegraties (makkelijkst)

Shopify, WooCommerce, BigCommerce, Magento, Wix en Squarespace hebben allemaal native Meta CAPI-connectors. Activeer in je platformbeheer, plak de access token, klaar. Het beste voor teams zonder ontwikkelaars.

2. Server-side tagmanager (aanbevolen)

Gebruik Stape of Google Tag Manager Server-Side om CAPI-gebeurtenissen te versturen vanuit een sGTM-container. Je krijgt volledige controle over gebeurtenissen, deduplicatie en Advanced Matching zonder servercode te schrijven. Industriestandaard voor serieuze operators.

3. Directe API-integratie (meeste controle)

Stuur POST-verzoeken rechtstreeks naar https://graph.facebook.com/v18.0/{pixel_id}/events vanaf jouw backend. Het beste voor SaaS, aangepaste apps en alles wat niet op een groot commerceplatform is gebouwd.

Stap-voor-Stap: Directe API-implementatie

1. Genereer een CAPI-access token. Events Manager → jouw pixel → Instellingen → Conversions API → Genereer Access Token.
2. Kies de gebeurtenissen om server-side te versturen. Stuur altijd Purchase, Lead en CompleteRegistration. Optioneel: ViewContent, AddToCart, InitiateCheckout voor rijkere matching.
3. Bouw de event-payload. Vereist: event_name, event_time, action_source ("website"), event_id (voor deduplicatie), en user_data (gehashte e-mail/telefoon/external_id).
4. Hash alle user_data-velden met SHA-256. E-mail, telefoon, naam, stad, staat, postcode, allemaal gehasht, kleine letters, zonder spaties.
5. POST naar het Graph API-eindpunt. Voeg de access token toe als queryparameter of header.
6. Stel retry-logica in. Mislukte POSTs (5xx-fouten) moeten opnieuw proberen met exponentiële backoff tot 3 keer.
7. Log elke gebeurtenis voor audit. Bewaar de event-payload en Meta's reactie, zodat je later attributie kunt debuggen.

Event-Deduplicatie: Het Kritieke Detail

• Genereer een unieke event_id voor elke conversie (bijv. jouw order-ID).
• Stuur dezelfde event_id mee met zowel de browserpixel-aanroep als de CAPI-gebeurtenis.
• Zorg dat de event_name exact overeenkomt, "Purchase" niet "purchase".
• Zorg dat de event_time binnen 1 minuut van elkaar ligt voor schone dedup.
• Gebruik het Deduplication-rapport in Events Manager om te verifiëren dat de verhoudingen gezond zijn (browser+server matched events moeten de dominante categorie zijn).

Advanced Matching: Waarom Gehashte Identificatoren Belangrijk Zijn

CAPI stelt je in staat om gebruikersidentificatoren (gehashte e-mail, telefoon, naam, stad, etc.) mee te sturen bij elke gebeurtenis. Meta gebruikt deze om de conversie te koppelen aan de gebruiker die op de advertentie heeft geklikt, zelfs als de browsercookie weg is.

• E-mail (em): De identificator met de hoogste impact. Stuur het mee bij elke mogelijke gebeurtenis.
• Telefoon (ph): Nummer, zonder opmaak, met landcode (bijv. 3114155551234).
• Voornaam (fn) en achternaam (ln): Kleine letters.
• Stad (ct), staat (st), postcode (zp), land (country): Allemaal kleine letters, geen spaties.
• Externe ID (external_id): Jouw interne klant-ID, gehasht. Uitstekend voor het matchen van terugkerende kopers.
• Click ID (fbc) en Browser ID (fbp): Leg vast vanuit de browsercookies en stuur mee met elke servergebeurtenis voor sterkere matching.

Valideren dat CAPI Werkt

1. Events Manager → Tabblad Diagnostics. Mag geen kritieke waarschuwingen tonen.
2. Events Manager → Event Quality / Event Match Quality. Streef naar 7+ op een 10-puntsschaal.
3. Events Manager → Staafdiagram Ontvangen Gebeurtenissen. Bevestig dat zowel de Browser- als Server-balken zijn gevuld.
4. Test Events. Genereer een test_event_code, vuur een echte conversie af en zie deze in realtime landen.
5. Na 7 dagen: Vergelijk toegeschreven conversies in Ads Manager voor en na CAPI. Een stijging van 20%+ in toegeschreven conversies bevestigt dat CAPI data herstelt.

CAPI is niet langer optioneel. De adverteerders die in 2026 alleen Pixel gebruiken, concurreren met één hand op de rug gebonden. Kies het installatiepad dat bij jouw stack past, dedupliceer correct en valideer met Event Match Quality. Twee dagen werk betaalt zich permanent terug.