Постбеки
Настройте postback-URL на событие в разделе Postbacks портала. Когда на вашем трафике происходит подходящая конверсия, мы делаем server-side HTTP GET на ваш URL с раскрытыми макросами. Доставки логируются (код ответа, успех/ошибка) для дебага.
События
| Событие | Срабатывает когда |
|---|---|
REGISTRATION | Новый игрок зарегистрировался на вашем домене. |
DEPOSIT | Депозит игрока подтверждён. |
Макросы
Любой из этих токенов в URL заменяется при доставке:
| Макрос | Значение |
|---|---|
{clickid} | Ваш click/sub id, снятый на лендинге (пусто для органики). |
{event} | registration | deposit |
{amount} | Сумма депозита (для депозитов). |
{currency} | Валюта депозита. |
{txid} | ID транзакции депозита. |
{userid} | Наш внутренний ID лида. |
{domain} | Домен, на котором зарегистрировался игрок. |
{geo} | Страна игрока (ISO-3166 alpha-2). |
{promo} | Код кампании, с которым зарегистрировался игрок. |
Пример
Шаблон постбека (настраивается в портале)
https://track.youraffiliate.com/postback?cid={clickid}&type={event}&payout={amount}&cur={currency}&txid={txid}
Что мы вызываем при подтверждённом депозите
GET https://track.youraffiliate.com/postback?cid=abc123&type=deposit&payout=50&cur=USDT&txid=dep_9f2c
Семантика доставки
- Доставка —
GET, ретраи с backoff при ошибке; ответ2xxсчитается доставленным. - Все значения макросов URL-кодируются нами — не кодируйте их в шаблоне заранее.
- Ваш endpoint должен быть на публичном хосте — приватные/внутренние адреса отклоняются.
- Постбеки — best-effort с ретраями и никогда не блокируют игрока. Для сверки и бэкфилла тяните те же события из
GET /v1/conversions.
подсказка
Нужен только realtime-сигнал для CAPI? Постбек несёт {clickid} + сумму + валюту — достаточно, чтобы отправить server-side конверсию из вашего бэкенда, где у вас уже есть fbp/fbc посетителя.