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

Интеграция лендинга с API: как довести заявку от формы до лида

Собственный лендинг даёт контроль над дизайном и аналитикой, но требует аккуратной связки с API. Разбираем путь заявки от формы до ответа сети и типичные ошибки на этом пути.

· 5 мин чтения

Когда нужен собственный лендинг

Лидпульт предоставляет лендинги, потоки и сплит-тесты, и для многих задач их достаточно. Собственный лендинг нужен, когда вы хотите уникальный дизайн, нестандартную воронку или квиз, интеграцию с вашей аналитикой, или когда вы переносите на Лидпульт уже работающую страницу. Тогда форма на вашей странице отправляет данные вам, а вы передаёте заявку в сеть через /api/lead.

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

Состав формы

ПолеОбязательноКомментарий
ТелефонДаПринимаем в любом виде, проверяем на минимальную длину
ГородДаСписок городов оффера либо определение по выбору
ИмяНетПовышает конверсию в приём, но не обязательно
Согласие на обработкуДаФлажок со ссылкой на политику и согласие
Скрытые поляДаИдентификатор клика, источник, кампания, креатив

Не добавляйте лишних полей: каждое снижает конверсию. Медицинские подробности в форме не запрашивайте, это работа клиники.

Скрытые поля и метки

При загрузке страницы скрипт читает параметры адреса и записывает их в скрытые поля формы и в cookie. Эти значения потом уходят на ваш сервер и попадают в запрос к API как sub1…sub5 и apiid. Если параметра в адресе нет, скрипт берёт значение из cookie. Проверьте, что при переходе между страницами лендинга параметры не теряются.

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

Форма отправляет данные на ваш обработчик, а не в сеть напрямую. Обработчик проверяет данные, сохраняет заявку у себя, формирует запрос к API и возвращает ответ браузеру. Так секретный ключ остаётся на сервере.

POST /submit  (ваш сервер)
  1. проверить телефон, согласие, антиспам
  2. сохранить заявку, создать apiid
  3. POST https://<домен-сети>/api/lead  (с ключами и метками)
  4. по ответу вернуть пользователю результат

Ответ пользователю

Сообщение зависит от результата. При успехе покажите подтверждение: «Заявка принята, с вами свяжутся». При bad_phone попросите проверить номер. При duplicate подтверждайте приём нейтрально: человек уже оставлял заявку. При limit_reached, offer_not_live и других отказах не обманывайте пользователя фразой «заявка принята», если вы её не передали: лучше честно сообщить, что приём временно недоступен, и предложить другой способ связи.

Защита от спама и ботов

Открытая форма привлекает ботов, а фейковые заявки недопустимы: они нарушают правила и могут привести к блокировке. Добавьте простые меры: скрытое поле-ловушку, ограничение числа отправок с одного адреса, проверку времени заполнения формы, при необходимости CAPTCHA. Не показывайте боту подробные сообщения об ошибках и не отправляйте в сеть заявки, которые не прошли проверку.

Реклама медицинских услуг

Тексты на лендинге регулируются законом о рекламе. Для медицинских услуг применяются особые требования, в том числе предупреждение о наличии противопоказаний. Не обещайте гарантированный результат лечения, не публикуйте выдуманные отзывы и не используйте чужие фотографии «до и после». Если сомневаетесь в формулировке, согласуйте её с менеджером или юристом: ответственность за рекламу лежит на её распространителе.

Проверка после запуска

  • Заявка с лендинга видна в кабинете с нужными метками.
  • Идентификатор клика доходит до постбэка.
  • На мобильном форма удобна, а редиректы не режут параметры.
  • Ошибки сети обрабатываются, повторы идут с тем же apiid.
  • Страница быстро грузится: медленная страница теряет клики до заявки.

О форматах запроса смотрите в документации API.

Пример потока данных

Проследим одну заявку. Пользователь открывает ссылку с параметрами, скрипт сохраняет идентификатор клика и метки в скрытые поля. Человек вводит телефон и выбирает город, ставит флажок согласия и нажимает кнопку. Браузер отправляет данные на ваш адрес. Сервер проверяет формат телефона, создаёт apiid, сохраняет заявку и отправляет запрос в API с ключами и метками. Сеть отвечает status ok и номером лида. Сервер сохраняет номер, возвращает браузеру подтверждение, и пользователь видит страницу благодарности. Через время клиника меняет статус, и постбэк возвращает событие в трекер с тем же идентификатором клика.

Каждое звено этой цепочки можно проверить отдельно, поэтому при сбое видно, где именно он произошёл.

Производительность и доступность

Скорость загрузки страницы напрямую влияет на то, сколько оплаченных кликов дойдёт до формы. Сжимайте изображения, не подключайте лишние скрипты, выносите отправку на фон. Следите за доступностью вашего обработчика: если он недоступен, заявки теряются, и вы узнаете об этом поздно. Настройте простую проверку доступности и оповещение. Отдельно стоит подумать о запасном пути: контактный телефон на странице позволит человеку обратиться к клинике, даже если форма не сработала.

Журналирование без утечек

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

Частые ошибки при интеграции

  • Секретный ключ в коде страницы.
  • Форма без согласия на обработку персональных данных.
  • Идентификатор клика не попадает в метку при отправке.
  • Отсутствие apiid и дубли заявок при сбоях.
  • Подтверждение пользователю до проверки ответа сети.
  • Нет обработки кодов ошибок: все отказы выглядят как успех.

Каждая из этих ошибок обнаруживается на тестовой отправке, поэтому не пропускайте проверку перед запуском трафика.

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

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

Можно ли отправлять форму прямо в Лидпульт из браузера?

Не рекомендуется: секретный ключ окажется в коде страницы. Отправляйте с сервера.

Нужно ли хранить заявки у себя?

Рекомендуется хотя бы временно: это даёт возможность повторить отправку при сбое и сверить данные. Храните персональные данные в соответствии с законом.

Какой лендинг использовать: свой или из Лидпульта?

Если нужны быстрый старт и сплит-тесты, подойдёт лендинг сети. Свой лендинг нужен для уникальной воронки и своей аналитики.

Как передать город, если пользователь его не выбирает?

Можно предложить выбор из списка городов оффера. Нераспознанный город вернёт ошибку city_not_found.