Konverterings-API-er
Rapporter målene dine til Meta, LinkedIn, TikTok og Google Ads fra serveren vår i stedet for nettleseren — koblet utelukkende via klikkidentifikatoren nettverket selv satte.
1. Hvorfor på serversiden?
En nettleserpiksel må overleve tre ting før den kan rapportere en konvertering: en annonseblokker, en sporingsbeskyttelse og at den besøkende lukker fanen før pikselen utløses. Et serverkall overlever alle tre, fordi det overhodet ikke skjer i nettleseren.
MousePlayer vet allerede når et av målene dine er nådd — det er det mål er til for. Konverterings-API-ene videresender bare dette til annonsenettverket fra serveren vår.
Dette erstatter ikke pikselen din. Behold den. Hvert nettverk fjerner duplikater mellom de to, og vi sender identifikatorene som trengs.
2. Hva vi sender — og hva vi aldri sender
Det eneste som identifiserer den besøkende i disse kallene, er informasjonskapselen eller klikkidentifikatoren nettverket selv satte. Ingen andre personopplysninger forlater serveren vår.
| Nettverk | Identifikator som brukes | Hvor den kommer fra |
|---|---|---|
| Meta | _fbp, _fbc | Førstepartsinformasjonskapsler satt av Meta-pikselen |
li_fat_id | Førstepartsinformasjonskapsel satt av LinkedIn Insight Tag | |
| TikTok | _ttp, ttclid | _ttp er en informasjonskapsel, ttclid kommer fra annonseklikkets URL |
| Google Ads | gclid, wbraid, gbraid | Fra annonseklikkets URL eller fra informasjonskapselen _gcl_aw etterpå |
| Microsoft Advertising | msclkid | Fra annonseklikkets URL eller fra informasjonskapselen _uetmsclkid som UET-taggen skriver |
Sendes aldri: e-postadresse, telefonnummer, navn eller IP-adresse — ikke engang i hashet form. Hvis en besøkende ikke har noen klikkidentifikator, sendes ingenting. En konvertering uten tilordning er mindre verdt for deg enn en nøyaktig opptelling.
Bare med samtykke
Alle disse kallene ligger bak samme samtykkekontroll som selve opptaket. En økt uten samtykke gir ingen konverteringsrapport, uansett bryteren i prosjektinnstillingene.
3. Google Ads har tre identifikatorer, ikke én
Dette overrasker mange, så vi sier det tydelig. Google bruker gclid for et enkelt annonseklikk. Når Apples sporingsbeskyttelse gjør at enkeltklikk ikke kan tilordnes, sender Google wbraid eller gbraid i stedet; de står for en gruppe klikk.
De tre utelukker hverandre — Google avviser en konvertering med to. Vi sender nøyaktig én, og gclid vinner når flere finnes, fordi den er mest presis.
De finnes bare i URL-en én gang
Identifikatoren vises bare i adressen på den første siden etter annonseklikket. Google-taggen lagrer den deretter i informasjonskapselen _gcl_aw. Vi leser informasjonskapselen som reserve — uten den ville en konvertering på besøkets tredje side ikke funnet noen identifikator.
4. Oppsett
Meta, LinkedIn og TikTok
To felt hver: ID-en til pikselen eller konverteringsregelen, og et tilgangstoken du oppretter i nettverkets eget grensesnitt. Begge lagres AES-256-GCM-kryptert og vises aldri igjen etter lagring.
Google Ads trenger seks
Google er unntaket, og grunnen er nyttig å kjenne før du begynner: i motsetning til de tre andre gir Google ikke et enkelt tilgangstoken. Tilgangen går via OAuth med et oppdateringstoken, og Ads API krever i tillegg et utviklertoken.
| Felt | Hvor du finner det |
|---|---|
| Kunde-ID | Øverst til høyre i Google Ads. Bare tall, uten bindestrekene. |
| ID for konverteringshandling | Mål og konverteringer, deretter handlingen du vil registrere dette på. |
| Utviklertoken | Google Ads-managerkontoen din, API-senter. |
| OAuth-klient-ID og hemmelighet | Google Cloud Console, Legitimasjon, OAuth-klient av typen «skrivebordsapp». |
| Oppdateringstoken | Du genererer dette selv én gang for omfanget adwords. |
LinkedIn har to veier, og du trenger den korte
I Campaign Manager: Data, Signals Manager, Direct API, Generer tilgangstoken. Det er veien for annonsører som sender egne data — ingen utviklerapplikasjon, ingen godkjenning. Tokenet utløper ikke, og Campaign Manager viser det ikke igjen, så kopier det med en gang.
Den andre veien, en utviklerapp du søker om via LinkedIns Developer Portal, er for plattformer som sender på vegne av mange annonsører. Den krever verifisering av bedriftssiden og et godkjent bruksområde, og du trenger ingen av delene her.
Microsoft Advertising er enkelt
Etter Google Ads forventer du samme omfang — OAuth, utviklertoken, godkjenning. Det er motsatt: to felt. UET-tagg-ID-en du allerede bruker i nettleseren, og et token du kopierer fra Microsoft Advertising under UET-taggen, «Bruk Conversions API», «Kopier token». Ingenting å søke om.
Bruk samme tagg-ID som nettlesertaggen. Da kjenner Microsoft igjen serverhendelsen og nettleserhendelsen som én konvertering i stedet for to.
Utviklertokenet krever Googles godkjenning («Grunnleggende tilgang»), og det tar noen dager. Dette er det eneste trinnet du ikke kan fullføre på et minutt, så begynn med det. Vi ser aldri Google-passordet ditt — bare oppdateringstokenet, som du kan tilbakekalle når som helst.
5. Når en konvertering rapporteres
Nøyaktig én gang per mål og økt. MousePlayer fjerner gjentakelser før kallet sendes, og nyttelasten har i tillegg en ID slik at nettverket kan gjøre det samme på sin side. En besøkende som legger fem varer i handlekurven, gir én konvertering, ikke fem.
Hva du ser i annonsekontoen
Konverteringen inneholder målets navn, verdi og valuta hvis du har angitt det, og tidspunktet. Ved normal drift kommer den frem innen et minutt.
Hvis ingenting kommer frem
- Ingen klikkidentifikator. Den besøkende kom ikke via en annonse fra nettverket, eller kom før pikselen hadde satt informasjonskapselen. Ingenting sendes — dette er forventet, ikke en feil.
- Intet samtykke. Samtykkekontrollen kom først.
- Nettverket godtok kallet, men avviste konverteringen. Google, TikTok og flere andre svarer med HTTP 200 og en feil i svarinnholdet. Vi leser innholdet, ikke bare statusen, og årsaken vises i leveringsloggen.
Alle nevnte varemerker tilhører sine respektive eiere. MousePlayer har ingen forretningsforbindelse med disse leverandørene.