Meta Conversions API (CAPI) voor leadformulieren: leads doorsturen zonder dubbeltelling
Zo stuur je leads naar Meta via zowel de Pixel als de Conversions API met één gedeelde event-ID, haal je een toegangstoken op, controleer je in Test Events en regel je toestemming voor gehashte contactgegevens.
Antwoord: De Meta Conversions API (CAPI) verstuurt events vanaf je server in plaats van vanuit de browser van de bezoeker. Gebruik hem samen met de Pixel en geef beide dezelfde eventnaam en dezelfde event-ID; Meta houdt er dan één over en gooit het duplicaat weg. Leads die de Pixel mist (adblockers, trackinglimieten van browsers, gesloten tabbladen) worden toch vastgelegd door het server-event.
Waarom de Pixel alleen tekortschiet
De Pixel draait in de browser van de bezoeker. Adblockers, trackinglimieten van iOS en mensen die het tabblad direct na het versturen sluiten, zorgen allemaal voor gemiste events. Meta rapporteert dan te weinig conversies en optimaliseert je advertenties op minder data. Een kopie vanaf de server vult dat gat.
Wat je nodig hebt
- Pixel-ID (dataset-ID) uit Meta Events Manager → Gegevensbronnen.
- Toegangstoken voor de Conversions API: Events Manager → je dataset → Instellingen → Conversions API → Toegangstoken genereren.
- Testeventcode (optioneel): staat op het tabblad Test events en begint met
TEST.
Hoe deduplicatie werkt
| Verzonden vanuit | Eventnaam | Event-ID |
|---|---|---|
| Browser-Pixel | Lead |
fbq('track', 'Lead', {}, {eventID: 'abc123'}) |
| Server (CAPI) | Lead |
"event_id": "abc123" |
Komen dezelfde naam en ID van beide kanten binnen, dan houdt Meta er één over. Verschillen de ID's, of de naam (bijvoorbeeld Lead tegenover SubmitApplication), dan wordt de lead dubbel geteld. Maak bij het versturen één ID aan in de browser en geef die aan beide door.
Wat je in het server-event zet
event_name(Lead),event_time,event_id,action_source: "website",event_source_urluser_data- ongewijzigd verzonden:
client_ip_address,client_user_agent,fbc(klik-ID-cookie),fbp(browser-ID-cookie) - gehasht met SHA-256: telefoon (
ph, cijfers met landcode, bijv. 821012345678), e-mail (em, in kleine letters), naam
- ongewijzigd verzonden:
Meer identificatoren verbeteren de Event Match Quality, maar regel eerst de toestemming.
Toestemming: gehashte gegevens blijven persoonsgegevens
Volgens de Koreaanse Personal Information Protection Act (en de meeste privacywetten) wordt een telefoonnummer niet anoniem door het te hashen, en Meta is een ontvanger in het buitenland. Een veilige opzet:
- Voeg een aparte, optionele toestemming toe voor "doorgifte naar het buitenland voor advertentiemeting": ontvanger (Meta Platforms), land, gegevens, doel, bewaartermijn.
- Voeg gehashte contactgegevens alleen toe voor mensen die akkoord gingen.
- Stuur voor alle anderen het event met alleen IP, user agent en klik-ID's.
- Stuur nooit gezondheidsgegevens zoals klachten.
Zie toestemmingstekst voor leadformulieren in Korea of maak hem met de gratis toestemmingstool.
Controleren
- Voeg de testeventcode toe en verstuur één testlead.
- In Test events zie je een Browser- en een Server-event, waarvan er één als gededupliceerd is gemarkeerd.
- Haal de testcode weg voordat je live gaat.
Uitkomsten terugsturen
Wordt een lead een consult of een verkoop, stuur dan een aangepast server-event met dezelfde gehashte identificatoren (of een externe ID). Zo kan Meta leren welke mensen verder gaan dan alleen het formulier invullen.
In CutLanding
Plak je Pixel-ID en toegangstoken bij Instellingen → Koppelen. Zodra een lead is opgeslagen, gaan de Pixel- en server-events uit met dezelfde ID, worden gehashte contactgegevens alleen toegevoegd voor mensen die toestemming gaven voor advertentiemeting, worden gezondheidsgegevens nooit verstuurd en worden mislukte verzendingen 24 uur lang opnieuw geprobeerd.
FAQ
Kan ik de Pixel weghalen en alleen de Conversions API gebruiken?
Meta raadt aan beide te gebruiken met deduplicatie. Browserdata (de cookies fbp en fbc) helpt bij het matchen, en als één kant faalt, legt de andere de lead nog vast.
Mijn leads worden dubbel geteld. Hoe kan dat?
De eventnamen of de event-ID's verschillen tussen Pixel en server. Gebruik aan beide kanten één ID per inzending en dezelfde eventnaam.
Wat als mijn toegangstoken uitlekt?
Genereer een nieuw token in Events Manager en vervang het overal waar het wordt gebruikt. Bewaar het token alleen op de server, nooit in de HTML van de pagina.