Как настроить постбэк на ваш трекер: адрес, макросы и статусы
Постбэк возвращает в ваш трекер статус каждой заявки: принята, у клиники, в холде, одобрена, отклонена, выплачена. Рассказываем, как составить адрес, какие макросы использовать и чего избегать.
Как устроен постбэк
Постбэк — это обращение сети на указанный вами адрес. Оно происходит при приёме лида и при каждой смене статуса. В адресе вы используете макросы: сеть заменяет их реальными значениями. В трекере по идентификатору заявки вы обновляете конверсию и видите актуальный статус.
Значения макроса %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%), статус и сумма выплаты.
Шаги: настраиваем постбэк
- Откройте в кабинете раздел «Интеграция», блок «Постбэк на ваш трекер».
- В вашем трекере найдите шаблон адреса постбэка для партнёрской сети и скопируйте его. Если трекер даёт готовый шаблон для статусов, ориентируйтесь на него.
- Замените макросы трекера макросами сети. Например, идентификатор клика трекера подставляйте через
%sub5%, если вы передавали его туда при отправке лида. - Составьте адрес. Пример из кабинета:
https://ваш-трекер/postback?click=%sub5%&status=%status%&payout=%payout%- Вставьте адрес в поле «Адрес постбэка (Pixel URL)» и нажмите «Сохранить постбэк». Обратите внимание на требования к адресу: он должен быть публичным.
- Используйте кнопку отправки тестового постбэка и сверьте, что трекер получил запрос. Подробнее — в инструкции по проверке постбэка.
- Сопоставьте статусы сети со статусами трекера: например,
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.
Нужно ли защищать адрес постбэка?
Желательно: добавьте в адрес секретный параметр и проверяйте его в обработчике, чтобы посторонние запросы не искажали вашу статистику.