Конверсии (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 | — | Да | ✅ Проходит |