Stel Facebook server-side tracking in met de Facebook Conversions API
Met de Facebook Pixel kunt u gebruikersactiviteit op uw site volgen, remarketingdoelgroepen opbouwen en lookalike audiences creëren. Wanneer dit correct is ingesteld, levert de Facebook Pixel waardevolle data aan de machine learning-algoritmes van Facebook (FB ML), die deze informatie gebruiken om uw advertenties te tonen aan mensen die waarschijnlijk zullen converteren.
Jarenlang werden events op websites gemeten met JavaScript-code, de Facebook SDK in apps of door offline events te uploaden. Maar hoe trackt u gebruikers als ze adblockers gebruiken, hoe meet u events buiten uw website en hoe verlengt u de levensduur van cookies? Dit kunt u oplossen door de Facebook Conversions API of de Facebook Conversions API Gateway te implementeren.
Dit artikel richt zich op Facebook conversiontracking en laat zien hoe u de Facebook Conversions API instelt via de Google Tag Manager Server Container. Bekijk daarnaast ook de pre-configured templates voor Meta CAPI van Stape. Het configureren van uw setup is nog nooit zo eenvoudig geweest, alles staat al klaar voor gebruik!
| Gerelateerd: Facebook Lead Ads. |
Wat is de Facebook Conversions API?
Laten we kijken wat de Facebook Conversions API is en hoe u deze kunt gebruiken om event tracking, attributie en dataverzameling op Facebook te verbeteren. De Facebook Conversions API maakt het mogelijk om events direct vanaf uw server naar de servers van Facebook te sturen.
Facebook CAPI heeft hetzelfde doel als de Facebook Pixel, maar maakt gebruik van een andere technologie. Door de regels en beperkingen rondom tracking sluit FB CAPI beter aan op de moderne trackingomgeving. In tegenstelling tot de Facebook Pixel is de Conversions API niet afhankelijk van de browser van de gebruiker om trackingdata te verzenden, alles wordt via een cloudserver verwerkt. Dit zorgt voor betere databeveiliging en nauwkeurigheid.
In tegenstelling tot de Pixel is Facebook server-side tracking niet afhankelijk van wat er in de browser van de gebruiker gebeurt. Dit betekent dat adblockers, ITP en iOS-beperkingen nauwelijks invloed hebben op de dataverzameling. Hierdoor vormt het een stabielere basis voor conversietracking, zeker nu privacybeperkingen in browsers steeds strenger worden.
Als u naar de URL’s van Facebook advertenties kijkt, ziet u dat Facebook vaak een extra parameter toevoegt: fbclid. De pixelcode op de landingspagina slaat deze waarde op in een cookie en stuurt deze mee met Facebook events. Naast de click ID (fbclid) gebruikt Facebook ook de browser ID (fbp). De fbp- en fbc-cookies helpen Facebook om te bepalen wat voor type gebruiker uw website heeft bezocht en wie uiteindelijk heeft geconverteerd.
Facebook kan gebruikers ook matchen via andere gegevens zoals e-mailadres, telefoonnummer en voor- en achternaam. Hoe meer user data u naar de Facebook Conversions API stuurt, hoe hoger uw match rate zal zijn.
| Hoewel de meeste bedrijven zich richten op web events, maakt Meta het nu mogelijk om een fysieke winkel te koppelen aan online data. Bekijk onze Meta omnichannel ads gids om te leren hoe u online en offline conversies combineert. |
Wat zijn de belangrijkste voordelen van de Facebook Conversions API?
Facebook server-side tagging, oftewel de Facebook Conversions API, bestaat al een aantal jaar. Sinds 2021 promoot Facebook deze oplossing echter steeds actiever. Heeft u een Facebook accountmanager die uw advertenties beheert, dan is de kans groot dat die aanbeveelt om de Facebook Conversions API in te stellen.
Hier zijn de belangrijkste redenen om te overwegen de Facebook Conversions API te implementeren. Bekijk hieronder de details.
- U kunt gebruikers blijven tracken die adblockers gebruiken, Safari (of andere browsers met ITP) gebruiken, of zich hebben afgemeld voor Facebook tracking in iOS 14/15. Dit komt doordat requests vanaf de server worden verstuurd in plaats van vanuit de browser. Third-party cookies worden daardoor niet geblokkeerd. Met behulp van user parameters die u meestuurt met FB CAPI events kan Facebook deze events koppelen aan gebruikers in hun database. Het resultaat is betrouwbaardere data.
- Verlengde cookielevensduur. Met de Facebook Conversions API kunt u de cookielevensduur verlengen tot 6 maanden. Zonder FB CAPI beperkt Safari cookies tot 1-7 dagen.
- Meer controle over uw data en beter inzicht in de klantreis.
- U kunt met de Facebook Conversions API ook events meten die buiten uw website plaatsvinden, zoals telefoongesprekken of offline aankopen.
| Bedrijven die overstappen op Facebook server-side tracking zien vaak een stijging in gerapporteerde conversies, niet omdat er daadwerkelijk meer conversies plaatsvinden, maar omdat er minder verloren gaan door trackingbeperkingen. Dit verschil is vooral zichtbaar bij doelgroepen die veel gebruikmaken van Safari, Brave of adblockers. |
Praktijkvoorbeeld van de waarde van de Meta Conversions API
Door de Conversions API te combineren met de Meta Pixel wist Ray-Ban de advertentieresultaten aanzienlijk te verbeteren. Deze combinatie zorgde voor een 36% groter bereik op Facebook en Instagram vergeleken met alleen het gebruik van de Meta Pixel.
Daarnaast zag het merk een daling van 19% in de kosten per 1.000 weergaven en een afname van 7% in de kosten per conversie. Dit laat zien hoe effectief de Conversions API is in het optimaliseren van campagnes en het verbeteren van prestaties.
Manieren om Facebook server-side tracking in te stellen
Met de Meta Conversions API Gateway
De Meta Conversions API Gateway is de snelste manier om Meta server-side tracking te implementeren en vereist geen specialistische kennis.
Hoe werkt de Conversions API Gateway
De belangrijkste functie van de Conversions API Gateway is de omgeving waarin deze draait. Elke Gateway instantie heeft een cloudserver nodig om alle communicatie tussen de Meta Pixel en de Conversions API te verwerken. Voor een beter begrip kunt u de documentatie van Meta bekijken over hoe de Conversions API Gateway werkt.
Zodra de Meta Pixel is gekoppeld aan de Conversions API Gateway omgeving, worden web events gebruikt om data via de server te tracken. Daarom is het belangrijk dat uw web events volledig correct zijn en alle benodigde user- en productdata bevatten voordat u de Conversions API Gateway implementeert.
Met Stape is het opzetten en hosten van de Conversions API Gateway eenvoudiger dan ooit. Maak simpelweg een Stape account aan en stel de Conversions API Gateway in binnen Stape. Daarna koppelt u de benodigde Meta Pixels aan de Gateway omgeving.
Voordelen en nadelen van de Conversions API Gateway
Voordelen:
1. Lage prijs. Stape hosting voor de Conversions API Gateway kost €10 per pixel per maand of €100 per maand voor 100 pixels. Daarnaast krijgt u een gratis proefperiode van 7 dagen.
De Conversions API Gateway is bovendien de eenvoudigste manier om de Conversions API te implementeren, waardoor u honderden tot duizenden euro’s kunt besparen vergeleken met een handmatige setup.
2. Eenvoudige setup. U hoeft geen developers of tracking specialisten in te schakelen. De setup is eenvoudig en kan minder dan 1 minuut duren, zelfs zonder technische kennis.
3. Geen onderhoud. Updates worden automatisch geïnstalleerd. U hoeft geen tijd te besteden aan handmatige updates van instellingen of servers. Voegt u een nieuw event toe? Dan hoeft u alleen de web tracking goed in te stellen, de Gateway begint automatisch met server-side tracking van deze events.
Nadelen:
1. Nieuw. De Conversions API Gateway is relatief nieuw en Meta zal waarschijnlijk nog nieuwe functies en updates uitrollen. Het is dus verstandig om rekening te houden met veranderingen.
2. Geen ondersteuning voor andere platforms. Wilt u het maximale uit server-side tracking halen, dan kan sGTM container (server Google Tag Manager container) een betere oplossing zijn. U heeft dan nog steeds een GTM setup nodig om bijvoorbeeld server-side Google Analytics en Google Ads te beheren.
Stape hosting voor Conversions API Gateway
Stape biedt hosting voor de Conversions API Gateway voor €10 per pixel per maand of €100 per maand voor 100 pixels. Alle gebruikers krijgen daarnaast een gratis proefperiode van 7 dagen.
Stel de Meta Conversions API Gateway in
Om de Conversions API Gateway met Stape in te stellen, hoeft u alleen het volgende te doen:
- Maak een Stape account aan (als u die nog niet heeft).
- Koppel de Conversions API Gateway hub met uw Meta Pixel.
Zodra u de Conversions API Gateway container in Stape aanmaakt, wordt automatisch een Amazon Web Services cloudomgeving opgezet volgens de vereisten van Meta en worden alle updates voor u beheerd.
Voor een stap-voor-stap uitleg kunt u onze handleiding bekijken over het instellen van de Meta Conversions API Gateway.
| Bekijk ook ons artikel waarin we Meta CAPI en Meta CAPIG vergelijken, zodat u de juiste keuze kunt maken voor uw situatie. |
Met sGTM container
Een van de meest toegankelijke manieren is het gebruik van server Google Tag Manager (sGTM container). Met sGTM container kunnen bedrijven klantdata direct naar de servers van Facebook sturen. Als u al GA4 gebruikt, vereist Facebook server-side tracking via sGTM container minimale extra configuratie, omdat GA4 events direct opnieuw gebruikt kunnen worden als databron voor de Facebook tag. Dit maakt sGTM container voor de meeste setups het meest praktische startpunt.
Voordelen van het instellen van Facebook CAPI via sGTM container:
- Flexibele aanpassingsmogelijkheden
- Mogelijkheid om zowel pure server-side als hybride (web + server) tracking te implementeren
- Kans om data te verrijken
Nadelen van het instellen van Facebook CAPI via sGTM container:
- Vereist technische kennis van server Google Tag Manager
- Heeft cloudinfrastructuur nodig om sGTM container te hosten
In dit artikel richten we ons op het instellen van Facebook server-side tracking via sGTM container.
Stel de Facebook Conversions API in met sGTM container
We gebruiken de server Google Tag Manager container om de Facebook Conversions API in te stellen. Hiervoor heeft u het volgende nodig:
- Een ingestelde Google Tag Manager webcontainer
- Server-side Google Analytics 4 of Data Tag/Data Client om data naar sGTM container te sturen
We hebben ook een blogartikel over de Tag Manager servercontainer en de voordelen ervan.
Deze video laat zien hoe u de Facebook Conversions API instelt met behulp van Google Analytics 4.
Stappen om de Facebook Conversions API in te stellen
2. Stuur data naar de sGTM container. De twee meest gebruikte methodes zijn Google Analytics 4 en Data Client Stape.
3. Ga naar uw Google Tag Manager servercontainer en voeg de Facebook Conversions API tag toe via de Template Gallery.
4. Maak een Facebook Conversions API tag aan in sGTM container. Selecteer Tag → klik op New → kies de Facebook tag die u in de vorige stap heeft toegevoegd.
Voeg uw Facebook Pixel ID en Facebook API Access Token toe (we raden aan om deze als variabelen toe te voegen, omdat u ze nodig heeft voor elk Facebook event dat u wilt tracken). Weet u niet waar u uw Facebook API Access Token vindt, raadpleeg dan de documentatie van Meta.
5. U heeft twee opties om de Facebook Conversions API tag te configureren:
- Override. In dit geval moet u Facebook events handmatig instellen. In stap zes leggen we uit hoe u server-side Facebook events handmatig configureert. Dit is de aanbevolen optie, maar kost meer tijd en kennis om te implementeren. U heeft hiermee volledige controle over de payload van het event en zorgt ervoor dat u web- en server Facebook events identiek zijn.
- Inherit from client. In dit geval matcht de tag automatisch de payload van uw GA4/Data event met Facebook standaard events. Als de tag geen match kan maken, wordt het event als custom event verstuurd. Alles gebeurt automatisch, u hoeft geen Facebook events handmatig in te stellen.
6. Gebruik GA4 of Data Tag/Data Client events om Facebook server events te triggeren als u de override optie kiest. Het Facebook pageview event moet worden geactiveerd op een custom event page_view dat is toegewezen aan een specifieke client (bijvoorbeeld: als u GA4 gebruikt als databron voor de sGTM container, gebruikt u het page_view event wanneer de clientnaam gelijk is aan GA4).
Ga naar de sGTM container preview modus, voer een actie uit op uw website en controleer welke eventnaam door GA4 of de Data Tag naar uw servercontainer wordt gestuurd.
In het voorbeeld hieronder willen we het Facebook event ViewContent instellen wanneer iemand een productpagina opent. Zorg er ook voor dat u via uw GA4 event of Data Tag vanuit de webcontainer alle extra data meestuurt die u wilt gebruiken voor het server event. In dit voorbeeld worden ook standaard Facebook eCommerce parameters en user data gebruikt.
Hiervoor hebben we een nieuwe tag aangemaakt in de servercontainer, deze ingesteld op override, het standaard event ViewContent geselecteerd en de API Access Token en Facebook Pixel ID toegevoegd. Daarnaast hebben we User Data toegevoegd en een nieuwe trigger gemaakt met eventnaam gelijk aan view_item en Client Name gelijk aan GA4.
7. U kunt custom parameters doorsturen via de velden Server Event Data Override, User Data en Custom Data. Via het veld User Data kunt u extra user data meesturen om de matchscore op Facebook te verhogen. Let op: de user data die u naar de Facebook Conversions API stuurt, moet gehasht zijn. Onze Facebook tag doet dit automatisch voor de benodigde data.
U kunt ook Event Enhancement inschakelen om gebruik te maken van de HTTP-only secure cookie (gtmeec) om eventdata te verrijken. Wanneer deze functie is ingeschakeld, slaat de tag user data op in cookies en voegt deze toe aan events wanneer die data ontbreekt. Zo verhoogt u de kwaliteit van event matching, wat kan zorgen voor betere conversie-attributie binnen uw campagnes.
8. Wanneer u klaar bent met het instellen van al uw Facebook events, opent u de Google Tag Manager debugmodus en controleert u of de Facebook events correct werken.
U kunt ook naar uw Facebook tag in de servercontainer gaan en de Facebook test ID toevoegen. Deze test ID vindt u in de Meta Events Manager onder het tabblad Test Events.
9. Zodra u de Facebook Conversions API heeft ingesteld en gecontroleerd dat deze correct werkt, schakelt u Facebook browser tracking uit of zet u event deduplicatie aan. Anders worden uw events dubbel gemeten.
Test de Facebook Conversions API
Gebruik de sGTM container debug tool om te controleren of de base code en Facebook events correct worden geactiveerd
De eerste stap bij het testen van Facebook server-side tracking is hetzelfde als bij Google Analytics. Zorg ervoor dat events op de juiste triggers afgaan. Open de GTM debug tool, ga door uw website en voer de acties uit die u wilt testen. Ga daarna naar het Tag Manager debugscherm en controleer de resultaten.
Controleer eerst of de Facebook base pixel wordt geactiveerd bij een page view. Ziet u de status Fail, bekijk dan de outgoing requests om te achterhalen waarom de tag niet werkt.
Als u onze Facebook server-side tracking tag gebruikt, heeft u twee opties om events te versturen:
- Inherit from GA client. In dit geval worden GA events automatisch gekoppeld aan Facebook standaard events. Gebruikt u deze optie, dan ziet u in de GTM debugmodus alleen de Facebook base tag.
- Override. Kiest u voor deze optie, dan moet u Facebook server events handmatig instellen in de servercontainer. Deze events worden dan zichtbaar in de server debugmodus.
Facebook testing tool voor Facebook Conversions API
Open de Events Manager in uw Facebook Business Manager en ga naar Test Events. Hier ziet u een test event code die u moet toevoegen aan uw Facebook tag in Google Tag Manager. Met deze code kunt u Facebook server events in realtime testen.
Zodra u de test ID heeft toegevoegd, opent u uw website en voert u acties uit die uw Facebook events triggeren. Ga daarna terug naar de Facebook Testing Tool en controleer de weergegeven events. In de kolom Received From moet u Server zien staan. U kunt op een event klikken om de geregistreerde parameters te bekijken.
Let op: de Facebook Pixel Helper Chrome plugin die u gebruikt voor browser events werkt niet voor de Conversions API. Daarom moet u alles controleren via de testing tool.
Controleer of Facebook cookies zijn verlengd
| Let op: cookies worden alleen verlengd als u een eigen subdomein gebruikt in uw tagging URL. Bijvoorbeeld, als uw website example.com is, dan moet uw tagging URL iets zijn als gtm.example.com. |
De derde stap lijkt op wat u eerder heeft gedaan, maar met een paar verschillen. Om de vervaldatum van Facebook cookies te controleren, moet u deze eerst genereren. Open uw website en voeg fbclid toe aan de URL.
Open daarna de developer tools, ga naar Storage en klik op Cookies. Controleer of de _fbc en _fbp cookies zijn verlengd.
U kunt Facebook CAPI ook instellen met behulp van GTM templates
Met Stape kunt u de nauwkeurigheid van tracking en de resultaten van uw campagnes verbeteren met server-side tagging.
Afhankelijk van het platform dat u gebruikt, kunt u tracking snel en effectief instellen met onze custom templates. Volg de stap-voor-stap handleidingen om Meta CAPI via sGTM container in te stellen voor:
Templates en handleidingen voor Wix, Shopware, PrestaShop en meer komen binnenkort. Laat het weten als u een template nodig heeft voor een ander CMS.
Event deduplicatie voor Facebook Pixel en Conversions API events
Facebook raadt aan om zowel de Pixel als de Conversions API te gebruiken om events te tracken. Zonder event deduplicatie kan dubbele data vanuit de browser en server uw resultaten vertekenen. Deduplicatie zorgt ervoor dat slechts één event wordt behouden door gebruik te maken van unieke event ID’s die tussen beide bronnen worden gedeeld. Een correcte setup vereist dat deze ID’s worden gegenereerd en gesynchroniseerd tussen browser- en server events. Dit kunt u testen in de Events Manager van Facebook.
Een veelgemaakte fout bij Facebook server-side tracking is dat events alleen vanaf de server worden verstuurd en de Pixel volledig wordt overgeslagen. Dit verlaagt de match rate, omdat Facebook afhankelijk is van browserdata zoals fbp- en fbc-cookies om gebruikers te herkennen. Door beide parallel te gebruiken met goede deduplicatie combineert u het beste van beide werelden: betrouwbare server-side dataverzameling en de browsersignalen die Facebook nodig heeft om doelgroepen nauwkeurig op te bouwen en campagnes effectief te optimaliseren.
Daarnaast zorgt het meesturen van user data via de Conversions API voor een betere matchkwaliteit en hogere event match scores, wat de prestaties van uw advertenties verbetert. User data komt idealiter uit een Data Layer en moet voldoen aan privacyregels. Tools zoals Stape plugins maken het eenvoudiger om user data te integreren en uw Facebook campagnes verder te optimaliseren.
Verstuur user parameters met de Facebook Conversions API
Om gebruikers die uw site bezoeken te matchen met hun database, gebruikt Facebook User Data binnen de Conversions API.
Facebook vereist dat bepaalde parameters worden gehasht voordat ze worden verzonden, maar daar hoeft u zich geen zorgen over te maken, de Facebook tag hasht deze data automatisch voordat deze wordt verstuurd.
Hoe meer user parameters u naar Facebook stuurt, hoe groter de kans dat een gebruiker wordt gematcht, wat resulteert in een hogere event match score.
Het versturen van user data naar Facebook is gevoelig, omdat u gegevens deelt met een externe partij. Zorg er daarom altijd voor dat dit voldoet aan uw privacybeleid, voordat u deze data verzendt.
Idealiter voegt u uw user data toe aan de Data Layer. Als dat niet mogelijk is, kunt u proberen deze via de pagina te verzamelen met behulp van custom JavaScript en mee te sturen met de conversies of events die u wilt meten.
Bijvoorbeeld: alle Stape plugins voor CMS-systemen (zoals Facebook CAPI for Shopify, WordPress server-side tracking, Magento 2 Google Tag Manager, GTM app voor BigCommerce) voegen een Data Layer toe waarin ook user data zit.
U kunt deze eenvoudig uit de Data Layer ophalen en toevoegen aan Facebook events in de webcontainer.
Stuur vervolgens de benodigde data door naar de servercontainer (in de payload van de GA4- of Data tag, afhankelijk van wat u gebruikt).
Voeg deze data vervolgens toe aan uw server-side Facebook event.
Op deze manier verbetert u de matchkwaliteit van uw Facebook events, wat kan zorgen voor betere prestaties van uw advertentiecampagnes. Facebook begrijpt uw doelgroep beter en kan uw campagnes effectiever optimaliseren.
Controleer fouten in de Facebook Pixel of Conversions API
De Events Testing Tool van Facebook is een handig hulpmiddel waarmee u problemen met uw Facebook Pixels of servergebeurtenissen kunt debuggen en oplossen. Als er fouten zijn, worden ze weergegeven in het tabblad Diagnostiek in de werkbalk, zodat u ze verder kunt bekijken.
Fouten die rood zijn gemarkeerd, vragen meestal direct om aandacht en moeten meteen worden opgelost. Gele fouten zijn niet-kritieke waarschuwingen die u moet volgen en later kunt oplossen.
Facebook laat u problemen markeren als opgelost of ze negeren. Als u een fout als opgelost markeert en deze opnieuw optreedt, toont Facebook deze na drie dagen opnieuw. Genegeerde problemen gaan naar het gedeelte Genegeerd en blijven daar.
Wanneer u problemen met uw Facebook-tracking oplost, raden we aan om ze als opgelost te markeren. Zo laat u Facebook weten dat de problemen zijn opgelost, en het platform waarschuwt u als deze problemen opnieuw optreden.
Wat zijn de meest voorkomende Facebook Pixel en Conversions API fouten en hoe lost u ze op?
1. Nieuwe domeinen die data versturen
U kunt alle domeinen zien die data naar uw Facebook Pixel sturen. Als Facebook verkeer detecteert vanaf een nieuw (sub)domein, krijgt u een waarschuwing. U kunt domeinen op een allowlist of blocklist zetten om verkeer van testomgevingen of technische URL’s te blokkeren.
Waarschijnlijk ziet u ook verkeer vanaf gtm-msr.appspot.com. Dit gebeurt vaak wanneer u een container in debug- of publishmodus gebruikt, of wanneer gebruikers uw site bezoeken met JavaScript uitgeschakeld (bijvoorbeeld bots).
Om een allow- of blocklist in te stellen, gaat u naar de Events Tool in Business Manager → klik op Settings → scroll naar beneden naar Traffic Permissions.
2. Event mist deduplicatieparameters
Dit is een van de meest voorkomende Facebook CAPI fouten. Deze fout betekent dat u niet alle deduplicatiesleutels meestuurt bij uw server events. Facebook gebruikt hiervoor: event name, event ID, _fbp en external ID.
In de meeste gevallen komt dit door een ontbrekende Event ID. Controleer of u een event ID meestuurt bij zowel de Facebook Pixel als de Facebook Conversions API. Deze ID moet identiek zijn voor browser- en server events, zodat Facebook ze als hetzelfde event kan herkennen en dedupliceren.
Bijvoorbeeld: voor PageView events moet u dezelfde event name en event ID versturen via zowel de Pixel als CAPI.
Om dit te testen, gebruikt u de Facebook Event Testing Tool. Als alles correct is ingesteld, ziet u dat browser- en server events met dezelfde event ID worden geregistreerd, waarbij server events worden gededupliceerd.
Ziet u dat browser- en server events willekeurig verschijnen, dan zijn de event ID’s waarschijnlijk niet gelijk. U kunt hiervoor een custom variabele gebruiken in uw webcontainer.
Deze fout kan ook ontstaan als u de Facebook test ID niet heeft verwijderd voordat u live bent gegaan. Gebruik daarom een lookup table variabele die alleen actief is in debugmodus.
3. Server stuurt ongeldige match key parameters voor PageView event
Deze melding betekent dat de waarden die u vanuit de server verstuurt niet uniek zijn of verkeerd zijn geformatteerd. Bijvoorbeeld: een IP-adres met ongeldige tekens of een telefoonnummer dat in het e-mailveld wordt verstuurd.
Om dit te controleren, opent u de previewmodus van zowel uw server- als webcontainer in Google Tag Manager. Hier ziet u welke user parameters naar Facebook worden gestuurd en of ze correct zijn geformatteerd. Test het event, klik op de tag in debugmodus en controleer de waarden.
Deze fout kan ook betekenen dat een parameter ontbreekt of verkeerd is ingesteld.
Een voorbeeld: een klant wilde land en stad meesturen op basis van het IP-adres. Facebook verwacht echter gegevens die de gebruiker zelf heeft ingevuld, niet automatisch afgeleide data. Dit leidde tot een foutmelding over ongeldige parameters.
4. Mogelijke schending door privacygevoelige data naar Facebook te versturen
Deze fout komt meestal voor bij browser events en betekent dat Facebook user data in de URL heeft gedetecteerd. Sommige tools of CMS-systemen, zoals Calendly of PayPal, sturen gebruikersgegevens mee in de URL na een registratie of aankoop.
Deze fout is lastig op te lossen en vereist meestal hulp van developers. Zij moeten de URL query parameters aanpassen en alle user data uit de URL verwijderen. U kunt ook de richtlijnen voor het verwijderen van Personally Identifiable Information (PII) volgen en proberen het probleem binnen GTM op te lossen. Een andere optie is om volledig over te stappen op server-side Facebook tracking. Hiermee kunt u de URL aanpassen voordat deze naar Facebook wordt gestuurd.
5. Verhoog de event match quality
Voor elk server event dat u naar Facebook stuurt, wordt een event match quality score berekend. Deze score hangt af van hoeveel user data u meestuurt.
Als u een eigen subdomein gebruikt voor uw tagging server, worden meestal alleen User IP, browser ID, _fbp en _fbc naar Facebook gestuurd. Dit resulteert vaak in een score van ongeveer 4 op 10.
Om een hogere score te behalen, is het belangrijk om zoveel mogelijk user parameters mee te sturen. Facebook gebruikt deze data om gebruikers op uw site te matchen met hun database. Zorg er wel altijd voor dat dit voldoet aan uw privacybeleid en regelgeving. Technisch gezien geldt: hoe meer data u verstuurt, hoe beter de nauwkeurigheid van uw doelgroep- en conversiedata en hoe beter uw campagnes kunnen presteren.
Hoe verhoogt u de event match quality score? Door meer user data te versturen. In de praktijk betekent dit:
Controleer of er een Data Layer op uw website aanwezig is en of deze alle user data bevat. Bijvoorbeeld: als gebruikers kunnen inloggen, zorg dan dat hun gegevens bij login in de Data Layer worden geplaatst.
Is er nog geen Data Layer? Laat uw developers deze implementeren.
Zorg er daarna voor dat alle user parameters van de webcontainer naar de servercontainer worden doorgestuurd.
Daarnaast kan een nieuwe functie van de Data Tag helpen: het opslaan van user data. Als iemand bijvoorbeeld een formulier invult, kunt u deze data opslaan in local storage en later op andere pagina’s opnieuw gebruiken.
6. Dezelfde event ID ontvangen voor meerdere events
Wanneer u Facebook events zowel via de browser als via de server trackt, moet elk event een unieke event ID hebben. Voor correcte deduplicatie moeten de event name en event ID exact overeenkomen tussen browser en server.
Deze fout ontstaat wanneer u dezelfde event ID gebruikt voor meerdere events. Bijvoorbeeld: op een productpagina worden zowel PageView als ViewContent events getriggerd, maar beide gebruiken dezelfde event ID.
Correct voorbeeld:
FB browser: PageView, eventID: ‘69’
FB server: PageView, eventID: '69'FB browser: ViewContent, eventID: '79'
FB server: ViewContent, eventID: '79'Fout voorbeeld:
FB browser: PageView, eventID: ‘69’
FB server: PageView, eventID: '69'FB browser: ViewContent, eventID: '69'
FB server: ViewContent, eventID: '69'In dit geval gebruikt zowel PageView als ViewContent dezelfde event ID, terwijl Facebook voor elk event een unieke ID verwacht.
Oplossing: voeg een Facebook test ID toe, open de previewmodus van zowel de web- als servercontainer en test uw setup. Zo kunt u achterhalen wanneer de fout optreedt en deze gericht oplossen.
We hebben een custom variabele ontwikkeld die automatisch een unieke event ID genereert. Het is aan te raden om deze te gebruiken voor deduplicatie. U kunt bijvoorbeeld de eventnaam toevoegen aan de ID (event_name_eventID), zodat elke event ID uniek blijft, zelfs als dezelfde trigger wordt gebruikt.
Eventnaam mapping
Standaard probeert de tag GA standaard events te koppelen aan Facebook standaard events. Als er geen match wordt gevonden, wordt de originele eventnaam vanuit de GA client gebruikt.
Bijvoorbeeld: als u een event verstuurt zoals gtag(‘event’, ‘UserLikedProduct’), ziet u in de Facebook Events Manager het event UserLikedProduct terug.
Hieronder vindt u het mappingschema van GA events naar Facebook events dat standaard in deze tag wordt gebruikt.
| page_view | PageView |
| add_payment_info | AddPaymentInfo |
| add_to_cart | AddToCart |
| add_to_wishlist | AddToWishlist |
| sign_up | CompleteRegistration |
| begin_checkout | InitiateCheckout |
| generate_lead | Lead |
| purchase | Purchase |
| search | Search |
| view_item | ViewContent |
| contact | Contact |
| customize_product | CustomizeProduct |
| donate | Donate |
| find_location | FindLocation |
| schedule | Schedule |
| start_trial | StartTrial |
| submit_application | SubmitApplication |
| subscribe | Subscribe |
Google Analytics naar Facebook events
Om het migreren van uw web Facebook GTM tag naar de server-side container te vereenvoudigen, hebben we alle data die door de GA client wordt ontvangen automatisch gekoppeld aan Facebook events, zonder dat u extra configuratie nodig heeft. Dit ondersteunt ook de mapping van GA Enhanced eCommerce events, en u kunt uiteraard altijd eventparameters overschrijven voordat ze naar Facebook worden gestuurd.
Bijvoorbeeld: als de tag detecteert dat het eventtype Purchase is, bepalen we automatisch de productlijst, valuta en waarde.
In de volgende secties leggen we uit hoe de data precies wordt gemapt binnen elke parametergroep.
Standaard mapping en override van Server Event Data
Slechts een paar parameters vallen onder Server Event Data. Bekijk de documentatie van Facebook voor een volledig overzicht van beschikbare eventparameters.
Standaard ingestelde parameters:
| event_name | Event Name |
| event_source_url | Page Location |
| action_source | Waar de conversie heeft plaatsgevonden (bijvoorbeeld: website, e-mail, app) |
| event_time | Huidige tijd |
Standaard mapping en override van User Data
Met de optie “User Data” in de tag kunt u user data overschrijven of toevoegen die naar Facebook wordt gestuurd. Bekijk de documentatie van Facebook voor meer details over welke data u kunt toevoegen. Als een parameter gehasht moet worden, moet u deze hashen met SHA256, anders wordt de hit niet naar Facebook gestuurd.
| fbc | Cookie waarde ‘_fbc’ of ‘fbclid’ URL parameter (indien aanwezig) |
| fbp | Cookie waarde ‘_fbp’ |
| external_id | external_id of user_id of userId |
| subscription_id | subscription_id of subscriptionId |
| lead_id | lead_id of leadId |
| ln | lastName or LastName of nameLast |
| fn | firstName or FirstName of nameFirst |
| em | |
| ph | phone |
| ge | gender |
| ct | city |
| st | state |
| zp | zip |
| country | countryCode |
Standaard mapping en override van Custom Data
U kunt ook andere parameters overschrijven of eigen parameters toevoegen via de sectie “Custom Data” in de tag setup. Bekijk de documentatie van standaardparameters voor meer informatie over welke data u kunt meesturen.
Als de Enhanced eCommerce parameter items aanwezig is, wordt content_type ingesteld op product. GA productparameters item_name en item_category worden gemapt naar respectievelijk content_name en content_category in Facebook.
De tag probeert ook andere productparameters te bepalen, zoals:
| value | x-ga-mp1-ev or value |
| currency | currency |
| transaction_id | order_id |
Als het eventtype Purchase is maar de valuta niet kan worden bepaald, wordt USD als standaard gebruikt, omdat Facebook geen Purchase events accepteert zonder currency parameter.
Facebook server-side tracking: echte problemen van Stape gebruikers opgelost
1. Een gebruiker in de community merkte dat na de overstap naar Facebook server-side tracking de retargeting doelgroep veel kleiner was dan het GA4 verkeer (ongeveer 15% match rate). Het probleem was geen fout in tracking, maar te hoge verwachtingen: Facebook kan gebruikers niet betrouwbaar matchen met alleen IP en User Agent. De oplossing was om de aanbevolen hybride setup van Meta te gebruiken (browser + server met deduplicatie) en zoveel mogelijk user data mee te sturen (zoals e-mail of naam waar mogelijk). Deze aanpak verhoogt de matchkwaliteit en de omvang van uw doelgroep, terwijl pure server-side tracking juist beperkingen heeft voor retargeting.
2. Veel gebruikers in deze thread ervaren problemen met Facebook server-side tracking en FBP/FBC mapping, vooral bij externe checkouts. Het gebruik van de Facebook CAPI template van Stape op een first-party subdomein, het afvuren van belangrijke events op het hoofddomein, het implementeren van een hybride browser + server setup voor deduplicatie en eventueel het gebruik van webhooks lossen de meeste problemen op. Controleer data altijd via browser network tools in plaats van alleen te vertrouwen op Tag Assistant.
Conclusie
Dat was het. Hopelijk is het gelukt om Facebook tracking succesvol naar server-side te migreren. De Facebook Conversions API is een krachtige tool om uw klanten beter te begrijpen, hun reis richting conversie te volgen en meer data te verzamelen om de machine learning algoritmes van Facebook te optimaliseren.
Opmerkingen