Начните с вопроса «что считаем конверсией?». Нажатие на submit ещё не означает заявку: браузер может остановить валидация, API может вернуть ошибку, а пользователь — нажать повторно. Для большинства lead-форм событие должно появиться после подтверждения сервера и только один раз для одного результата.
Диагностика идёт слева направо. Если приложение не вызвало dataLayer.push, настройка trigger не поможет. Если Custom Event виден в Tag Assistant, но tag имеет статус Not Fired, проблема уже в условиях GTM. Если tag fired, а событие отсутствует в отчёте, проверяйте payload, consent и приёмник.
Одна отправка проходит пять наблюдаемых точек
| Точка | Что должно произойти | Что сохранить |
|---|---|---|
| Форма | Валидация прошла, начался запрос | form_id и test_run_id |
| API | Сервер подтвердил создание заявки | HTTP status и result id |
| dataLayer | Появился lead_submit_success | Event и параметры |
| GTM | Trigger совпал, tag получил значения | Firing status и переменные |
| Приёмник | Ушёл запрос измерения | Имя события и debug response |
Не начинайте с итогового отчёта: он может обрабатываться с задержкой и не показывает, был ли вызван GTM. Preview/Tag Assistant позволяет увидеть порядок событий и почему тег сработал либо не сработал. Сетевой запрос в DevTools дополняет эту картину, но не доказывает, что сервер формы сохранил заявку.
Событие рождается рядом с бизнес-результатом
async function submitLead(formData) {
const response = await fetch('/api/leads', {
method: 'POST',
body: formData,
headers: { 'Idempotency-Key': crypto.randomUUID() }
});
const result = await response.json();
if (!response.ok || result.status !== 'created') {
showError(result.message);
return;
}
window.dataLayer = window.dataLayer || [];
window.dataLayer.push({
event: 'lead_submit_success',
form_id: 'consultation',
lead_type: 'callback',
test_run_id: window.__analyticsTestRun || undefined
});
}Пример условный: контракт успеха и идемпотентности зависит от API. В dataLayer не кладите имя, телефон, email, текст сообщения и другие поля формы. Для отладки достаточно стабильного form_id и синтетического test_run_id. Если сервер возвращает существующую заявку при повторе, явно решите, должен ли повтор снова создавать аналитическое событие.
Custom Event надёжнее перехвата изменённого submit
Google описывает Custom Event как подходящий вариант, когда стандартное поведение формы изменено, например submit перехвачен JavaScript. Создайте trigger с точным именем lead_submit_success и привяжите к нему tag. Имя в интерфейсе GTM и значение event в push чувствительны к регистру и должны совпадать.
- Не используйте Click trigger как замену подтверждённой заявке.
- Не назначайте один слишком широкий regex всем формам без form_id.
- Не переопределяйте window.dataLayer после загрузки контейнера.
- Публикуйте версию контейнера только после Preview-проверки.
- Отдельно тестируйте валидационную ошибку и ответ API 4xx/5xx.
- Проверьте повторный клик, возврат Back и повторную отправку.
Not Fired объясняется конкретным условием
Откройте нужный Custom Event в Tag Assistant и сравните значения переменных именно на этом событии, а не на Page View. Частая ошибка: form_id появляется позже или хранится под другим именем. Встроенная переменная Event должна содержать lead_submit_success. Затем раскройте tag и прочитайте, какое условие trigger не выполнилось.
| Наблюдение | Вероятная причина | Следующая проверка |
|---|---|---|
| Custom Event отсутствует | Код успеха не выполнился | Ответ API и console до push |
| Event есть, tag Not Fired | Не совпал trigger/filter | Event, form_id и оператор |
| Tag Fired дважды | Два listener или повторный callback | Имена событий и request id |
| Tag Fired, запроса нет | Consent, blocker или ошибка шаблона | Consent state и console/network |
| Запрос есть, отчёт пуст | Неверный stream/property/event | DebugView и tag configuration |
Consent проверяется на том же событии
Состояние согласия может меняться между загрузкой страницы и отправкой формы. Google рекомендует использовать Consent APIs, чтобы обновление consent обрабатывалось до событий в очереди dataLayer. В Preview смотрите consent state на lead_submit_success и не пытайтесь обходить выбор пользователя дополнительным тегом или прямым запросом.
Блокировщик рекламы тоже возможен, но это не первая гипотеза. Сначала подтвердите работу на чистом поддерживаемом браузере и в тестовом контейнере. Затем сравните один и тот же test run с расширениями и без них. Не просите пользователя отключать защиту как постоянное исправление.
Приёмка включает отрицательные сценарии
- Успешная новая заявка: одно событие и один tag request.
- Ошибка обязательного поля: события успеха нет.
- Ответ сервера 500: события успеха нет, форма показывает ошибку.
- Двойной клик: заявка и событие не дублируются по принятому контракту.
- Повтор существующей заявки: поведение документировано и проверено.
- Согласие запрещает аналитику: настройки пользователя соблюдаются.
Готовый результат — не зелёный статус тега в одном удачном клике, а совпадение трёх чисел на тестовой выборке: подтверждённые сервером заявки, уникальные события dataLayer и принятые события аналитики. Для разбора подготовьте export контейнера без секретов, screenshot Event Summary, имена trigger/tag, обезличенный ответ API и время теста.