Исходящие постбеки

Исходящий постбек — это запрос Telegfy в рекламную сеть или трекер, когда конверсия записана. Так источник трафика узнаёт, что клик принёс продажу, и может оптимизировать кампании.

Настройка источника (адрес, макросы, условия) описана в Источниках трафика. Здесь — как всё работает внутри.

Когда уходит постбек

1. Записана новая конверсия или обновлён её статус.
2. Telegfy находит источник клика. Если его нет и в воркспейсе один активный источник, берёт его.
3. Проверяются условия источника: статус и минимальная выплата. Статусы в условиях — наши (лид, продажа, отклонена, ребилл, апсейл), а не статусы ПП.
4. Постбек ставится в очередь со статусом «В очереди».
5. Очередь разбирается раз в минуту. Запрос уходит, результат попадает в лог источника.

Где настраивается

Источник создаётся в «Источники трафика» (/dashboard/offers/traffic-sources). В поле «URL постбэка» по умолчанию стоит пример https://tracker.source.com/postback?clickid={sub_id_1}&payout={payout}. Под полем подсказка со всеми макросами: {click_id}, {status}, {payout}, {currency}, {conversion_id}, {external_id}, {sub_id_1} … {sub_id_10}.

1. URL постбэка с макросами в одинарных фигурных скобках.
2. Статусы, при которых отправлять. Пусто — при любом статусе.
3. Минимальная выплата.

Один постбек на статус

Для пары «конверсия + источник + статус» отправляется один постбек. Если статус не меняется, повторно ничего не уходит. Если статус меняется (лид → продажа), уходит второй постбек с новым статусом.

Поэтому источник, которому нужна только продажа, должен ставить в условиях статус «Продажа». Иначе он получит лид и продажу как два разных события.

Формат запроса

• Метод GET. Тела запроса нет, все данные в URL.
• Таймаут 5 секунд.
• Редиректы не отслеживаются. Ответ 3xx считается ошибкой. Укажите финальный адрес.
• Только http и https. Приватные IP-адреса запрещены.

Повторы

Если источник ответил ошибкой или не ответил, Telegfy повторяет отправку. Всего до 6 попыток с паузами 1 минута, 5 минут, 25 минут, 2 часа и 10 часов. После этого состояние становится «Ошибка».

Состояние видно в логе источника: «В очереди», «Отправлен», «Ошибка», с кодом ответа и номером попытки.

Что проверять, если постбек не дошёл

Признак	Что посмотреть
Постбеков в логе нет	Есть ли источник у ссылки клика. Активен ли источник. Подходят ли условия по статусу и выплате.
Состояние «В очереди» не меняется	Очередь разбирается раз в минуту. Если состояние висит долго, проверьте источник и обратитесь в поддержку.
Код ответа 4xx или 5xx	Правильный ли URL и макросы. Нужен ли источнику другой параметр.
Ошибка сразу	Адрес отклонён: приватный IP, не http или https, или редирект.

Подробнее — в Решении проблем.

Что уходит в источник

Все значения подставляются в макросы при отправке. Полный список макросов — в Источниках трафика.

Наш click id ({click_id}) и click id источника ({sub_id_1}) — разные вещи. Если источник хочет получить свой click id, передайте его в ссылку как sub_id и используйте {sub_id_1}.

Несколько источников в воркспейсе

Если в воркспейсе больше одного активного источника, а у ссылки источник не выбран, постбек не уйдёт никуда. Назначьте источник каждой ссылке, которая должна возвращать конверсии.

Что читать дальше

• Источники трафика — настройка адреса, макросов и условий.
• Входящие постбеки — откуда приходят конверсии.
• Conversion API — отправка в рекламные площадки через API, а не постбеком.