Конверсии и постбеки¶
Конверсия - это целевое действие пользователя (продажа, лид, регистрация, депозит), зафиксированное на клике. TrafMate принимает конверсии через входящие постбеки, хранит по одной конверсии на клик и рассылает исходящие постбеки (S2S) источникам трафика и партнёрским сетям.
Приём конверсии (входящий постбек)¶
Партнёрская сеть или рекламодатель уведомляет трекер о конверсии GET-запросом:
Параметр subid резолвится в клик: сначала по click_id, затем по external_id.
Настраиваемые имена параметров (алиасы)¶
Имена входящих параметров можно менять под формат вашей сети. Алиасы задаются в Настройках (postback_*_aliases):
| Назначение | Допустимые имена параметров |
|---|---|
| Клик (subid) | subid, sub_id, click_id, trackID, subaccount, s |
| Статус | status, type, goal |
| Выплата | payout, revenue, profit, sum |
| Транзакция | transaction_id, txid, trans_id, tid |
Статусы конверсий¶
Поддерживается 6 типов статусов:
| Код | Статус | Описание |
|---|---|---|
| 1 | Sale | Продажа |
| 2 | Lead | Лид |
| 3 | Rejected | Отклонено |
| 4 | Registration | Регистрация |
| 5 | Deposit | Депозит |
| 6 | Trash | Мусор |
Входящее значение статуса нормализуется по алиасам:
- Sale -
sale,approved,1,confirmed - Lead -
lead - Rejected -
rejected,refund,cancel - Registration -
reg,registration - Deposit -
dep,deposit - Trash -
trash,spam
Одна конверсия на клик¶
На каждый клик хранится одна конверсия (поведение как в Keitaro).
- Повторный постбек с другим статусом обновляет конверсию, а не создаёт вторую.
- Правило перехода: любой статус может смениться на любой, побеждает последний постбек.
- Дубль того же статуса игнорируется.
Технически это реализовано через снапшот конверсии в Redis и пару строк CollapsingMergeTree в ClickHouse (отмена старой записи +1/-1 и вставка новой).
Дедупликация¶
Повторная обработка одного и того же события исключается:
- Ключ дедупа -
transaction_id, либо (при его отсутствии) параclick_id+status. - Окно дедупликации - 30 дней.
Исходящие постбеки (S2S)¶
При появлении или изменении конверсии воркер рассылает исходящие постбеки:
- Постбек источника трафика - GET-запрос на URL, заданный у источника.
- Правила кампании - вкладка «S2S postbacks» в настройках кампании. Для каждого правила задаются метод (GET/POST) и статусы-триггеры, при которых постбек отправляется.
Макросы URL-шаблона¶
В URL исходящего постбека подставляются макросы:
{click_id}/{subid}- идентификатор клика{sub_id_N}- дополнительные sub id{status}- статус конверсии{payout}/{revenue}- выплата{external_id}- внешний идентификатор
Доставка¶
- Ретраи - до 3 попыток.
- Таймаут запроса настраивается (
s2s_timeout).
Лог конверсий¶
Раздел Отчёты -> Лог конверсий показывает конверсии с деталями: кампания, источник, статус, доход, click_id.
В логе отображаются только «живые» конверсии - записи, отменённые сменой статуса, отсеиваются.
Интеграции-вебхуки¶
Раздел Инструменты -> Интеграции. Вебхук на событие conversion отправляет JSON конверсии на ваш URL (обрабатывается воркером). Используйте для передачи конверсий во внешние системы.
Партнёрские сети¶
У партнёрской сети хранится шаблон постбека. Оффер привязывается к сети, что позволяет автоматически формировать исходящие постбеки под формат конкретной сети.