Meta Conversions API via server-side GTM: stap voor stap

De Meta Conversions API (CAPI) stuur je via server-side GTM met een CAPI-tag in je server container. Die tag zet het binnenkomende GA4-request om naar een server event voor Meta. Laat de Meta Pixel in de browser gewoon staan en stuur bij beide hetzelfde event_id mee. Dan ontdubbelt Meta de browser- en serverversie van hetzelfde event.

Zonder die deduplicatie telt Meta elke aankoop of lead twee keer. Dat is de meest gemaakte fout bij deze koppeling.

Voorwaarden

• een werkende server container met een eigen subdomein, en de GA4-client die de requests van de Google-tag ontvangt;
• een web container die GA4-events met de juiste parameters naar die server stuurt;
• een Meta Pixel (dataset) en toegang tot Eventsmanager om een toegangstoken aan te maken.

Een toegangstoken aanmaken

Het toegangstoken (access token) maak je in Eventsmanager bij de instellingen van je pixel, in het onderdeel Conversions API. Kies daar voor het genereren van een toegangstoken. Bewaar het token alleen in de server container. Het hoort niet in de web container of in de broncode van je site.

De Meta Conversions API-tag in de server-side GTM-container

Meta heeft geen eigen GTM-template voor de server container. Veel gebruikt is de template Facebook Conversions API van Stape uit de Community Template Gallery (affiliatelink).

1. Ga in de server container naar Templates → Tagtemplates → Galerij doorzoeken en voeg de template toe.
2. Maak een nieuwe tag met die template en vul de Pixel ID en het access token in.
3. Laat de tag de eventgegevens uit de GA4-client overnemen. De template zet standaard-GA4-events om naar Meta-events, bijvoorbeeld purchase naar Purchase.
4. Koppel een trigger op Client Name is GA4, eventueel beperkt tot de events die je naar Meta wilt sturen.

Deduplicatie met event_id

Meta ontdubbelt een browser event en een server event als twee velden gelijk zijn:

Pixel (browser)            Conversions API (server)
eventID   = "a1b2c3-17"    event_id   = "a1b2c3-17"
event     = "Purchase"     event_name = "Purchase"

Maak het ID één keer aan in de web container, bijvoorbeeld met een variabele die een unieke waarde per event genereert. Gebruik die waarde in de Meta Pixel-tag als eventID, en stuur hem als event parameter event_id mee in je GA4-event naar de server. De CAPI-tag leest hem daar uit.

Wordt het ID in de server opnieuw aangemaakt, dan komt het nooit overeen met dat van de pixel. Dan telt Meta dubbel.

Deduplicatie bij de Meta Conversions API: browser event en server event met hetzelfde event_id worden samengevoegd tot één event.

Klantgegevens hashen en Event Match Quality

Hoe meer klantgegevens je meestuurt, zoals e-mailadres of telefoonnummer, hoe beter Meta het event aan een gebruiker kan koppelen. Meta toont dat als Event Match Quality. Die gegevens moeten genormaliseerd en met SHA-256 gehasht zijn: kleine letters, spaties weg, telefoonnummer met landcode. De meeste templates hashen zelf als je de ruwe waarde aanlevert.

Let op: stuur zulke gegevens alleen mee als je daar een grondslag voor hebt en de bezoeker toestemming heeft gegeven voor marketing.

Testen met Test Events

1. Kopieer in Eventsmanager onder Test events de testcode.
2. Vul die in het veld voor de testcode van de CAPI-tag in en publiceer of gebruik de Preview van de server container.
3. Doe een testaankoop en controleer of het event binnenkomt als server event, en of Meta het als ontdubbeld met het browser event toont.
4. Verwijder de testcode weer na de test.

Controleer in de Preview van de GTM Preview-modus ook welke gegevens de tag precies verstuurt.

Consent doorgeven aan de server container

Een server event valt onder dezelfde toestemmingsregels als de pixel. Stuurt de web container de consentstatus mee via consent mode, dan kun je in de server container de CAPI-tag alleen laten afgaan als ad_storage is toegestaan. Hoe je consent mode in de web container inricht, lees je in consent mode v2 instellen met Cookiebot en GTM.

Server-side versturen verandert niets aan de vraag of je mag meten. Het verandert alleen de route.