Тестирование интеграции с API: что проверить до запуска трафика
Ошибка в интеграции стоит дороже всего в первый день с живым трафиком: клики оплачены, а заявки не доходят или не возвращаются в трекер. Собрали чек-лист проверок, которые стоит пройти заранее.
Почему тест нужен до трафика
Реклама тратит деньги с первого клика. Если форма на лендинге не отправляет лид, если метки теряются или постбэк не доходит, вы узнаете об этом по косвенным признакам, а вернуть уже потраченный бюджет нельзя. Тестирование на небольшом количестве запросов стоит несколько минут и закрывает большинство типовых ошибок. Лучше потратить час перед запуском, чем день после него.
Тест делится на три слоя: отправка лида в сеть, получение ответа и обработка его на вашей стороне, возврат статусов постбэком. Каждый слой проверяется отдельно, потом проходит сквозная проверка.
Правила безопасного тестирования
Заявка в Лидпульт доходит до клиники: ей приходит уведомление, возможно, звонок. Поэтому нельзя отправлять тестовые заявки наугад на живые офферы. Договоритесь о тестировании с менеджером через контакты: узнайте, по какому офферу и с какими данными можно проверять, и сообщите метки, которые будете использовать. Тестовые заявки с выдуманными телефонами и фейковыми данными в рабочем потоке нарушают правила трафика.
Слой 1. Проверка отправки
- Убедитесь, что ключи wmkey и apikey верны. Неверные ключи вернут bad_key.
- Отправьте запрос с корректными обязательными параметрами и проверьте ответ status ok и lead_id.
- Намеренно уберите один обязательный параметр и убедитесь, что приходит bad_request, а ваш код его обрабатывает.
- Передайте неверный телефон и проверьте реакцию на bad_phone.
- Отправьте один и тот же apiid дважды и убедитесь, что второй ответ содержит тот же lead_id и признак повтора.
Пункты с намеренными ошибками выполняйте только в согласованном режиме, чтобы не создавать лишних заявок: ошибки валидации лид не создают, но лучше уточнить условия у менеджера.
Слой 2. Проверка ответов и повторов
Смоделируйте сбои. Временно подставьте неверный адрес и убедитесь, что обработчик корректно ловит сетевую ошибку и повторяет отправку с тем же apiid. Проверьте, что на 4xx повтор не выполняется. Проверьте таймаут: искусственно замедлите ответ и посмотрите, что произойдёт у пользователя на лендинге. Форма должна либо подтвердить приём, либо сообщить о временной недоступности, но не зависнуть без реакции.
Слой 3. Проверка постбэка
Задайте адрес постбэка в кабинете и нажмите кнопку проверки. Откройте журнал отправок: код ответа должен быть 200, адрес без неподставленных макросов. Затем откройте трекер и убедитесь, что тестовая конверсия записана и привязана к нужному клику. Если в вашем трекере есть режим тестовых конверсий, воспользуйтесь им, чтобы не искажать реальные отчёты. Если нет, пометьте тестовые события и исключите их из итоговых данных.
Сквозной тест
Пройдите путь глазами пользователя: откройте рекламную ссылку, дойдите до формы, отправьте заявку (по согласованию) и проследите её: появилась ли она в кабинете, пришло ли событие в трекер, совпали ли метки. Проверьте ровно ту цепочку, которая будет работать на боевом трафике: те же домены, те же редиректы, тот же браузер и мобильное устройство. Многие ошибки выявляются только на смартфоне: например, лишний редирект отрезает параметры.
Чек-лист перед запуском
- Ключи сохранены в безопасном месте и не лежат в клиентском коде.
- Все обязательные параметры отправляются, телефон и город передаются корректно.
- apiid присутствует и не меняется при повторе.
- Ошибки 4xx и 5xx обрабатываются по-разному.
- Адрес постбэка публичный, проверка кнопкой прошла.
- Статусы сопоставлены с событиями трекера.
- Идентификатор клика доходит до постбэка.
- Тестовые данные убраны из отчётов.
Что делать после запуска
Первые часы живого трафика наблюдайте внимательно. Проверьте, что число отправок в сеть примерно соответствует числу заявок на лендинге, что журнал отправок постбэка не содержит неудачных записей и что в трекере появляются конверсии. Если что-то расходится, остановите трафик и разберитесь: потери на этом этапе обычно дешевле, чем продолжение работы вслепую. Подробнее о проверке постбэка читайте в документации.
Автоматизация проверок
Когда интеграция стабильна, часть проверок можно автоматизировать. Скрипт раз в сутки проверяет доступность вашего приёмного адреса постбэка, правильность сертификата и скорость ответа. Другой скрипт сопоставляет число заявок в вашей базе и число лидов, возвращённых сетью. Третий следит за долей отказов по кодам. Автоматические проверки не заменяют ручное тестирование перед запуском, но замечают поломки, которые возникают позже: истёкший сертификат, смену адреса, обновление сервера.
Повторное тестирование после изменений
Любое изменение в цепочке требует перепроверки: смена домена лендинга, обновление трекера, перенос сервера, новый прелендинг, изменение формы, перевыпуск ключа API. Не рассчитывайте, что «это же мелочь». Именно мелочи ломают передачу параметров. Пройдите короткую версию чек-листа: отправка, ответ, метка, постбэк, конверсия в трекере. Пять минут проверки дешевле дня потерянного трафика.
Документация тестов
Результаты проверок полезно записывать: дата, что проверяли, какие значения использовали, что получили, кто проверял. Эта запись становится частью документации интеграции. Когда через несколько месяцев вам придётся менять сервер или нанимать нового разработчика, у него будет понятная отправная точка, а не только код. Храните вместе с заметками образцы запросов и ответов с замаскированными ключами: они помогают быстро воспроизвести проблему.
Если вы работаете в команде, назначьте ответственного за интеграцию: он следит за изменениями в документации API и обновляет проверки.
Отдельно проверьте поведение при нехватке данных: что увидит пользователь, если сеть не ответила, и сохранится ли его заявка у вас. Эта проверка быстро показывает, насколько интеграция устойчива к сбоям, а не только к идеальным условиям.
Если после запуска вы меняете схему меток или адрес постбэка, повторите тест полностью: небольшая правка шаблона нередко ломает передачу идентификатора.
Вопросы и ответы
Есть ли отдельная тестовая среда?
В документации тестовая среда не описана. Договаривайтесь о проверках с менеджером и используйте минимальное число согласованных запросов.
Как проверить постбэк без реальных лидов?
Используйте кнопку проверки постбэка в кабинете: она отправляет тестовый запрос на ваш адрес, а результат виден в журнале.
Сколько тестовых заявок нужно?
Обычно достаточно одной-двух для каждого сценария. Лишние заявки только создают нагрузку на клинику.
Нужно ли тестировать на мобильных?
Да. Большая часть трафика приходит со смартфонов, и редиректы, скрипты и формы там ведут себя иначе, чем на компьютере.