Лидпульт

Как настроить постбэк на ваш трекер: адрес, макросы и статусы

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

· 6 мин чтения

Как устроен постбэк

Постбэк — это обращение сети на указанный вами адрес. Оно происходит при приёме лида и при каждой смене статуса. В адресе вы используете макросы: сеть заменяет их реальными значениями. В трекере по идентификатору заявки вы обновляете конверсию и видите актуальный статус.

Значения макроса %status%:

  • new — лид принят системой;
  • sent — лид передан клинике;
  • hold — заявка в работе, итог ещё не определён;
  • accepted — принят, выплата начислена;
  • canceled — отклонён;
  • paid — выплачен.

Статус определяется подстатусом, который проставляет клиника после звонка: он ведёт заявку к итогу «принят», «холд» или «отменён». О подстатусах — в инструкции для клиник по разбору заявок и в разделе «Как это работает».

Доступные макросы

В адрес постбэка можно подставить:

  • %lead_id% — номер лида в сети;
  • %apiid% — ваш идентификатор, переданный при отправке;
  • %status% — текущий статус;
  • %payout% — выплата за лид;
  • %offer% и %offers_id% — оффер (название и номер);
  • %cities_id% и %landings_id% — город и лендинг;
  • %createtime% — время создания лида;
  • %sub1%…%sub5% — ваши метки;
  • %estimation% и %estimationflag% — оценка и её признак, если они вам нужны.

Для трекера обычно достаточно трёх: идентификатор клика (через %sub5% или %apiid%), статус и сумма выплаты.

Шаги: настраиваем постбэк

  1. Откройте в кабинете раздел «Интеграция», блок «Постбэк на ваш трекер».
  2. В вашем трекере найдите шаблон адреса постбэка для партнёрской сети и скопируйте его. Если трекер даёт готовый шаблон для статусов, ориентируйтесь на него.
  3. Замените макросы трекера макросами сети. Например, идентификатор клика трекера подставляйте через %sub5%, если вы передавали его туда при отправке лида.
  4. Составьте адрес. Пример из кабинета:
  5. https://ваш-трекер/postback?click=%sub5%&status=%status%&payout=%payout%
  6. Вставьте адрес в поле «Адрес постбэка (Pixel URL)» и нажмите «Сохранить постбэк». Обратите внимание на требования к адресу: он должен быть публичным.
  7. Используйте кнопку отправки тестового постбэка и сверьте, что трекер получил запрос. Подробнее — в инструкции по проверке постбэка.
  8. Сопоставьте статусы сети со статусами трекера: например, accepted — целевое действие с выплатой, canceled — отклонённое, hold — ожидание.
Запрос идёт на ваш адрес методом, который вы указали в шаблоне. Если трекер ждёт определённую структуру, проверяйте её на тестовом вызове.

Требования к адресу и повторы

Адрес должен быть публичным, с протоколом http или https и портом 80 или 443. Адреса внутренних сетей и localhost не принимаются. Внешние запросы идут без редиректов и с ограниченным временем ожидания, поэтому адрес должен отвечать быстро и сразу, а не перенаправлять на другую страницу.

Если трекер не ответил или вернул ошибку 5xx, сеть повторяет вызов: через 30 секунд, затем через 1, 2, 4 минуты и так далее, всего до восьми раз. Поэтому ваш обработчик должен быть идемпотентным: повторный вызов с тем же статусом не должен создавать вторую конверсию.

  • Отвечайте кодом 200 как можно быстрее, а тяжёлую обработку выносите в очередь.
  • Не отвечайте редиректом: он не будет выполнен.
  • Если трекер недоступен долго, после восьми попыток сеть перестанет повторять. Для сверки используйте статистику в кабинете.

Типичные ошибки

  • Адрес на внутренний сервер. Адреса вроде 192.168.… или localhost отклоняются.
  • Нестандартный порт. Допустимы только 80 и 443.
  • Неверный макрос. Макрос написан с ошибкой и попадает в запрос как текст. Проверьте регистр и знаки процента.
  • Нет идентификатора клика. Постбэк пришёл, но трекер не знает, к какой конверсии его отнести.
  • Статусы не сопоставлены. Трекер считает «hold» за отклонение и занижает показатели.
  • Редирект на https. Если адрес начинается с http и отвечает редиректом на https, вызов не пройдёт. Указывайте конечный адрес.
  • Двойная обработка повторов. Трекер засчитывает каждый повтор как новую конверсию.
Не используйте постбэк для передачи данных, которые не нужны трекеру: телефон и имя пользователя через макросы не передаются, а лишние персональные данные в адресах нарушают принцип минимизации.

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

После сохранения проверьте постбэк на тестовом вызове и на реальной заявке. Затем регулярно просматривайте журнал отправок: он показывает, какие вызовы прошли и где были ошибки. Если в ответ вы видите статусы 4xx или 5xx, исправляйте адрес или обработчик. Инструкция по журналу — проверка постбэка и журнал отправок.

Как связать статусы сети со статусами трекера

Каждый трекер по-своему называет события: «лид», «продажа», «отклонён», «в ожидании». Составьте таблицу соответствия до настройки, чтобы не путаться потом. Типичная схема выглядит так: статус new и sent — информационные события, показывающие, что заявка принята и передана клинике. Статус hold означает, что заявка в работе: деньги ещё не подтверждены, но заявка и не отклонена. Статус accepted — целевое действие, за которое начисляется выплата. Статус canceled — отклонение: выплаты не будет. Статус paid показывает, что выплата по заявке проведена.

Если ваш трекер умеет только два состояния — успех и отказ, сопоставьте accepted и paid с успехом, а canceled с отказом, а hold оставьте как ожидание. Не засчитывайте new как конверсию с выплатой: это только факт приёма системой.

Помните, что статус может меняться несколько раз: например, hold сменяется на accepted, когда клиника проставит итоговый подстатус. Поэтому обработчик в трекере должен обновлять существующую конверсию по идентификатору, а не создавать новую при каждом вызове.

Безопасность и производительность обработчика

Адрес постбэка — публичный, и его может вызвать кто угодно, кто его знает. Защитите обработчик: проверяйте формат параметров, не доверяйте значениям слепо, а в адрес по возможности включайте секретный токен, известный только вам и вашему трекеру. Не вносите в обработчик действий с побочными эффектами, которые нельзя повторять: сеть повторяет вызов при сбоях, и обработчик должен корректно переносить дубли.

Следите за скоростью. Сеть ограничивает время ожидания ответа, поэтому обработчик должен отвечать быстро. Если после получения нужно выполнить долгие операции, ставьте их в очередь и сразу возвращайте ответ 200.

Вопросы и ответы

Обязательно ли настраивать постбэк?

Нет. Но без него статусы лидов не попадут в ваш трекер автоматически, и сверять данные придётся вручную по кабинету.

Когда вызывается постбэк?

При приёме лида и при каждой смене статуса. Выплаченный лид задним числом статус не меняет.

Сколько раз сеть повторит вызов при ошибке?

До восьми раз с растущей паузой: через 30 секунд, 1, 2, 4 минуты и далее.

Можно ли указать несколько адресов постбэка?

В кабинете описано поле для одного адреса. Для нескольких систем используйте трекер, который пересылает конверсии дальше.

Какой макрос взять для идентификатора клика?

Тот, куда вы передали идентификатор при отправке: чаще всего sub5 или apiid.

Нужно ли защищать адрес постбэка?

Желательно: добавьте в адрес секретный параметр и проверяйте его в обработчике, чтобы посторонние запросы не искажали вашу статистику.