Лидпульт

Формат Lead[…]: как передавать параметры и перенести трекер

Лидпульт принимает параметры в двух видах: плоском и в формате Lead[…]. Разберём различия, покажем примеры и порядок переноса уже настроенного трекера без переписывания интеграции.

· 5 мин чтения

Зачем нужен формат Lead[…]

Многие партнёрские сети принимают заявки в формате с префиксом Lead[…]: Lead[wmkey], Lead[phone] и так далее. Трекеры и готовые интеграции вебмастеров часто настроены именно так. Чтобы вам не приходилось переписывать конфигурацию, Лидпульт принимает оба варианта: плоский и этот.

Смысл параметров не меняется. Различается только запись имени. Практическое следствие: если ваш трекер уже умеет отправлять лиды в формате Lead[…], в большинстве случаев достаточно поменять домен и значения ключей и номер оффера.

Соответствие плоских и Lead-параметров

Обязательные параметры — ключи, оффер, город и телефон. Остальные необязательны:

Плоский вариантВариант Lead[…]Что передаём
wmkeyLead[wmkey]Публичный ключ вебмастера
apikeyLead[apikey]Секретный ключ API
offer_idLead[offer_id]Номер оффера
cityLead[city]Город названием или номером
phoneLead[phone]Телефон в любом виде
nameLead[name]Имя (необязательно)
apiidLead[apiid]ID лида у вас, защита от дублей при повторе
sub1…sub5Lead[sub1]…Lead[sub5]utm_source … utm_term
infoLead[info]Доп. информация для клиники
landing_idLead[landing_id]Номер лендинга

Кабинет в блоке интеграции по каждому офферу показывает готовый адрес с подстановками вида {CITY}, {PHONE}, {SUB1}: вам остаётся заменить их макросами вашего трекера.

Шаги: перенос трекера на формат Lead[…]

  1. Откройте в кабинете раздел «Интеграция» и страницу нужного оффера. Скопируйте адрес для этого оффера (GET или POST).
  2. В настройках трекера создайте новую партнёрку или источник и вставьте адрес. Домен берётся из кабинета, адрес вида /site/apiaddlead/ подходит для Lead-формата.
  3. Замените метки в фигурных скобках на макросы трекера: город, телефон, имя, идентификатор клика и метки трафика. У каждого трекера свой синтаксис, посмотрите его в документации трекера.
  4. Укажите Lead[wmkey] и Lead[apikey]. Секретный ключ берите из выпуска ключа API.
  5. Передайте в Lead[apiid] уникальный идентификатор заявки, чтобы повтор запроса не создавал дубль.
  6. Отправьте тестовый лид и проверьте ответ. Затем сравните карточку лида в кабинете с данными в трекере.
  7. Включите постбэк и проверьте цепочку статусов: инструкция по постбэку.
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 совпадает с вашим внутренним номером заявки, ведь именно по нему постбэк вернёт статус в трекер.

  1. Отправьте заявку с узнаваемыми значениями: например, в sub1 укажите название источника, в sub2 — кампанию.
  2. Откройте лид в кабинете и сравните метки.
  3. Откройте статистику, сгруппируйте по метке и убедитесь, что новая строка появилась.
  4. Проверьте, что в постбэке макрос %sub1% вернул то же значение.

Подробнее о метках — в инструкции о передаче utm в sub1–sub5.

Где посмотреть примеры и как не потерять настройки

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

Общее описание параметров и кодов ответа вы найдёте в документации API.

Когда формат важен для вашего трекера

Выбор формата чаще всего определяется не вами, а возможностями трекера. Одни трекеры позволяют собрать произвольный адрес с любым набором параметров, другие ждут заранее заданный шаблон. Если шаблон жёсткий и подразумевает Lead[…], ничего менять не нужно. Если трекер гибкий, используйте тот формат, который проще поддерживать вашей команде.

В любом случае храните описание интеграции: домен, номер оффера, формат параметров и дату последней проверки. Через полгода это сэкономит время тому, кто будет разбираться с настройками.

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

Нужно ли переписывать интеграцию при переходе с другой сети?

Если трекер отправляет Lead[…], чаще всего достаточно сменить домен, ключи и номер оффера. Проверьте работу на тестовой заявке.

Есть ли разница в ответе между форматами?

Нет. Ответ и коды ошибок одинаковы для плоского формата и для Lead[…].

Какой адрес использовать: /api/lead или /site/apiaddlead/?

Оба принимают оба формата. Выбирайте тот, который требует ваш трекер.

Можно ли передавать Lead[…] в JSON?

Параметры можно передавать в адресе, формой или JSON. Проверьте структуру на тестовой заявке.

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

Без обязательных полей придёт ошибка bad_request. Необязательные поля можно опустить.

Чувствителен ли формат к регистру в названиях параметров?

Пишите имена так, как они даны в документации: wmkey, apikey, offer_id и так далее строчными, а префикс Lead — с заглавной буквы. Так вы избежите неожиданностей при разборе.