Server-side tracking

Server-side tracking, ibland kallat S2S eller backend tracking, innebär att konverteringar skickas direkt från er server till Addrevenue istället för via besökarens webbläsare.

Detta skiljer sig från client-side tracking, även kallat frontend tracking, där spårningen sker via JavaScript i webbläsaren. Client-side tracking är ofta enklare att komma igång med, men är samtidigt mer beroende av webbläsarmiljön. Server-side tracking ger er större kontroll över när och hur en konvertering skickas in, och är därför ofta ett bra val när spårningen behöver vara mer robust eller när själva konverteringen sker senare i processen.

När ska man använda server-side tracking?

Server-side tracking används ofta för så kallade offline conversions, det vill säga när konverteringen inte sker direkt på webbplatsen.

Det kan till exempel vara när en användare skickar in en ansökan online, men där själva affären sker vid ett senare tillfälle. Ett vanligt exempel är inom finans, där en besökare ansöker om ett lån på webbplatsen, men där provisionen baseras på utbetalda lån. I ett sådant fall sker konverteringen först när lånet faktiskt betalas ut, vilket ofta är flera dagar senare.

Men server-side tracking är minst lika relevant för vanliga onlineköp. Genom att flytta konverteringsspårningen till er server minskar beroendet av webbläsaren, vilket ofta ger mer stabil och konsekvent datainsamling.

Mer robust datakvalitet
Färre tappade konverteringar
Bättre konsistens mellan system

Hur det fungerar

Flödet är i grunden:

En användare klickar på en affiliate-länk.
Addrevenue registrerar klicket och genererar ett clickId.
Användaren landar på er webbplats med clickId, advertiserId och channelId som parametrar i URL:en.
Ni sparar dessa värden i er egen miljö kopplat till sessionen.
När en konvertering sker skickar er server en postback tillbaka till Addrevenue.

Det är viktigt att ni sparar samtliga tre värden, clickId, advertiserId och channelId, så att de kan skickas med vid konverteringstillfället.

Lagring på er server

Hur ni väljer att lagra datan är upp till er implementation, men några generella riktlinjer är ofta bra att följa:

Spara alltid clickId, advertiserId och channelId.
Koppla värdena till session, order, kund eller annan relevant server-side identitet.
Säkerställ att datan överlever hela köpresan, även om den består av flera steg.
Se till att lagringen fungerar vid edge cases, till exempel återbesök eller gärna flera enheter, så kallad cross-device, om möjligt.
Undvik att lagra mer data än nödvändigt.

Ofta används en kombination av server-side session, egen first-party cookie och senare koppling till order eller kund.

Redirect-parametrar till er webbplats

När trafiken skickas från Addrevenue till er webbplats skickas normalt parametrar med i redirecten, så att ni kan spara dem för senare användning i postbacken.

De viktigaste parametrarna att fånga upp är:

clickId
advertiserId
channelId

Vi kan även anpassa både parametrarnas namn och vilka parametrar som skickas i redirecten till er webbplats. Det är ofta viktigt om ni använder befintliga system eller tredjepartsverktyg för server-side tracking som förväntar sig andra namn, till exempel egna interna parametrar eller format som liknar adv_sub, aff_sub2 eller aff_click_id.

Parametrarnas namn i postbacken tillbaka till Addrevenue är däremot mer strikt, och måste följa vårt schema nedan.

Skicka postback till Addrevenue

För server-side tracking skickar ni en request till:

https://addrevenue.io/t

Det kan göras antingen som POST med JSON payload eller som GET med parametrar i URL:en. För enklare implementationer kan båda fungera, men om ni vill skicka mer avancerad data, till exempel produktlistor, är JSON payload det tydligaste alternativet.

Parametrar

Obligatoriska parametrar

type
För de flesta e-handlare är detta Purchase, men kan vara vilken sträng som helst så länge den matchar Conversion Event ID i ert provisionsprogram på vår plattform.
orderId
En unik identifierare för konverteringen. Används för deduplicering och identifiering mellan plattformarna.
clickId
Identifierar klicket som ska attribueras.
advertiserId
Ert annonsörs-ID hos Addrevenue.
channelId
ID för den affiliatekanal som skickade trafiken.

Villkorliga parametrar

value
Konverteringsvärdet, normalt orderbeloppet.
currency
Valutakod enligt ISO 4217, till exempel SEK eller EUR.

Dessa är obligatoriska om ni använder variabel provisionstyp, som då baseras på ordervärdet.

Valfri parameter

market
Landskod, normalt enligt ISO 3166-1 alpha-2, till exempel SE eller DE.

Om den saknas försöker vi härleda marknaden från användaren och första klicket.

Valfria parametrar för e-handel

För e-handlare finns det även några utökade, valfria parametrar som kan vara relevanta beroende på hur er setup ser ut.

Rabattkoder

discountCodes kan skickas som en kommaseparerad lista med de rabattkoder som har använts i köpet.

Detta används främst för rabattkodsspårning, det vill säga när ett köp kan attribueras via en rabattkod även om något klick inte har registrerats. Ett typiskt exempel är när en affiliate publicerar en exklusiv rabattkod i ett inlägg eller på sociala medier utan att samtidigt länka till webbplatsen.

Produkter

Det finns även möjlighet att skicka med hela varukorgen i parametern products.

products skickas som en array av objekt, där varje objekt ska innehålla properties som till exempel:

item_id
item_name
price
quantity
category

Syftet är dels att ni som annonsör kan få statistik per produkt, dels att ni kan skapa regelbaserade provisionsprogram med olika provision för enskilda produkter.

Eftersom products är en mer komplex datastruktur lämpar den sig bäst för postback via JSON payload, snarare än via GET-parametrar.

Både discountCodes och products är valfria och främst relevanta för e-handlare.

Exempel på GET

Data skickas som parametrar i URL:en i en GET-request:

https://addrevenue.io/t?type=Purchase&advertiserId=YOUR_ADVERTISER_ID&channelId=123456&clickId=61f180ac133415.32320128&value=423.00&currency=SEK&orderId=W6234&market=SE

Exempel på POST med JSON payload

Data skickas i JSON-format som en POST-request till:

https://addrevenue.io/t

med header:

Content-Type: application/json

och JSON-body enligt nedan:

{
	"type": "Purchase",
	"advertiserId": "YOUR_ADVERTISER_ID",
	"channelId": "123456",
	"clickId": "61f180ac133415.32320128",
	"value": 423.00,
	"currency": "SEK",
	"orderId": "W6234",
	"market": "SE"
}

Exempel på POST med utökad e-handelsdata

Om ni vill skicka med rabattkoder och produktdata är POST med JSON payload att föredra:

{
	"type": "Purchase",
	"advertiserId": "YOUR_ADVERTISER_ID",
	"channelId": "123456",
	"clickId": "61f180ac133415.32320128",
	"value": 423.00,
	"currency": "SEK",
	"orderId": "W6234",
	"market": "SE",
	"discountCodes": "SPRING20,INFLUENCER10",
	"products": [
		{
			"item_id": "SKU-123",
			"item_name": "Running Shoes",
			"price": 299.00,
			"quantity": 1,
			"category": "Shoes"
		},
		{
			"item_id": "SKU-456",
			"item_name": "Sports Socks",
			"price": 124.00,
			"quantity": 1,
			"category": "Accessories"
		}
	]
}

Integration med befintliga system

Om ni redan använder ett verktyg eller en plattform för server-side tracking går det i de flesta fall att integrera med Addrevenue utan större förändringar.

Så länge nödvändig data kan skickas vidare i postbacken kan vi ofta anpassa redirecten till det format ni behöver, samtidigt som postbacken till oss följer vårt schema.

Plattformsstöd

Våra plugins för WooCommerce och Shopify kommer inom kort att ha server-side tracking som standard. För många innebär det att implementationen kan göras med betydligt mindre egen utveckling.

Sammanfattning

Server-side tracking är ett flexibelt och robust sätt att rapportera konverteringar till Addrevenue, både för fördröjda konverteringar och för vanlig e-handel.

Det viktigaste i implementationen är att ni fångar upp och sparar clickId, advertiserId och channelId när användaren landar på er webbplats, och att dessa skickas tillbaka till Addrevenue när konverteringen sker.

För e-handlare finns det också möjlighet att komplettera med discountCodes och products när det finns behov av rabattkodsspårning, produktstatistik eller mer detaljerade provisionsregler.

Skapa konto

Välj den kontotyp som bäst passar din profil