Server-side hits

Wanneer je het gebruikt

Als je de tag niet op een pagina kunt zetten, of je server wilt laten beslissen wat als bezoek telt. Je server meldt het bezoek en krijgt de ondertekende hit terug om te bewaren.

De aanroep

POST https://go.hitctrl.com/hits
x-api-key: your API key

{
  "link": "lp_7Kq2",
  "source": "jane-doe",
  "subIds": { "s1": "summer", "s2": "banner-a" },
  "ip": "203.0.113.7",
  "userAgent": "Mozilla/5.0 …",
  "referrer": "https://news.example/"
}

• link: de ID van de landingspagina (de linkId van de link); source: de partner-ID (de sourceId van de link); subIds: de sub-ID's s1–s5 (de affS1–affS5 van de link).
• ip en userAgent: die van de bezoeker, zodat bots en limieten worden gecontroleerd zoals bij de tag.
• Optioneel country, region en city als je server ze al kent; anders komen ze uit het IP-adres.

link, ip en userAgent zijn verplicht. Laat source weg voor de eigen links van je team: die tellen voor de workspace, zonder partner.

Het antwoord bevat de ondertekende hit (en expiresAt, wanneer hij niet meer telt) om later met de conversie te sturen. Ontbrekende velden geven missing_params; een fout IP-adres invalid_ip_address.

Goed om te weten

• Dezelfde controles gelden als bij de tag: partner, landingspagina, aanbieding, toegang, bots en limieten.
• Gebruik een API-sleutel uit Instellingen › Ontwikkelaars. Heeft de sleutel een IP-toegangslijst, dan mogen alleen die adressen aanroepen.