Отправка конверсии
Когда происходит продажа или регистрация, ваш сервер отправляет её вместе с переходом; позже он может изменить статус, например при возврате.
Вызов
POST https://<your workspace address>/track/conversions
x-api-key: your API key
Content-Type: application/json
{
"hit": "h1.…",
"conversionTypeCode": "sale",
"externalId": "order-1042",
"amount": { "value": 49.90 },
"currency": "EUR"
}
| Поле | |
|---|---|
hit |
Подписанный переход из cookie hitctrl (или из серверного перехода). |
conversionTypeCode |
Обязательно. Код типа конверсии, например sale. |
externalId |
ID вашего заказа или транзакции. Один и тот же засчитывается один раз, поэтому повтор безопасен. |
amount.value, currency |
Сумма продажи; нужна для процентных выплат. Другая валюта пересчитывается по курсу дня. |
exchangeRate |
Ваш собственный курс к валюте рабочего пространства, если оно его принимает. |
couponCodes |
Использованные коды купонов; партнёр купона получает продажу раньше перехода. |
externalClientId |
Зарегистрированный вами клиент; продажа засчитывается партнёру перехода этого клиента. |
country |
Страна покупателя (две буквы); продажа оценивается по ней вместо страны перехода. |
customParams.advS1–advS5 |
Ваши собственные значения; их могут использовать группы выплат и правила против фрода. |
status |
approved, pending или test; не указывайте — будет то, что задаёт цель оффера. |
Обязательно одно из hit, couponCodes или externalClientId. Вызов работает и как GET с теми же значениями в адресе.
Изменение статуса позже
POST https://<your workspace address>/track/conversions/status
{ "externalId": "order-1042", "status": "refunded" }
status — это approved, pending, rejected или refunded. Добавьте conversionTypeCode, если у одного заказа конверсии нескольких типов.
Пиковая нагрузка
Отправьте заголовок Prefer: respond-async: ответ — сразу 202, а конверсия записывается чуть позже.
Это ответило на ваш вопрос?
Сверено с приложением 18 октября 2026 г.