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

Макросы постбэка: что значит каждый параметр и как его применять

Макрос — это шаблонное слово в адресе постбэка, которое сеть заменяет реальным значением. Разберём все макросы Лидпульта, покажем примеры адресов и частые ошибки при сборке адреса.

· 5 мин чтения

Как работают макросы

В адресе постбэка вы пишете параметры вида name=%macro%. Когда сеть отправляет запрос, она подставляет вместо %macro% текущее значение из лида. Неизвестный макрос в адресе остаётся как есть, поэтому опечатка в названии приведёт к тому, что в трекер уйдёт буквально строка с процентами.

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

Список макросов

МакросЧто это
%lead_id%Номер лида в Лидпульте
%status%Статус: new, sent, hold, accepted, canceled, paid
%payout%Выплата за лид, зафиксированная при приёме
%offer%Оффер
%offers_id%Номер оффера
%cities_id%Номер города
%landings_id%Номер лендинга
%createtime%Время создания лида
%sub1%…%sub5%Метки, которые вы передали
%apiid%Ваш идентификатор лида
%estimation%, %estimationflag%Оценка лида и её признак

Какие макросы нужны почти всегда

Минимальный набор для любой связки: идентификатор клика (через sub-метку или apiid), статус и выплата. Номер лида пригодится для сверки с кабинетом: по нему вы всегда найдёте заявку при споре или вопросе менеджеру.

https://track.example.com/pb?click=%sub1%&status=%status%&sum=%payout%&lead=%lead_id%

Если вы шлёте лиды с собственным идентификатором, который уже совпадает с ключом в трекере, можно использовать %apiid% вместо sub-метки:

https://track.example.com/pb?click=%apiid%&status=%status%&sum=%payout%

Статус как главный параметр

Макрос %status% определяет, что трекер сделает с конверсией. Он принимает шесть значений. Для расчёта прибыли ключевыми считаются accepted (выплата начислена) и canceled (отклонён). Статусы new и sent показывают, что лид принят системой и передан клинике, но денег они ещё не означают. Холд — это промежуточная стадия: клиника работает с заявкой, итог впереди.

Не прибавляйте выплату к доходу по статусам new, sent и hold. Иначе прибыль в трекере окажется выше, чем в кабинете сети, и вы будете принимать решения по неверным цифрам.

Выплата и оценка

Макрос %payout% отдаёт размер вознаграждения, который закреплён в лиде при приёме. Даже если условия оффера позже изменят, по уже принятому лиду выплата остаётся прежней. Передавайте её в поле дохода трекера как есть и следите за форматом: трекер ожидает число без пробелов и символа валюты.

Макросы %estimation% и %estimationflag% нужны, если вы работаете с оценкой заявки. Не все трекеры умеют хранить дополнительные поля, поэтому проверьте, куда эти значения попадут.

Ошибки при работе с макросами

  • Опечатка в названии: %leadid% вместо %lead_id%.
  • Лишний символ процента или пробел внутри макроса.
  • Использование макроса трекера в адресе сети: сеть его не знает, строка уйдёт без изменений.
  • Одинаковое имя параметра, куда подставляются два значения.
  • Потерянный амперсанд между параметрами и «склеенные» значения.

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

Примеры адресов для разных задач

Макросы можно сочетать по-разному. Три типовых случая.

ЗадачаПример адреса
Простой учёт доходаhttps://track.example.com/pb?cid=%sub1%&st=%status%&rev=%payout%
Сверка с кабинетомhttps://track.example.com/pb?cid=%sub1%&st=%status%&lead=%lead_id%&t=%createtime%
Разбивка по офферам и городамhttps://track.example.com/pb?cid=%sub1%&st=%status%&o=%offers_id%&c=%cities_id%

Второй вариант удобен тем, что номер лида и время создания позволяют быстро найти заявку при расхождениях. Третий пригодится, если вы льёте один поток на несколько офферов и городов и хотите видеть разрез прямо в трекере.

Как проверить подстановку

Нажмите в кабинете кнопку проверки постбэка и откройте журнал отправок. Там вы увидите, какой адрес реально ушёл к вам, какой код ответа вернул трекер и когда это произошло. Сравните адрес с шаблоном: на месте каждого макроса должно быть значение. Если где-то осталась строка с процентами, исправьте опечатку и повторите проверку.

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

Как макросы связаны с форматом запроса на отправку лида

Метки и идентификаторы, которые вы передали при отправке лида по API, возвращаются обратно через макросы постбэка. Параметры sub1…sub5 и apiid из запроса к /api/lead превращаются в %sub1%…%sub5% и %apiid%. Формат запроса (плоские параметры или Lead[…]) на это не влияет: значение хранится в лиде одинаково.

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

Контрольный список перед запуском

  • Адрес постбэка публичный, порт 80 или 443.
  • Все макросы написаны верно, без лишних пробелов.
  • В трекере настроены оба типа событий: принят и отклонён.
  • Статусы new, sent и hold не считаются доходом.
  • Проверка кнопкой прошла, в журнале код ответа 200.
  • Тестовая конверсия видна в отчёте трекера.

Особенности обработки значений в трекере

Трекер получает значения как строки. Числовые параметры, такие как выплата, преобразуйте в числа с учётом разделителя дробной части. Статусы сопоставляйте по точному совпадению строк в нижнем регистре. Идентификаторы не обрезайте и не изменяйте: любая правка делает клик ненаходимым. Если ваш трекер чувствителен к регистру в именах параметров, придерживайтесь одного написания во всех шаблонах.

Напоминание

Проверяйте итоговый адрес в журнале после любого изменения шаблона.

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

Что будет, если в адресе неизвестный макрос?

Он останется в запросе как обычный текст. Трекер получит строку с процентами и, скорее всего, не распознает конверсию.

Нужно ли кодировать значения макросов в адресе?

Значения подставляет сеть. Если вы передаёте в sub-метки спецсимволы, лучше заранее заменить их на безопасные: латиницу, цифры и дефис.

В чём разница между %offer% и %offers_id%?

Первый макрос отдаёт данные об оффере, второй его числовой номер. Для отчётов удобнее номер: он не меняется при переименовании.

Можно ли использовать один макрос дважды?

Можно. Например, apiid можно передать и в одном параметре идентификатора, и в параметре для сверки.

Что подставляется в макрос, если метка не передавалась?

Значение будет пустым. Трекер получит параметр без значения, поэтому учитывайте это в обработке и не рассчитывайте на обязательное заполнение.

Могут ли названия макросов измениться?

Перечень макросов приведён в документации API. Если он изменится, ваш адрес продолжит работать с теми макросами, которые остались. Периодически сверяйтесь с документацией.