Wejścia po stronie serwera

Kiedy tego użyć

Gdy nie możesz umieścić kodu na stronie albo chcesz, aby Twój serwer decydował, co liczy się jako wizyta. Serwer zgłasza wizytę i dostaje podpisane wejście, które trzeba zachować.

Wywołanie

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: ID strony docelowej (linkId linku); source: ID partnera (sourceId linku); subIds: sub ID s1–s5 (affS1–affS5 linku).
• ip i userAgent: dane odwiedzającego, aby boty i limity były sprawdzane tak samo jak dla kodu.
• Opcjonalnie country, region i city, jeśli serwer już je zna; w przeciwnym razie pochodzą z adresu IP.

link, ip i userAgent są wymagane. Pomiń source dla własnych linków zespołu: liczą się do przestrzeni roboczej, bez partnera.

Odpowiedź zawiera podpisany hit (i expiresAt, kiedy przestanie się liczyć), który trzeba później wysłać z konwersją. Brakujące pola dają missing_params; błędny adres IP daje invalid_ip_address.

Dobrze wiedzieć

• Obowiązują te same sprawdzenia co dla kodu: partner, strona docelowa, oferta, dostęp, boty i limity.
• Użyj klucza API z Ustawienia › Dla programistów. Jeśli klucz ma listę dozwolonych IP, wywoływać mogą tylko te adresy.