Конверсії (Postback)
Постбек — це HTTP-запит для передачі конверсій між різними системами.
Вхідний постбек (від CPA)
URL для партнерки:
https://adset.pro/postback/?clickId={click_id}&status={status}&revenue={payout}
Параметри запиту
Параметр | Обов'язковий | Опис |
|---|---|---|
| Так | ID кліка з партнерської мережі |
| Так | Статус конверсії (мапиться на внутрішні події) |
| Ні | Сума виплати (revenue) |
| Ні | Валюта виплати (опціонально) |
| Ні | ID конверсії |
| Ні | Статус депозиту (опціонально, див. нижче) |
| Ні | Статус реєстрації (опціонально, див. нижче) |
| Ні | Статус повторного депозиту (опціонально, див. нижче) |
| Ні | Статус скасування депозиту (опціонально, див. нижче) |
Маппінг статусів
Статуси налаштовуються в розділі Партнерські мережі → Налаштування → Статуси конверсій:
Поле | Внутрішня подія | Опис |
|---|---|---|
FTD (accept) |
| Перший депозит |
Re-Deposit (redep) |
| Повторний депозит |
Registration (hold) |
| Реєстрація |
Decline |
| Відхилена конверсія |
Trash |
| Сміттєва конверсія |
В URL постбека через параметри accept_status, hold_status, redep_status, decline_status можна явно вказати відповідність статусу в параметрі status
Повторні депозити (Re-Deposit)
Є два способи передати Re-Deposit:
Явний статус — партнерська мережа передає окремий статус, смаплений в полі
redepналаштувань CPA. Можна також передавати через окремий query-параметрredep_status.Авто-визначення — якщо приходить звичайний
accept-статус, але для даногоclickIdвже є успішний депозит (CPA_ACCEPT), система автоматично перекласифікує подію вCPA_REDEP.
Дедуплікація конверсій
За замовчуванням система відхиляє дубльовані конверсії (однаковий clickId + тип події). Налаштування дедуплікації:
Accept duplicate conversions — дозволити прийом дублів для вибраних типів
Accept duplicates for — вибрати типи конверсій, для яких дозволені дублі (наприклад,
Депозит,Реєстрація)
Якщо передається external_id — дедуплікація враховує його: конверсії з різними external_id не вважаються дублями.
Сценарій | externalId | Дублі для типу дозволені | Результат |
|---|---|---|---|
1-й редеп для clickId | — | — | ✅ Проходить |
2-й редеп, той же clickId | Однаковий/ні | Ні | ❌ Дубль |
2-й редеп, той же clickId | Різний | Ні | ✅ Проходить |
2-й редеп, той же clickId | — | Так | ✅ Проходить |