Conversie-API’s

1. Waarom via de server?

Een browserpixel moet drie hindernissen overleven voordat deze een conversie kan melden: een advertentieblokkeerder, een instelling voor trackingpreventie en een bezoeker die het tabblad sluit voordat de pixel wordt geactiveerd. Een serveraanroep overleeft alle drie, omdat deze helemaal niet in de browser plaatsvindt.

MousePlayer weet al wanneer een van uw doelen is bereikt; daar zijn doelen voor. De conversie-API’s geven dat feit simpelweg vanuit onze server door aan het advertentienetwerk.

2. Wat we versturen en wat we nooit versturen

Het enige dat de bezoeker in deze aanroepen identificeert, is de cookie of klikidentificatie die het netwerk zelf heeft geplaatst. Verder verlaat niets over die persoon onze server.

Netwerk	Gebruikte identificatie	Herkomst
Meta	_fbp, _fbc	Eigen cookies die de Meta-pixel plaatst
LinkedIn	li_fat_id	Eigen cookie die de LinkedIn Insight Tag plaatst
TikTok	_ttp, ttclid	_ttp is een cookie; ttclid komt uit de URL van de advertentieklik
Google Ads	gclid, wbraid, gbraid	Uit de URL van de advertentieklik of naderhand uit de _gcl_aw cookie
Microsoft Advertising	msclkid	Uit de URL van de advertentieklik of uit de _uetmsclkid cookie die de UET-tag schrijft

Alleen met toestemming

Elk van deze aanroepen valt onder dezelfde toestemmingscontrole als de opname zelf. Een sessie zonder toestemming levert geen conversiemelding op, ongeacht de schakelaar in uw projectinstellingen.

3. Google Ads heeft drie identificaties, niet één

Dit verrast mensen, dus we benoemen het expliciet. Google gebruikt gclid voor een afzonderlijke advertentieklik. Wanneer de trackingpreventie van Apple het onmogelijk maakt om één klik toe te wijzen, stuurt Google in plaats daarvan wbraid of gbraid mee; die staan voor een groep klikken.

De drie sluiten elkaar uit: Google weigert een conversie met twee identificaties. We sturen er precies één, en gclid krijgt voorrang als er meerdere aanwezig zijn, omdat dit de nauwkeurigste is.

Ze staan maar één keer in de URL

De identificatie staat alleen in het adres van de eerste pagina na de advertentieklik. De Google-tag slaat deze daarna op in de _gcl_aw cookie. We lezen de cookie als terugvaloptie; zonder die cookie zou een conversie op de derde pagina van het bezoek helemaal geen identificatie vinden.

4. Instellen

Meta, LinkedIn en TikTok

Elk heeft twee velden: de ID van de pixel of conversieregel en een toegangstoken dat u in de eigen interface van het netwerk maakt. Beide worden met AES-256-GCM versleuteld opgeslagen en na het opslaan nooit meer getoond.

Google Ads heeft er zes nodig

Google is de uitzondering, en het is goed om vooraf te weten waarom: anders dan de andere drie verstrekt Google geen eenvoudig toegangstoken. Toegang verloopt via OAuth met een vernieuwingstoken, en de Ads API vereist bovendien een ontwikkelaarstoken.

Veld	Waar u het vindt
Klant-ID	Rechtsboven in Google Ads. Alleen cijfers, zonder streepjes.
Conversieactie-ID	Doelen en conversies, en vervolgens de actie waarop u deze conversie wilt boeken.
Ontwikkelaarstoken	Uw Google Ads-manageraccount, API-centrum.
OAuth-client-ID en clientgeheim	Google Cloud Console, Inloggegevens, OAuth-client van het type “desktop-app”.
Vernieuwingstoken	Dit genereert u eenmalig zelf voor het bereik adwords.

LinkedIn heeft twee routes; kies de korte

In Campaign Manager: Gegevens, Signals Manager, Direct API, Toegangstoken genereren. Dat is de route voor adverteerders die hun eigen gegevens versturen: geen ontwikkelaarsapp, geen beoordeling. Het token verloopt niet, en Campaign Manager toont het geen tweede keer, dus kopieer het meteen.

De andere route, een ontwikkelaarsapp aangevraagd via het Developer Portal van LinkedIn, is bedoeld voor platforms die namens veel adverteerders versturen. Daarvoor zijn verificatie van de bedrijfspagina en een goedgekeurde toepassing nodig. Hier hebt u dat allemaal niet nodig.

Microsoft Advertising is de eenvoudige optie

Na Google Ads verwacht u dezelfde zwaarte: OAuth, een ontwikkelaarstoken en een goedkeuringsstap. Het tegendeel is waar: twee velden. De ID van de UET-tag die u al in de browser gebruikt en een token dat u in Microsoft Advertising kopieert onder de UET-tag, “Conversions API gebruiken”, “Token kopiëren”. U hoeft niets aan te vragen.

Gebruik dezelfde tag-ID als uw browsertag. Daarmee herkent Microsoft de gebeurtenis van de server en die van de browser als één conversie in plaats van twee.

5. Wanneer een conversie wordt gemeld

Precies één keer per doel en sessie. MousePlayer voorkomt dubbele meldingen voordat de aanroep wordt verstuurd, en de payload bevat bovendien een ID waarmee het netwerk dat aan zijn kant nogmaals kan doen. Een bezoeker die vijf artikelen aan de winkelwagen toevoegt, levert één conversie op, geen vijf.

Wat u in uw advertentieaccount ziet

De conversie bevat de naam van uw doel, de waarde en valuta als u die hebt ingesteld, en het tijdstip waarop het doel werd bereikt. Bij normaal gebruik komt deze binnen een minuut aan.

Als er niets aankomt

• Geen klikidentificatie. De bezoeker kwam niet via een advertentie van dat netwerk, of arriveerde voordat de pixel zijn cookie had geplaatst. Er wordt niets verstuurd; dat is verwacht gedrag, geen fout.
• Geen toestemming. De toestemmingscontrole gaat voor.
• Het netwerk accepteerde de aanroep, maar weigerde de conversie. Google, TikTok en verschillende andere netwerken antwoorden met HTTP 200 en een fout in de antwoordtekst. We lezen de inhoud, niet alleen de status, en de reden verschijnt in het afleverlogboek.