Konverterings-API:er
Rapportera dina mål till Meta, LinkedIn, TikTok och Google Ads från vår server i stället för webbläsaren, med matchning enbart via klickidentifieraren som nätverket självt har skapat.
1. Varför överhuvudtaget använda serversidan?
En webbläsarpixel måste klara tre saker innan den kan rapportera en konvertering: en annonsblockerare, en inställning mot spårning och att besökaren stänger fliken innan pixeln körs. Ett serveranrop klarar alla tre eftersom det inte sker i webbläsaren alls.
MousePlayer vet redan när ett av dina mål har nåtts. Det är det mål är till för. Anropen till konverterings-API:er skickar bara vidare det faktumet till annonsnätverket från vår server.
Detta ersätter inte din pixel. Behåll den. Varje nätverk tar bort dubbletter mellan de två och vi skickar identifierarna som behövs för det.
2. Vad vi skickar och vad vi aldrig skickar
Det enda som identifierar besökaren i anropen är cookien eller klickidentifieraren som nätverket självt har skapat. Inget annat om personen lämnar vår server.
| Nätverk | Identifierare som används | Varifrån den kommer |
|---|---|---|
| Meta | _fbp, _fbc | Förstapartscookies skapade av Meta-pixeln |
li_fat_id | Förstapartscookie skapad av LinkedIn Insight Tag | |
| TikTok | _ttp, ttclid | _ttp är en cookie, ttclid kommer från annonsklickets URL |
| Google Ads | gclid, wbraid, gbraid | Från annonsklickets URL eller cookien _gcl_aw därefter |
| Microsoft Advertising | msclkid | Från annonsklickets URL eller cookien _uetmsclkid som UET-taggen skriver |
Skickas aldrig: e-postadress, telefonnummer, namn eller IP-adress, inte ens hashade. Om besökaren saknar klickidentifierare skickas ingenting alls. En konvertering utan matchning är mindre värd än en korrekt räkning.
Bara med samtycke
Alla dessa anrop kräver samma samtycke som själva inspelningen. En session utan samtycke ger ingen konverteringsrapport, oavsett reglaget i projektinställningarna.
3. Google Ads har tre identifierare, inte en
Det här förvånar många och bör därför förklaras tydligt. Google använder gclid för ett enskilt annonsklick. När Apples spårningsskydd gör det omöjligt att attribuera ett enskilt klick skickar Google wbraid eller gbraid i stället. De representerar en grupp klick.
De tre utesluter varandra. Google avvisar en konvertering som innehåller två. Vi skickar exakt en, och gclid har företräde om flera finns eftersom den är mest exakt.
De finns bara i URL:en en gång
Identifieraren syns i adressen bara på den första sidan efter annonsklicket. Google-taggen lagrar den sedan i cookien _gcl_aw. Vi läser cookien som reserv. Utan den skulle en konvertering på besökets tredje sida sakna identifierare helt.
4. Konfiguration
Meta, LinkedIn och TikTok
Två fält vardera: pixelns eller konverteringsregelns ID och en åtkomsttoken som du skapar i nätverkets eget gränssnitt. Båda lagras krypterade med AES-256-GCM och visas aldrig igen efter att de sparats.
Google Ads behöver sex
Google är undantaget och orsaken är bra att känna till innan du börjar: till skillnad från de tre andra utfärdar Google ingen enkel åtkomsttoken. Åtkomsten går via OAuth med en uppdateringstoken, och Ads API kräver dessutom en utvecklartoken.
| Fält | Var du hittar det |
|---|---|
| Kund-ID | Uppe till höger i Google Ads. Endast siffror, utan bindestreck. |
| ID för konverteringsåtgärd | Mål och konverteringar, sedan åtgärden du vill registrera detta på. |
| Utvecklartoken | Ditt Google Ads-förvaltarkonto, API-centret. |
| OAuth-klient-ID och klienthemlighet | Google Cloud Console, Autentiseringsuppgifter, OAuth-klient av typen ”datorapp”. |
| Uppdateringstoken | Du skapar denna själv en gång för behörighetsområdet adwords. |
LinkedIn har två vägar och du vill ha den korta
I Kampanjhanteraren: Data, Signalhanteraren, Direkt API, Generera åtkomsttoken. Det är vägen för annonsörer som skickar egna data. Ingen utvecklarapp och ingen granskning behövs. Token upphör inte att gälla och Kampanjhanteraren visar den inte igen, så kopiera den direkt.
Den andra vägen, en utvecklarapp som begärs via LinkedIns Developer Portal, finns för plattformar som skickar åt många annonsörer. Den kräver verifiering av företagssidan och ett godkänt användningsfall. Inget av det behövs här.
Microsoft Advertising är det enkla alternativet
Efter Google Ads väntar du dig samma tyngd: OAuth, utvecklartoken och godkännande. Här är det tvärtom: två fält. UET-taggens ID som du redan använder i webbläsaren och en token som du kopierar från Microsoft Advertising under UET-taggen, ”Använd Conversions API”, ”Kopiera token”. Inget behöver ansökas om.
Använd samma tagg-ID som i webbläsaren. Det låter Microsoft känna igen serverhändelsen och webbläsarhändelsen som en konvertering i stället för två.
Utvecklartoken kräver Googles godkännande (”Grundläggande åtkomst”), vilket tar några dagar. Det är det enda steget du inte klarar på en minut, så börja där. Vi ser aldrig ditt Google-lösenord, bara uppdateringstoken, som du kan återkalla när som helst.
5. När en konvertering rapporteras
Exakt en gång per mål och session. MousePlayer förhindrar dubbletter innan anropet skickas, och nyttolasten innehåller dessutom ett ID så att nätverket kan ta bort dubbletter även på sin sida. En besökare som lägger fem varor i varukorgen ger en konvertering, inte fem.
Vad du ser i annonskontot
Konverteringen innehåller målets namn, dess värde och valuta om du har angett det samt tidpunkten då den inträffade. Vid normal drift kommer den fram inom en minut.
Om inget kommer fram
- Ingen klickidentifierare. Besökaren kom inte via en annons från nätverket eller kom innan pixeln hade satt sin cookie. Inget skickas. Det är väntat, inget fel.
- Inget samtycke. Samtyckeskontrollen kom först.
- Nätverket accepterade anropet men avvisade konverteringen. Google, TikTok och flera andra svarar med HTTP 200 och ett fel i svarskroppen. Vi läser innehållet, inte bara statusen, och orsaken visas i leveransloggen.
Alla nämnda varumärken tillhör respektive ägare. MousePlayer har ingen affärsrelation med leverantörerna.