Visites côté serveur

Quand l’utiliser

Quand vous ne pouvez pas placer la balise sur une page, ou que vous voulez que votre serveur décide de ce qui compte comme visite. Votre serveur déclare la visite et reçoit en retour la visite signée à garder.

L’appel

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 de la page d’atterrissage (le linkId du lien) ; source : l’ID partenaire (le sourceId du lien) ; subIds : les sub IDs s1–s5 (les affS1–affS5 du lien).
• ip et userAgent : ceux du visiteur, pour que robots et limites soient vérifiés comme pour la balise.
• En option country, region et city quand votre serveur les connaît déjà ; sinon ils viennent de l’adresse IP.

link, ip et userAgent sont obligatoires. Omettez source pour les liens propres à votre équipe : ils comptent pour l’espace de travail, sans partenaire.

La réponse contient le hit signé (et expiresAt, quand il cesse de compter) à envoyer plus tard avec la conversion. Des champs manquants renvoient missing_params ; une mauvaise adresse IP invalid_ip_address.

Bon à savoir

• Les mêmes vérifications que pour la balise s’appliquent : partenaire, page d’atterrissage, offre, accès, robots et limites.
• Utilisez une clé API de Paramètres › Développeurs. Quand la clé a une liste d’IP autorisées, seules ces adresses peuvent appeler.