Формат Lead[…]: как передавать параметры и перенести трекер
Лидпульт принимает параметры в двух видах: плоском и в формате Lead[…]. Разберём различия, покажем примеры и порядок переноса уже настроенного трекера без переписывания интеграции.
Зачем нужен формат Lead[…]
Многие партнёрские сети принимают заявки в формате с префиксом Lead[…]: Lead[wmkey], Lead[phone] и так далее. Трекеры и готовые интеграции вебмастеров часто настроены именно так. Чтобы вам не приходилось переписывать конфигурацию, Лидпульт принимает оба варианта: плоский и этот.
Смысл параметров не меняется. Различается только запись имени. Практическое следствие: если ваш трекер уже умеет отправлять лиды в формате Lead[…], в большинстве случаев достаточно поменять домен и значения ключей и номер оффера.
Соответствие плоских и Lead-параметров
Обязательные параметры — ключи, оффер, город и телефон. Остальные необязательны:
| Плоский вариант | Вариант Lead[…] | Что передаём |
|---|---|---|
wmkey | Lead[wmkey] | Публичный ключ вебмастера |
apikey | Lead[apikey] | Секретный ключ API |
offer_id | Lead[offer_id] | Номер оффера |
city | Lead[city] | Город названием или номером |
phone | Lead[phone] | Телефон в любом виде |
name | Lead[name] | Имя (необязательно) |
apiid | Lead[apiid] | ID лида у вас, защита от дублей при повторе |
sub1…sub5 | Lead[sub1]…Lead[sub5] | utm_source … utm_term |
info | Lead[info] | Доп. информация для клиники |
landing_id | Lead[landing_id] | Номер лендинга |
Кабинет в блоке интеграции по каждому офферу показывает готовый адрес с подстановками вида {CITY}, {PHONE}, {SUB1}: вам остаётся заменить их макросами вашего трекера.
Шаги: перенос трекера на формат Lead[…]
- Откройте в кабинете раздел «Интеграция» и страницу нужного оффера. Скопируйте адрес для этого оффера (GET или POST).
- В настройках трекера создайте новую партнёрку или источник и вставьте адрес. Домен берётся из кабинета, адрес вида
/site/apiaddlead/подходит для Lead-формата. - Замените метки в фигурных скобках на макросы трекера: город, телефон, имя, идентификатор клика и метки трафика. У каждого трекера свой синтаксис, посмотрите его в документации трекера.
- Укажите
Lead[wmkey]иLead[apikey]. Секретный ключ берите из выпуска ключа API. - Передайте в
Lead[apiid]уникальный идентификатор заявки, чтобы повтор запроса не создавал дубль. - Отправьте тестовый лид и проверьте ответ. Затем сравните карточку лида в кабинете с данными в трекере.
- Включите постбэк и проверьте цепочку статусов: инструкция по постбэку.
https://<домен-сети>/site/apiaddlead/?Lead[wmkey]=1a2b3c4d&Lead[apikey]=СЕКРЕТ&Lead[offer_id]=1&Lead[city]=Самара&Lead[apiid]=trk-123&Lead[phone]=79271234567&Lead[name]=Анна&Lead[sub1]=VK
Какие значения принимает город и телефон
Город допустимо передать названием (например, «Самара») или номером города в системе. Если город не распознан, придёт ошибка city_not_found; если распознан, но не открыт вам по офферу — geo_closed. Следите, чтобы трекер не подставлял вместо города регион или страну.
Телефон допустим в разных видах: с плюсом, скобками и дефисами, с восьмёркой или без кода страны. Система приводит номер к единому виду. Если номер не получается нормализовать, ответ — bad_phone. Не передавайте в поле телефона почту или имя.
Смешивать ли форматы
Лучше использовать один формат во всём запросе: либо плоский, либо Lead[…]. Смесь затрудняет отладку, а при ручных правках легко потерять обязательный параметр, и тогда придёт bad_request.
- Если параметры в адресе, а ключи в теле POST — убедитесь, что трекер действительно передаёт и то и другое.
- Если используете JSON, структура должна передавать те же имена. Проверьте на тестовой заявке, а не на боевом трафике.
- Заявки из форм на лендинге сети поступают без вашего участия, а ручное добавление лида возможно прямо в кабинете.
Типичные ошибки
- Забытые скобки. Параметр
Lead[phoneбез закрывающей скобки не распознаётся. - Незакодированные квадратные скобки. Некоторые клиенты кодируют их как
%5Bи%5D— это корректно и принимается. - Поле
apikeyоставлено заполнителем. В кабинетном примере там написано «ВАШ_API_КЛЮЧ», его нужно заменить. - Не заменены метки {CITY}, {PHONE}. Тогда заявка уходит с буквальным текстом в значениях.
- Перенос без проверки гео. На другой сети у вас были другие города: проверьте открытое гео в выборе оффера.
offer_not_found.Как проверить, что метки и параметры дошли
После переноса запросов сверьте три вещи. Первая — что лид появился в кабинете с правильным городом и телефоном. Вторая — что значения sub1…sub5 сохранились: они видны в статистике по меткам. Третья — что идентификатор apiid совпадает с вашим внутренним номером заявки, ведь именно по нему постбэк вернёт статус в трекер.
- Отправьте заявку с узнаваемыми значениями: например, в
sub1укажите название источника, вsub2— кампанию. - Откройте лид в кабинете и сравните метки.
- Откройте статистику, сгруппируйте по метке и убедитесь, что новая строка появилась.
- Проверьте, что в постбэке макрос
%sub1%вернул то же значение.
Подробнее о метках — в инструкции о передаче utm в sub1–sub5.
Где посмотреть примеры и как не потерять настройки
Пример готового адреса вы найдёте в карточке оффера: блок отправки лидов показывает адрес с подстановками и пояснения к каждому параметру. Сохраните рабочий вариант адреса в заметках проекта вместе с датой, чтобы при переносе на другой трекер не собирать всё заново.
Общее описание параметров и кодов ответа вы найдёте в документации API.
Когда формат важен для вашего трекера
Выбор формата чаще всего определяется не вами, а возможностями трекера. Одни трекеры позволяют собрать произвольный адрес с любым набором параметров, другие ждут заранее заданный шаблон. Если шаблон жёсткий и подразумевает Lead[…], ничего менять не нужно. Если трекер гибкий, используйте тот формат, который проще поддерживать вашей команде.
В любом случае храните описание интеграции: домен, номер оффера, формат параметров и дату последней проверки. Через полгода это сэкономит время тому, кто будет разбираться с настройками.
Вопросы и ответы
Нужно ли переписывать интеграцию при переходе с другой сети?
Если трекер отправляет Lead[…], чаще всего достаточно сменить домен, ключи и номер оффера. Проверьте работу на тестовой заявке.
Есть ли разница в ответе между форматами?
Нет. Ответ и коды ошибок одинаковы для плоского формата и для Lead[…].
Какой адрес использовать: /api/lead или /site/apiaddlead/?
Оба принимают оба формата. Выбирайте тот, который требует ваш трекер.
Можно ли передавать Lead[…] в JSON?
Параметры можно передавать в адресе, формой или JSON. Проверьте структуру на тестовой заявке.
Что если часть параметров не передана?
Без обязательных полей придёт ошибка bad_request. Необязательные поля можно опустить.
Чувствителен ли формат к регистру в названиях параметров?
Пишите имена так, как они даны в документации: wmkey, apikey, offer_id и так далее строчными, а префикс Lead — с заглавной буквы. Так вы избежите неожиданностей при разборе.