Visite lato server

Quando usarlo

Quando non puoi mettere il tag in una pagina, o vuoi che sia il tuo server a decidere cosa conta come visita. Il tuo server comunica la visita e riceve in cambio la visita firmata da conservare.

La chiamata

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: l’ID della pagina di destinazione (il linkId del link); source: l’ID partner (il sourceId del link); subIds: i sub ID s1–s5 (gli affS1–affS5 del link).
• ip e userAgent: quelli del visitatore, perché bot e limiti vengano controllati come per il tag.
• Facoltativi country, region e city quando il tuo server li conosce già; altrimenti vengono dall’indirizzo IP.

link, ip e userAgent sono obbligatori. Ometti source per i link del tuo team: contano per il workspace, senza partner.

La risposta contiene il hit firmato (e expiresAt, quando smette di contare) da inviare poi con la conversione. Campi mancanti rispondono missing_params; un indirizzo IP sbagliato invalid_ip_address.

Buono a sapersi

• Valgono gli stessi controlli del tag: partner, pagina di destinazione, offerta, accesso, bot e limiti.
• Usa una chiave API di Impostazioni › Sviluppatori. Quando la chiave ha un elenco di IP consentiti, solo quegli indirizzi possono chiamare.