Серверні переходи

Коли це потрібно

Коли не можна поставити код на сторінку або ви хочете, щоб ваш сервер вирішував, що вважається відвідуванням. Сервер повідомляє про відвідування і отримує підписаний перехід, який треба зберегти.

Виклик

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 цільової сторінки (linkId посилання); source: ID партнера (sourceId посилання); subIds: sub ID s1–s5 (affS1–affS5 посилання).
• ip і userAgent: дані відвідувача, щоб боти і ліміти перевірялися так само, як для коду.
• Необов'язкові country, region і city, якщо сервер уже їх знає; інакше вони беруться з IP-адреси.

link, ip і userAgent обов'язкові. Не вказуйте source для власних посилань команди: вони зараховуються робочому простору, без партнера.

Відповідь містить підписаний hit (і expiresAt — коли він перестане зараховуватися), який треба пізніше надіслати з конверсією. Пропущені поля дають missing_params; неправильна IP-адреса — invalid_ip_address.

Корисно знати

• Діють ті самі перевірки, що й для коду: партнер, цільова сторінка, офер, доступ, боти і ліміти.
• Використовуйте API-ключ із Налаштування › Розробникам. Якщо ключ має список дозволених IP, викликати можуть лише ці адреси.