Serverseitige Hits

Wann Sie es nutzen

Wenn Sie das Tag nicht auf eine Seite setzen können oder Ihr Server entscheiden soll, was als Besuch zählt. Ihr Server meldet den Besuch und bekommt den signierten Hit zum Aufbewahren zurück.

Der Aufruf

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: die ID der Zielseite (die linkId des Links); source: die Partner-ID (die sourceId des Links); subIds: die Sub-IDs s1–s5 (die affS1–affS5 des Links).
• ip und userAgent: die des Besuchers, damit Bots und Limits wie beim Tag geprüft werden.
• Optional country, region und city, wenn Ihr Server sie schon kennt; sonst kommen sie aus der IP-Adresse.

link, ip und userAgent sind Pflicht. Lassen Sie source für die eigenen Links Ihres Teams weg: Sie zählen für den Workspace, ohne Partner.

Die Antwort enthält den signierten hit (und expiresAt, wann er nicht mehr zählt), den Sie später mit der Conversion senden. Fehlende Felder ergeben missing_params; eine falsche IP-Adresse invalid_ip_address.

Gut zu wissen

• Es gelten dieselben Prüfungen wie beim Tag: Partner, Zielseite, Angebot, Zugang, Bots und Limits.
• Nutzen Sie einen API-Schlüssel aus Einstellungen › Entwickler. Hat der Schlüssel eine IP-Freigabeliste, dürfen nur diese Adressen aufrufen.