Интеграция лендинга с API: как довести заявку от формы до лида
Собственный лендинг даёт контроль над дизайном и аналитикой, но требует аккуратной связки с API. Разбираем путь заявки от формы до ответа сети и типичные ошибки на этом пути.
Когда нужен собственный лендинг
Лидпульт предоставляет лендинги, потоки и сплит-тесты, и для многих задач их достаточно. Собственный лендинг нужен, когда вы хотите уникальный дизайн, нестандартную воронку или квиз, интеграцию с вашей аналитикой, или когда вы переносите на Лидпульт уже работающую страницу. Тогда форма на вашей странице отправляет данные вам, а вы передаёте заявку в сеть через /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.