Meta Conversions API via je servercontainer

Meta telt het best als het twee keer over een conversie hoort: één keer van de pixel in de browser, één keer van de Conversions API op je server, allebei met hetzelfde event-ID. De browserkopie draagt de cookies _fbp en _fbc en de paginacontext mee; de serverkopie overleeft adblockers en Safari en draagt gehashte klantgegevens. Deze gids zet allebei op vanuit je Measurebase-servercontainer.

Wat je nodig hebt

• Pixel-ID (Meta noemt het de dataset-ID): Events Manager → Gegevensbronnen → je pixel → Instellingen.
• Conversions API access token: op dezelfde pagina Instellingen onder Conversions API, Generate access token. Het hoort bij een systeemgebruiker in je Business Manager; houd het buiten je container en plak het alleen in Measurebase.
• Je Measurebase-domein met het Enhanced script geïnstalleerd en GA4-events die binnenkomen. De Conversions API-tags lezen alles uit die events.

Stap 1 · Voeg het toe aan je meetopzet

Open het domein in je dashboard, ga naar de pagina Settings en zoek Measurement setup. Vink de kaart van de bestemming aan en vul de ID's hieronder in. Tokens en API-sleutels worden versleuteld opgeslagen, buiten de setup zelf. De setup verstuurt zelf niets: het is de referentie waar de tracking audit en de templatebouwer van uitgaan, dus wat je hier invult is wat de audit in je containers verwacht te vinden.

Stap 2 · Genereer en importeer de containers

Ga naar Resources → GTM templates in het dashboard. Vink onder Destinations het platform aan (Google Analytics 4 en de e-commerce-events staan standaard aan; kies de Shopify-, WordPress- of Shopware-datalayer als je site een van onze plugins draait). Vul in de volgende stap dezelfde ID's in, kies Web + server onder Containers en download de twee JSON-bestanden.

Open in Google Tag Manager elke container, ga naar Admin → Import Container, kies het bijbehorende bestand, kies een nieuwe workspace en Merge. De import voegt alleen toe: nieuwe tags, triggers en variabelen met eigen namen, plus de galerijtemplates die ze nodig hebben. Controleer het resultaat in Preview en publiceer dan.

Stap 3 · Wat de import bevat

Webcontainer: de template Facebook Pixel uit de galerij met de tags FB - PageView, FB - ViewContent, FB - AddToCart, FB - InitiateCheckout en FB - Purchase, een constante met je pixel-ID en de variabele Unique Event ID. Omdat de pixel een paginaweergave met event-ID nodig heeft, wordt ook de GA4-paginaweergave een eventtag.

Servercontainer: de template Facebook Conversion API (Stape, uit de galerij) met dezelfde vijf events als servertags, die afgaan op de GA4-events die je webcontainer al verstuurt. Ze nemen waarde, valuta, items en de gebruikersgegevens op het event, hashen e-mailadres en telefoonnummer, en sturen het IP-adres en de user agent van de bezoeker door, plus de cookies _fbp en _fbc .

Stap 4 · Eén event-ID voor browser en server

Een platform dat hetzelfde event van een browserpixel én van een servertag ontvangt, telt het dubbel, tenzij beide hetzelfde event-ID dragen. De import regelt dat: de variabele Unique Event ID maakt één ID per event in de webcontainer, de GA4-eventinstellingen sturen het naar je servercontainer als event_id, en zowel de pixeltag als de servertag sturen diezelfde waarde mee in hun ontdubbelingsveld. Het platform houdt één kopie en gooit de andere weg.

Met de Shopify-app, de WordPress-plugin of de Shopware-plugin draagt een aankoop die ook server-side wordt doorgestuurd het ordernummer mee als mb_event_id, zodat ook de twee aankoopkopieën aan elkaar gekoppeld kunnen worden.

Meta ontdubbelt op eventnaam plus event-ID binnen 48 uur. Events Manager toont het aandeel ontdubbelde events in het overzicht van de pixel.

Stap 5 · Toestemming

De geïmporteerde tags dragen de toestemmingsinstellingen van de referentiecontainers waaruit ze gekopieerd zijn. Controleer ze tegen je eigen toestemmingsopzet voordat je publiceert: een browserpixel hoort ad_storage te vereisen onder Aanvullende toestemmingscontroles of af te gaan op het event van je toestemmingstool, en de servertags horen alleen te sturen als de hit advertentietoestemming draagt. De toestemmingscontroles van de audit en de gids over tags die afgaan vóór toestemming laten zien hoe je allebei controleert.

Stap 6 · Testen

Open in Events Manager Test events, klik in dezelfde browser door je site en zie zowel de browser- als de serverkopie binnenkomen; de servertag heeft een veld voor de testeventcode zolang je test. Controleer dat elk eventpaar als ontdubbeld wordt getoond en dat de serverkopie de gematchte parameters vermeldt.

Open aan de Measurebase-kant de pagina Requestlogs: als je door je site klikt, zie je GA4-events met een groene 200 bij je servercontainer binnenkomen. Open de previewmodus van de servercontainer om de servertag op die events te zien afgaan, met het event-ID en de gebruikersgegevens die hij oppikte.

Event Match Quality

Meta geeft elk serverevent een score op het aantal identifiers dat het kon matchen: _fbp, _fbc, gehasht e-mailadres en telefoonnummer, IP-adres, user agent en extern ID. Drie Measurebase-power-ups duwen die score omhoog zonder extra werk: Cookie Keeper houdt _fbp en _fbc in leven voorbij de 7-dagenlimiet van Safari, Click ID Restorer vangt de fbclid op in een first-party cookie zodra de bezoeker landt, en de gehashte klantvelden komen uit de datalayer die onze Shopify-app, WordPress-plugin en Shopware-plugin bij aankopen en leads pushen.

Wat de tracking audit controleert

Elke nacht vergelijkt de tracking-audit je meetopzet met je live containers en je site. Voor elke bestemming controleert hij dat de tags bestaan in de container die je opzet verwacht, dat het ID in de container overeenkomt met dat in je opzet, dat een browserpixel en zijn servertag een event-ID delen, en welke cookies van het platform nog gezet worden nadat een bezoeker weigert. Bevindingen openen een melding de eerste keer dat ze verschijnen; wat de audit kan herstellen, stelt hij voor als wijziging in een aparte Measurebase-workspace in je container.

Voor Meta controleert hij ook dat elke pixeltag een event-ID stuurt en dat je GA4-eventtags er een dragen voor de serverkopieën. Accounts waarvoor de Meta-koppeling aanstaat, kunnen de pixel koppelen onder Connections: de audit leest dan de Event Match Quality per event, het aandeel events waarvan de ID's aan de andere kant nooit matchen, en events die nog ruwe persoonsgegevens dragen, en hij kan de Conversions API-tags, de event-ID-keten en het aanmaken van _fbp als fixes voorstellen.

Veelgestelde vragen

Heb ik de browserpixel nog nodig?

Ja. De serverkopie alleen matcht slechter, en de website-aangepaste doelgroepen van Meta en sommige optimalisatiesignalen komen nog steeds van de pixel. Draai allebei, ontdubbeld.

Mijn shop stuurt al events via het Facebook & Instagram-kanaal.

Dan stuurt een tweede pixel buiten Tag Manager dezelfde events zonder je event-ID's, en telt Meta ze dubbel. Zet het delen van gegevens van dat kanaal uit, of laat de pixel uit de import. De site-crawl in de audit toont elke pixel die buiten je container laadt.

Welke events dekt de import?

Paginaweergave, view item, add to cart, begin checkout en purchase, plus lead bij sites met het event generate_lead. Andere standaardevents voeg je toe door een van de geïmporteerde tags te kopiëren.