Как настроить постбэк из сети в трекер за пять шагов
Постбэк возвращает в трекер статусы лидов, и по ним вы считаете прибыль. Ниже порядок настройки для Лидпульта: от адреса в трекере до проверки кнопкой и разбора типичных ошибок.
Что такое постбэк и откуда он идёт
Постбэк — это HTTP-запрос, который партнёрская сеть отправляет на адрес вашего трекера, когда в лиде что-то происходит. Лидпульт вызывает его при приёме лида и при каждой смене статуса. Поэтому в трекере по одному лиду может появиться несколько событий: принят системой, отправлен клинике, холд, принят, отклонён, выплачен.
Адрес вы задаёте в кабинете, в разделе интеграции. Он должен быть публичным: допускаются http и https, порты 80 или 443. Адреса внутренней сети и localhost не принимаются.
Шаг 1. Получите адрес постбэка в трекере
В большинстве трекеров есть шаблон адреса для конверсий. Он выглядит как базовый домен трекера, путь и параметры, куда нужно подставить идентификатор клика и статус. Названия параметров зависят от трекера: где-то это clickid, где-то subid или cid. Не угадывайте, откройте справку своего трекера и скопируйте шаблон оттуда.
Пример структуры, где вместо параметров трекера подставлены макросы сети:
https://track.example.com/postback?cid=%sub1%&status=%status%&payout=%payout%&lead=%lead_id%Здесь track.example.com условный адрес, а в параметре cid едет значение, которое вы ранее передали в sub1.
Шаг 2. Решите, где хранить click_id
Сеть возвращает ваши метки sub1…sub5 и apiid в том виде, в каком получила. Значит, click_id нужно отправить в одном из этих полей при передаче лида. Если вы шлёте лиды с лендинга по API, положите идентификатор клика в sub1 (или в другую свободную метку) и зафиксируйте это правило для всей команды.
Шаг 3. Вставьте адрес в кабинет и подберите макросы
В кабинете вебмастера вставьте собранный адрес в поле постбэка. Доступные макросы:
| Макрос | Что подставляется |
|---|---|
%lead_id% | Номер лида в сети |
%status% | Статус: new, sent, hold, accepted, canceled, paid |
%payout% | Выплата за лид |
%sub1%…%sub5% | Ваши метки |
%apiid% | Ваш идентификатор лида |
%offer%, %offers_id% | Оффер |
Остальные макросы (город, лендинг, время создания, оценка) смотрите в документации API.
Шаг 4. Сопоставьте статусы с событиями трекера
Трекер обычно различает несколько типов конверсий или статусов. Составьте таблицу соответствия:
newиsent— лид принят, но ещё не оплачен: записывайте как «в ожидании» или не записывайте вовсе;hold— в работе у клиники;accepted— принят, выплата начислена: основной доход;canceled— отклонён, доход обнуляется;paid— выплачен.
Если настроить трекер так, что любой пришедший постбэк считается доходом, вы получите завышенную прибыль: статус new приходит почти на каждый лид, а принимается лишь часть.
Шаг 5. Проверьте кнопкой и журналом
В кабинете есть проверка постбэка кнопкой и журнал отправок. Нажмите проверку, затем откройте журнал: там видно адрес, код ответа и время. Код 200 от трекера означает, что запрос принят. После этого откройте отчёт трекера и убедитесь, что тестовая конверсия появилась. Если сеть получила от трекера 5xx или не получила ответа, она повторит отправку до восьми раз: через 30 секунд, 1, 2, 4 минуты и далее.
Что проверить, если конверсии не видно
- Попал ли click_id в sub-метку при отправке лида.
- Совпадает ли имя параметра в шаблоне трекера с тем, что вы подставили.
- Не закрыт ли адрес трекера за авторизацией или фильтром по IP.
- Что показывает журнал: ответ 200, 4xx или таймаут.
- Не отфильтрован ли нужный статус настройкой трекера.
Пример готового адреса и его разбор
Допустим, ваш трекер принимает конверсии по адресу track.example.com/conv и ожидает параметры cid (идентификатор клика), st (статус) и rev (доход). Готовый адрес для кабинета будет выглядеть так:
https://track.example.com/conv?cid=%sub1%&st=%status%&rev=%payout%&ext=%lead_id%Когда лид перейдёт в статус accepted, сеть отправит запрос вида:
GET https://track.example.com/conv?cid=cl8f2a91&st=accepted&rev=X&ext=443110Вместо X будет число из оффера. Трекер найдёт клик cl8f2a91, запишет доход и свяжет событие с лидом 443110, поэтому при вопросах по заявке вы быстро найдёте её в кабинете.
Тонкие места настройки
- Постоянный статус. Один и тот же статус может прийти повторно из-за повтора отправки. Включите в трекере защиту от дублей по паре «клик плюс статус».
- Порядок событий. Сеть повторяет неудачные отправки, поэтому событие с более ранним статусом может прийти после более позднего. Ориентируйтесь на время и логику статусов, а не на порядок прихода.
- Ответ трекера. Он должен быстро вернуть код 200. Долгая обработка приведёт к таймауту и лишним повторам.
- Защита адреса. Если трекер требует токен, добавьте его в адрес. Не открывайте приём конверсий всем подряд без какой-либо проверки.
Как отличить ошибку сети от ошибки трекера
Начните с журнала отправок в кабинете. Если в журнале запись об отправке есть и код ответа 200, сеть свою часть выполнила, и ищите причину в трекере: возможно, он принял запрос, но не нашёл клик по переданному идентификатору. Если код 4xx, трекер отверг запрос: проверьте токен и названия параметров. Если 5xx или таймаут, трекер перегружен или недоступен, и сеть будет повторять отправку. Если же записи в журнале нет вовсе, адрес постбэка не сохранён или лид ещё не менял статус.
Для повторяющихся ошибок ведите отдельную заметку: дата, лид, код ответа, что исправили. Через месяц такой список покажет закономерность, например перегрузку трекера в часы пиковых заявок.
Вопросы и ответы
Сколько раз сеть повторит постбэк при ошибке?
До восьми раз с растущей паузой: через 30 секунд, затем через 1, 2, 4 минуты и так далее. Повторяются случаи, когда трекер не ответил или вернул 5xx.
Можно ли указать несколько адресов постбэка?
В кабинете задаётся один адрес. Если нужно разослать событие в несколько систем, настройте пересылку на стороне трекера.
Постбэк уходит на каждое изменение статуса?
Да, при приёме лида и при каждой смене статуса. Поэтому трекер должен уметь обновлять конверсию, а не только добавлять новую.
Почему адрес с localhost не принимается?
Внешние запросы идут только на публичные адреса, без редиректов и с таймаутом. Для тестов используйте публичный домен или временный тоннель.
Нужно ли обновлять постбэк после перевыпуска ключа API?
Нет. Адрес постбэка и ключи API не связаны: постбэк уходит от сети к вам, а ключи нужны для отправки лидов.