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

Тестирование интеграции с API: что проверить до запуска трафика

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

· 5 мин чтения

Почему тест нужен до трафика

Реклама тратит деньги с первого клика. Если форма на лендинге не отправляет лид, если метки теряются или постбэк не доходит, вы узнаете об этом по косвенным признакам, а вернуть уже потраченный бюджет нельзя. Тестирование на небольшом количестве запросов стоит несколько минут и закрывает большинство типовых ошибок. Лучше потратить час перед запуском, чем день после него.

Тест делится на три слоя: отправка лида в сеть, получение ответа и обработка его на вашей стороне, возврат статусов постбэком. Каждый слой проверяется отдельно, потом проходит сквозная проверка.

Правила безопасного тестирования

Заявка в Лидпульт доходит до клиники: ей приходит уведомление, возможно, звонок. Поэтому нельзя отправлять тестовые заявки наугад на живые офферы. Договоритесь о тестировании с менеджером через контакты: узнайте, по какому офферу и с какими данными можно проверять, и сообщите метки, которые будете использовать. Тестовые заявки с выдуманными телефонами и фейковыми данными в рабочем потоке нарушают правила трафика.

Не создавайте тестовыми заявками нагрузку на клинику и не тратите лимиты оффера. Один-два согласованных запроса достаточно для проверки.

Слой 1. Проверка отправки

  1. Убедитесь, что ключи wmkey и apikey верны. Неверные ключи вернут bad_key.
  2. Отправьте запрос с корректными обязательными параметрами и проверьте ответ status ok и lead_id.
  3. Намеренно уберите один обязательный параметр и убедитесь, что приходит bad_request, а ваш код его обрабатывает.
  4. Передайте неверный телефон и проверьте реакцию на bad_phone.
  5. Отправьте один и тот же apiid дважды и убедитесь, что второй ответ содержит тот же lead_id и признак повтора.

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

Слой 2. Проверка ответов и повторов

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

Слой 3. Проверка постбэка

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

Сквозной тест

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

Чек-лист перед запуском

  • Ключи сохранены в безопасном месте и не лежат в клиентском коде.
  • Все обязательные параметры отправляются, телефон и город передаются корректно.
  • apiid присутствует и не меняется при повторе.
  • Ошибки 4xx и 5xx обрабатываются по-разному.
  • Адрес постбэка публичный, проверка кнопкой прошла.
  • Статусы сопоставлены с событиями трекера.
  • Идентификатор клика доходит до постбэка.
  • Тестовые данные убраны из отчётов.

Что делать после запуска

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

Автоматизация проверок

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

Повторное тестирование после изменений

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

Документация тестов

Результаты проверок полезно записывать: дата, что проверяли, какие значения использовали, что получили, кто проверял. Эта запись становится частью документации интеграции. Когда через несколько месяцев вам придётся менять сервер или нанимать нового разработчика, у него будет понятная отправная точка, а не только код. Храните вместе с заметками образцы запросов и ответов с замаскированными ключами: они помогают быстро воспроизвести проблему.

Если вы работаете в команде, назначьте ответственного за интеграцию: он следит за изменениями в документации API и обновляет проверки.

Отдельно проверьте поведение при нехватке данных: что увидит пользователь, если сеть не ответила, и сохранится ли его заявка у вас. Эта проверка быстро показывает, насколько интеграция устойчива к сбоям, а не только к идеальным условиям.

Если после запуска вы меняете схему меток или адрес постбэка, повторите тест полностью: небольшая правка шаблона нередко ломает передачу идентификатора.

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

Есть ли отдельная тестовая среда?

В документации тестовая среда не описана. Договаривайтесь о проверках с менеджером и используйте минимальное число согласованных запросов.

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

Используйте кнопку проверки постбэка в кабинете: она отправляет тестовый запрос на ваш адрес, а результат виден в журнале.

Сколько тестовых заявок нужно?

Обычно достаточно одной-двух для каждого сценария. Лишние заявки только создают нагрузку на клинику.

Нужно ли тестировать на мобильных?

Да. Большая часть трафика приходит со смартфонов, и редиректы, скрипты и формы там ведут себя иначе, чем на компьютере.