Перейти к содержимому
Telegfy

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

Входящий постбек — это S2S-запрос от ПП на наш адрес, когда клиент совершил действие. Так конверсия попадает в Telegfy. Постбек уходит с сервера ПП на сервер Telegfy, браузер посетителя в этом не участвует, поэтому блокировщики и отключённые куки не мешают.

Адрес

Заголовок раздела «Адрес»
https://<домен>/postback

URL постбэка виден в трёх местах: в таблице «Партнёрские сети» (колонка «URL постбэка» с кнопкой копирования), в диалоге редактирования ПП («Наш URL постбэка») и на странице «Конверсии» у каждой цели. У цели URL уже содержит goal=<ключ>. Работают методы GET (параметры в адресе) и POST (JSON или form-urlencoded). Авторизация не нужна: защита строится на click id, секрете и IP (см. Защиту постбеков).

Таблица партнёрских сетей с колонками параметра subid и URL постбэка с кнопкой копирования
  1. Параметр subid: имя, в котором ПП передаёт click id.
  2. URL постбэка с кнопкой копирования.

Параметры

Заголовок раздела «Параметры»
Параметр Что принимается Обязательный
subid Click id: UUID клика. Также принимаются sub_id, click_id, _la_ct (берётся первый непустой). Да
status lead, sale, rejected, rebill, upsell, а также статусы ПП по словарю. Регистр не важен. Нет
payout Сумма выплаты. Разделитель — точка или запятая (10,5 = 10.5). Нет
currency Трёхбуквенный код валюты. Приводится к верхнему регистру и не проверяется. Нет
tid ID транзакции в ПП. Нужен для дедупликации. Рекомендуется
goal Ключ цели. Без него берётся первая активная цель воркспейса. Нет
network_id ID ПП. Определяет словарь статусов, если его нет, используется оффер клика. Нет
sign, signature, hmac Подпись, если включена защита. Если включена

Все параметры сохраняются в «сыром» виде вместе с конверсией. Это удобно для разбора спорных случаев.

Статусы

Заголовок раздела «Статусы»

Статус из постбека переводится в один из пяти наших:

  • если статус есть в словаре ПП, используем его;
  • если нет, смотрим общий словарь по умолчанию: approved и confirmed дают продажу, pending и hold дают лид, declined и fraud дают отклонение;
  • если статус не распознан, конверсия записывается как лид и помечается предупреждением в логе.

Полная таблица словаря и инструкция по своему соответствию — в ПП и офферах. Соответствие задаётся в диалоге ПП, блок «Соответствие статусов».

Если статус не передан, конверсия создаётся как лид.

Дедупликация и обновления

Заголовок раздела «Дедупликация и обновления»
  • С tid. Ключ — пара (цель, tid). Повтор с тем же статусом и выплатой даёт duplicate и ничего не меняет. Повтор с новым статусом или выплатой обновляет конверсию. Так лид становится продажей.
  • Без tid. Одна запись на пару (цель, клик) для лидов, продаж и отклонений. Повтор с новым статусом обновляет запись, например лид становится продажей. Поздний лид не понижает продажу.
  • Ребилл и апсейл без tid. Склеиваются по (цель, клик, статус). Каждый новый платёж надо передавать с уникальным tid, иначе он не запишется.

Ответы

Заголовок раздела «Ответы»

Telegfy отвечает HTTP 200, даже если конверсия не записана. Причина указана в поле result:

{"data":{"status":"ok","result":"accepted","conversionId":"..."}}
result Что значит
accepted Новая конверсия записана.
updated Существующая конверсия обновлена: новый статус или выплата.
duplicate Точный повтор. Ничего не изменилось.
click_not_found Click id пустой, не UUID или не найден.
goal_not_found Цель не найдена или выключена, либо ссылка не входит в коллекцию цели.
rejected Не прошла проверка подписи или IP.
error Внутренняя ошибка. Текст есть в логе.

Если ответ 429 (Too Many Requests), запрос не обработан и не попал в лог. Лимит — 6000 запросов в минуту с одного IP.

Цели и тариф

Заголовок раздела «Цели и тариф»

Конверсия всегда попадает в цель. Цель — это тип конверсии с ключом, см. Цели.

  • Если в воркспейсе нет ни одной цели, при первом постбеке без goal Telegfy создаёт цель с ключом conversion.
  • На Free одна цель, на Pro до 20, на Enterprise без лимита.

Лог входящих постбэков

Заголовок раздела «Лог входящих постбэков»

Последние 30 постбеков воркспейса видны внизу страницы «Партнёрские сети» (/dashboard/offers/networks). Для каждого показаны время, результат, сокращённый click id, параметры и сообщение.

Нижняя часть страницы партнёрских сетей: заголовок лога входящих постбэков и таблица последних постбэков
  1. Заголовок лога и кнопка «Обновить».
  2. Таблица: время, результат, click id, параметры, сообщение.

Лог — главное место для проверки. Если конверсия не появилась, начните с него. Разбор результатов — в Решении проблем.

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

Заголовок раздела «Что читать дальше»