Если метки видны в адресной строке, это доказывает только первый участок пути. Откройте Network, отправьте тестовую форму и найдите фактический request payload. Нет utm_source там — исправляйте frontend; есть в запросе, но нет в CRM — переходите к backend mapping и ответу CRM API.
Для теста используйте вымышленные значения вроде source=qa и campaign=crm_trace, добавьте отдельный correlation ID и не вводите реальные контакты. Один ID связывает браузерный запрос, журнал сервера и созданный лид, не раскрывая персональные данные в аналитике.
Путь метки состоит из четырёх контрактов
| Граница | Что должно быть видно | Типичная потеря |
|---|---|---|
| Landing → состояние сайта | utm_source, medium, campaign после разбора URL | Скрипт запускается после удаления query или только на одной странице |
| Состояние → форма | Поля присутствуют в FormData или JSON | Hidden inputs есть в DOM, но custom submit их не читает |
| Backend → модель лида | Нормализованный source snapshot | Allowlist DTO отбрасывает неизвестные поля |
| Модель → CRM API | Явное соответствие внешним field IDs | Поля созданы в CRM, но не включены в mapping |
Не ищите проблему сразу в отчёте рекламы. Сначала подтвердите каждую границу одной заявкой. Успешный HTTP-ответ формы не означает, что CRM приняла дополнительные поля: интеграция может игнорировать неизвестный ключ и всё равно создать контакт.
Фактический payload важнее скрытых полей в HTML
const form = document.querySelector("#lead-form");
const payload = new FormData(form);
const params = new URLSearchParams(location.search);
["utm_source", "utm_medium", "utm_campaign", "utm_id", "utm_content", "utm_term"]
.forEach((key) => payload.set(key, params.get(key) || savedAttribution[key] || ""));
fetch(form.action, { method: "POST", body: payload });FormData, созданный из form, включает успешные именованные controls. Но если приложение собирает JSON вручную, hidden input сам по себе никуда не попадёт — добавьте поля в объект запроса. Источник savedAttribution должен быть определён вашей политикой хранения и согласия, а не случайной глобальной переменной.
Сервер создаёт неизменяемый снимок источника
- Принимайте только известные UTM-ключи и ограничивайте длину значений.
- Храните исходный landing URL отдельно, удаляя из логов чувствительные query-параметры.
- Зафиксируйте правило first-touch, last-touch или обе версии в отдельных полях.
- Не перезаписывайте платный источник пустыми значениями при прямом повторном заходе.
- Привяжите attribution snapshot к заявке до фоновой отправки в CRM.
CRM может переименовывать пользовательские поля, но API часто ждёт стабильный внутренний field ID. Храните mapping в конфигурации по окружениям и проверяйте его при старте интеграции. Название колонки в интерфейсе недостаточно для надёжной отправки.
Повтор интеграции не должен создавать второй лид
Если CRM временно недоступна, очередь повторит запрос. Используйте idempotency key, если CRM его поддерживает, либо собственную связь local lead ID → CRM entity ID. UTM остаются снимком исходной заявки; retry не вычисляет их заново из текущей сессии пользователя.
Контрольная заявка проходит все варианты отправки
- Отправить обычную HTML-форму с тестовыми UTM.
- Повторить AJAX-отправку и форму в модальном окне.
- Перейти на вторую страницу сайта перед отправкой, если источник должен сохраняться.
- Сымитировать временную ошибку CRM и убедиться, что retry не создаёт дубль.
- Сравнить request payload, запись в базе и конкретные field IDs карточки CRM.
Для диагностики подготовьте тестовый URL, обезличенный payload, серверную запись attribution, mapping полей и ответ CRM API без токена. Эта цепочка показывает точное место потери и не требует доступа к рекламному кабинету.