Макросы постбэка: что значит каждый параметр и как его применять
Макрос — это шаблонное слово в адресе постбэка, которое сеть заменяет реальным значением. Разберём все макросы Лидпульта, покажем примеры адресов и частые ошибки при сборке адреса.
Как работают макросы
В адресе постбэка вы пишете параметры вида 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 показывают, что лид принят системой и передан клинике, но денег они ещё не означают. Холд — это промежуточная стадия: клиника работает с заявкой, итог впереди.
Выплата и оценка
Макрос %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. Если он изменится, ваш адрес продолжит работать с теми макросами, которые остались. Периодически сверяйтесь с документацией.