Лидпульт
Трекеры и постбэки

Как настроить постбэк из сети в трекер за пять шагов

Постбэк возвращает в трекер статусы лидов, и по ним вы считаете прибыль. Ниже порядок настройки для Лидпульта: от адреса в трекере до проверки кнопкой и разбора типичных ошибок.

· 5 мин чтения

Что такое постбэк и откуда он идёт

Постбэк — это 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 (или в другую свободную метку) и зафиксируйте это правило для всей команды.

Договоритесь заранее: sub1 — click_id, sub2 — источник, sub3 — кампания и так далее. Меняя схему посреди работы, вы разрываете историю отчётов.

Шаг 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 минуты и далее.

Что проверить, если конверсии не видно

  1. Попал ли click_id в sub-метку при отправке лида.
  2. Совпадает ли имя параметра в шаблоне трекера с тем, что вы подставили.
  3. Не закрыт ли адрес трекера за авторизацией или фильтром по IP.
  4. Что показывает журнал: ответ 200, 4xx или таймаут.
  5. Не отфильтрован ли нужный статус настройкой трекера.

Пример готового адреса и его разбор

Допустим, ваш трекер принимает конверсии по адресу 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 не связаны: постбэк уходит от сети к вам, а ключи нужны для отправки лидов.