Wat is de Meta Conversions API (CAPI)?
De Meta Conversions API (CAPI) is de server-naar-server-interface van Meta voor het versturen van conversie-events vanaf een website, app, CRM of offline bron rechtstreeks naar Meta in plaats van via de browser-Pixel.
Elk event benoemt een action_source die beschrijft waar het plaatsvond en draagt matchbare gebruikersparameters, die worden gehasht voordat ze worden verzonden. Wanneer een server-event een Pixel-event dupliceert, gebruikt Meta event_name plus event_id om het paar te herkennen en de actie één keer te tellen.
- Elk event draagt
- een eventnaameen tijdstipeen set parameters
- website-events vereisen
- de bron-URLde client user agent
Daniil Maximkin Gepubliceerd Gecontroleerd
- In de praktijk
Hoe werkt de Conversions API?
De Conversions API verstuurt events vanaf een server, backend of CRM via HTTP naar Meta, zodat acties die de Pixel nooit heeft gezien — een aankoop buiten de site, een telefoongesprek, een CRM-order — Meta toch kunnen bereiken en in dezelfde dataset terechtkomen.
Elk event draagt een eventnaam, een tijdstip en een set parameters; website-events vereisen daarnaast de bron-URL en de client user agent, de browsercontext die Meta niet kan zien.
- In de praktijk
Waarvoor dient action_source?
action_source geeft aan waar de conversie plaatsvond, en Meta vereist het bij elk event dat via de API wordt verzonden. Het correct meesturen is een voorwaarde voor het gebruik van de API.
De geaccepteerde waarden dekken de manieren waarop een conversie kan plaatsvinden: website, app, phone call, chat, physical store, email, system-generated, business messaging en other. Een verkeerde bron stelt verkeerd voor waar de conversie vandaan kwam.
- In de praktijk
Wat zijn gehashte gebruikersparameters?
Matchparameters zijn de klantidentificatoren waarmee Meta een server-event aan een echt account kan koppelen, zoals een e-mailadres of telefoonnummer. Persoonlijk identificeerbare waarden moeten worden gehasht voordat ze worden verzonden, wat de Business SDK automatisch doet.
Meerdere onafhankelijke matchparameters versturen geeft Meta meer manieren om te bevestigen dat het event bij een echt persoon hoort, wat Event Match Quality meet.
- In de praktijk
Hoe werkt deduplicatie met de Pixel?
Meta koppelt een browserevent aan zijn serverkopie met event_name en event_id. De Pixel verstuurt de waarde als eventID en de Conversions API als event_id; de twee moeten dezelfde string zijn om als één actie te worden herkend.
Als de identifiers verschillen, kan Meta het browser- en het server-event apart tellen, wat conversies te hoog voorstelt. Als ze overeenkomen, wordt de actie één keer geteld.
- Niet te verwarren met
Niet te verwarren met Is niet Is vervanging van de Pixel De aanbevolen opzet stuurt dezelfde events via beide kanalen en dedupliceert ze De Conversions API is geen vervanging van de Pixel, en hij omzeilt geen consent of privacybescherming van browsers. De aanbevolen opzet stuurt dezelfde events via beide kanalen en dedupliceert ze, omdat elk dingen waarneemt die het andere mist.
Een server-event is niet automatisch nauwkeuriger: de matchkwaliteit hangt af van de identifiers die het draagt.
- Waar te controleren
Hoe verifieer ik server-events in Events Manager?
- Meta Events ManagerdatasetOverzicht
- Meta Events ManagerdatasetTest Events
Open Meta Events Manager en selecteer de dataset. Het Overzicht toont welke eventbronnen rapporteren, en de tool Test Events toont de parameters van een inkomend event, waaronder of het vanaf de server kwam en of het tegen de browser is gededupliceerd.
De diagnostics tonen events die aankomen zonder gedeelde identifier, het snelste signaal dat het event_id-paar ontbreekt.
