Источники трафика

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

Источник не отвечает за атрибуцию. Он нужен только для возврата конверсий.

Как клик связан с источником

Связь задаётся в ссылке: в поле «Источник трафика» при создании или редактировании ссылки. Клик запоминает источник своей ссылки. Постбек уходит только в источник клика. Если у клика источника нет и в воркспейсе ровно один активный источник, постбек уходит в него. Если активных источников несколько, а у клика нет источника, постбек никуда не отправляется.

Создание источника

Откройте «Источники трафика» (/dashboard/offers/traffic-sources) и нажмите «Новый источник».

• Название — для вас, например «PropellerAds — пуш».
• URL постбэка — адрес, на который Telegfy будет делать GET-запрос. Макросы пишутся в одинарных фигурных скобках.
• Отправлять при статусе конверсии — если выбрано, постбек уходит только при этих статусах: «Лид», «Продажа», «Отклонена», «Ребилл», «Апсейл». Если ничего не выбрано, уходит при любом статусе.
• Минимальная выплата — постбек уходит, только если выплата не меньше указанной. Если выплаты нет, постбек не отправляется.
• Активен — неактивный источник не получает постбеки.

1. URL постбэка: шаблон с макросами.
2. Условия отправки: статусы и минимальная выплата.

Макросы в URL постбэка

Макросы пишутся в одинарных фигурных скобках. Это не тот синтаксис, что в URL оффера (там двойные скобки).

Макрос	Что подставится
{click_id}	Наш click id (UUID клика)
{status}	Статус: lead, sale, rejected, rebill, upsell
{payout}	Выплата из постбека ПП
{currency}	Валюта выплаты
{conversion_id}	ID конверсии в Telegfy
{external_id}	tid (ID транзакции) из постбека ПП
{sub_id_1} … {sub_id_10}	Значения sub_id из клика

Значения подставляются с URL-кодированием.

Вернуть источнику его click id

Click id источника попадает в наш клик, если вы передаёте его в ссылку как sub_id. Дальше его можно вернуть в постбеке.

1. В рекламе, в URL ссылки, добавьте параметр с macro источника, например https://<домен>/<код>?sub_id_1={click_id_источника}. Конкретный макрос берите из кабинета источника.

2. В URL постбэка используйте {sub_id_1}, а не {click_id}:

   https://tracker.example.com/postback?clickid={sub_id_1}&status={status}&payout={payout}

Осторожно

{click_id} — это наш UUID. Источник его не узнает: ему нужен свой click id. Для него используйте {sub_id_N}.

Лог постбэков

Откройте источник в списке, чтобы увидеть историю отправок.

Состояние	Значение
В очереди	Постбек ждёт отправки. Очередь разбирается раз в минуту.
Отправлен	Источник ответил. Смотрите код ответа.
Ошибка	Попытки закончились или запрос отклонён. Смотрите код ответа и попытку.

Если постбек не отправлен, смотрите Решение проблем.

Частые ошибки

• Ссылка без источника. Клики такой ссылки не отправляют постбеки, если в воркспейсе больше одного активного источника.
• Условия не совпадают. Источник ждёт sale, а конверсия пришла как lead.
• Недопустимый адрес. Telegfy не отправляет постбеки на приватные IP-адреса и на адреса, которые не начинаются с http или https. Такой URL не сохранится.

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

• Исходящие постбеки — когда и как уходит запрос, ретраи, дубли.
• Кампании и ссылки — где выбрать источник при создании ссылки.