Backend-tracking

Je gebruikt zogenaamde frontend-tracking, wat betekent dat de conversie/aankoop plaatsvindt op de website en jouw JavaScript de volledige tracking hiervan initieert. In sommige gevallen is er behoefte aan zogenaamde backend-tracking (ook wel server-side tracking, S2S of Server To Server genoemd). Dit kan bijvoorbeeld het geval zijn wanneer de conversie zelf niet op de website plaatsvindt. Een duidelijk voorbeeld is wanneer de adverteerder een kredietverstrekker is en de bezoeker een lening aanvraagt op de website, maar de adverteerder een commissie wil geven over de verstrekte leningen. Pas wanneer de lening wordt uitbetaald, dus enkele dagen later, vindt de conversie plaats en wordt er een transactie aangemaakt.

We ondersteunen backend-tracking.

Je kunt een POST-verzoek sturen naar https://addrevenue.io/t (dit is wat onze eigen trackingcode in JavaScript doet).

De volgende parameters moeten worden gebruikt:

Parameter	Beschrijving
type string Vereist	Conversie-gebeurtenis-ID van het commissieprogramma (meestal "Aankoop")
adverteerder-ID geheel getal Vereist	Je adverteerder-ID (in jouw geval YOUR_ADVERTISER_ID)
kanaal-ID geheel getal Vereist	De kanaal-ID (afhankelijk van wie naar je site linkt. Deze kan worden opgehaald uit de cookie addrevenue of de query string parameter channelId bij de eerste klik.
clickId string	Een willekeurige ID die wordt gegenereerd bij de eerste klik. We raden aan om de addrevenue cookie of de clickId query string parameter op te halen bij de eerste klik, omdat dit later kan worden gebruikt om te traceren welke klik tot de conversie heeft geleid.
value float	Een geheel getal of decimaal getal van de conversiewaarde, meestal het orderbedrag exclusief btw, verzendkosten en eventuele kosten.
currency string	Drieletterige valutacode volgens ISO 4217 standaard.
orderId string	Een tekenreeks met je transactie-ID, meestal het ordernummer. Als dit een aangepaste conversie zonder ordernummer is, genereer dan een unieke ID.
market string	Een tweeletterige landcode volgens de ISO 3166-1 alpha-2-standaard, bijvoorbeeld "SE" voor Zweden en "DE" voor Duitsland. Als deze waarde niet wordt doorgegeven, wordt de markt overgenomen uit de hoofdmarktinstellingen van het kanaal en de aangesloten partners.
clickRef string	Klikreferentie afkomstig van de affiliate-link. In sommige netwerken wordt dit de EPI-code genoemd. Deze string wordt door veel affiliates gebruikt voor statistieken en follow-up, en kan bijvoorbeeld worden gebruikt om een specifieke locatie voor de link te identificeren, zoals "startpage-toplist" of "insta-stories".
affiliateGclid string	Voor affiliates die zelf betaalde advertenties plaatsen, is deze parameter belangrijk, omdat deze Google Click ID wordt gebruikt voor rapportage aan het Google Ads-account van de affiliate.

 

Een voorbeeld van een POST-verzoek zou er als volgt uit kunnen zien:

Path:
POST https://addrevenue.io/t

Contenttype:
application/json

JSON-payload:
{
    "type": "Aankoop",
    "advertiserId": "YOUR_ADVERTISER_ID",
    "channelId": "123456",
    "clickId": "61f180ac133415.32320128",
    "value": 423.00,
    "currency": "SEK",
    "orderId": "W6234",
    "market": "SE",
    "clickRef": "startpage-toplist"
}

 

De bijbehorende Postback-URL zou er als volgt hebben uitgezien:
GET https://addrevenue.io/t?type=Purchase&advertiserId=YOUR_ADVERTISER_ID&channelId=123456&clickId=61f180ac133415.32320128&value=423.00¤cy=SEK&orderId=W6234&market=SE&clickRef=startpage-toplist

 

Zorg ervoor dat je de channelId, clickId en clickRef uit de addrevenue-cookie haalt of je eigen first-party cookies opslaat via de query string-parameters bij de eerste paginaweergave en deze naar je backend stuurt. Je moet dit endpoint kunnen aanroepen wanneer de vertraagde conversie plaatsvindt, bijvoorbeeld wanneer een goedgekeurde lening wordt uitbetaald.