Konversions-API'er

1. Hvorfor overhovedet serversiden?

En browserpixel skal overvinde tre ting, før den kan rapportere en konvertering: en annonceblokker, en indstilling mod sporing og en besøgende, der lukker fanen, før pixlen aktiveres. Et kald på serversiden overvinder alle tre, fordi det slet ikke sker i browseren.

MousePlayer ved allerede, hvornår et af dine mål er nået - det er formålet med mål. Konversions-API'erne videresender blot dette til annoncenetværket fra vores server.

2. Hvad vi sender - og hvad vi aldrig sender

Det eneste, der identificerer den besøgende i disse kald, er den cookie- eller klikidentifikator, netværket selv har sat. Intet andet om personen forlader vores server.

Netværk	Anvendt identifikator	Hvor kommer den fra
Meta	_fbp, _fbc	Førstepartscookies sat af Meta-pixlen
LinkedIn	li_fat_id	Førstepartscookie sat af LinkedIn Insight Tag
TikTok	_ttp, ttclid	_ttp er en cookie, ttclid kommer fra annonceklikkets URL
Google Ads	gclid, wbraid, gbraid	Fra annonceklikkets URL eller senere fra _gcl_aw-cookien
Microsoft Advertising	msclkid	Fra annonceklikkets URL eller fra _uetmsclkid-cookien, som UET-tagget skriver

Kun med samtykke

Hvert af disse kald kræver samme samtykke som selve optagelsen. En session uden samtykke giver ingen konversionsrapport, uanset kontakten i dine projektindstillinger.

3. Google Ads har tre identifikatorer, ikke én

Det overrasker mange, så det skal siges tydeligt. Google bruger gclid til et enkelt annonceklik. Når Apples sporingsbeskyttelse gør det umuligt at tilskrive et enkelt klik, sender Google wbraid eller gbraid i stedet; de repræsenterer en gruppe klik.

De tre udelukker hinanden - Google afviser en konvertering med to. Vi sender præcis én, og gclid prioriteres, hvis flere findes, fordi den er mest præcis.

De findes kun én gang i URL'en

Identifikatoren vises kun i adressen på den første side efter annonceklikket. Google-tagget gemmer den derefter i _gcl_aw-cookien. Vi læser cookien som reserve - uden den ville en konvertering på besøgets tredje side slet ikke finde en identifikator.

4. Opsætning

Meta, LinkedIn og TikTok

To felter hver: ID'et for pixlen eller konverteringsreglen og et adgangstoken, du opretter i netværkets egen grænseflade. Begge lagres krypteret med AES-256-GCM og vises aldrig igen efter lagring.

Google Ads kræver seks

Google er undtagelsen, og det er godt at kende årsagen, før du starter: i modsætning til de tre andre udsteder Google intet enkelt adgangstoken. Adgangen bruger OAuth med et opdateringstoken, og Ads API kræver desuden et udviklertoken.

Felt	Hvor finder du det
Kunde-ID	Øverst til højre i Google Ads. Kun cifre uden bindestreger.
Konverteringshandlings-ID	Mål og konverteringer, derefter den handling, dette skal registreres på.
Udviklertoken	Din Google Ads-managerkonto, API-center.
OAuth-klient-ID og klienthemmelighed	Google Cloud Console, Legitimationsoplysninger, OAuth-klient af typen »computerapp«.
Opdateringstoken	Du genererer selv dette én gang til omfanget adwords.

LinkedIn har to veje, og du skal bruge den korte

I Campaign Manager: Data, Signals Manager, Direct API, Generer adgangstoken. Det er vejen for annoncører, der sender egne data - ingen udviklerapplikation, ingen gennemgang. Tokenet udløber ikke, og Campaign Manager viser det ikke igen, så kopiér det straks.

Den anden vej, en udviklerapp bestilt via LinkedIns Developer Portal, er til platforme, der sender på vegne af mange annoncører. Den kræver bekræftelse af virksomhedssiden og et godkendt anvendelsesformål; intet af dette behøver du her.

Microsoft Advertising er den nemme

Efter Google Ads forventer du samme omfang - OAuth, udviklertoken og godkendelse. Det modsatte gælder: to felter. Det UET-tag-ID, du allerede bruger i browseren, og et token, du kopierer i Microsoft Advertising under UET-tagget, »Brug Conversions API«, »Kopiér token«. Intet at ansøge om.

Brug samme tag-ID som i dit browsertag. Så kan Microsoft genkende serverhændelsen og browserhændelsen som én konvertering i stedet for to.

5. Hvornår rapporteres en konvertering

Præcis én gang pr. mål og session. MousePlayer fjerner dubletter, før kaldet sendes, og dataene indeholder desuden et ID, så netværket kan gøre det samme på sin side. En besøgende, der lægger fem varer i kurven, giver én konvertering, ikke fem.

Hvad ser du på din annoncekonto

Konverteringen indeholder dit måls navn, dets værdi og valuta, hvis du har angivet en, samt tidspunktet. Ved normal drift ankommer den inden for et minut.

Hvis intet ankommer

• Ingen klikidentifikator. Den besøgende kom ikke via en annonce fra netværket eller ankom, før pixlen havde sat sin cookie. Intet sendes - det er forventet, ikke en fejl.
• Intet samtykke. Samtykkekravet kom først.
• Netværket accepterede kaldet, men afviste konverteringen. Google, TikTok og flere andre svarer med HTTP 200 og en fejl i svarindholdet. Vi læser indholdet, ikke kun status, og årsagen vises i leveringsloggen.