Перед выпуском аналитики проверяй не «срабатывает ли кнопка», а соответствие конкретного действия ожидаемой схеме событий. Один пользовательский шаг может закономерно породить несколько разных событий: например, отправку формы и подтверждённый сервером успех; для неудачной попытки предусмотрено отдельное событие ошибки. Не принимай автоматически собранный form_submit за подтверждение успешной регистрации. Google описывает ручную настройку событий и параметры отдельно от автоматических событий (GA4 events).
Зафиксируй карту событий
Для каждого сценария опиши действие, ожидаемые event names, параметры, состояние consent и число ожидаемых отправок. Укажи, какое событие означает только намерение, а какое подтверждено сервером. Пример синтетической регистрации:
| Действие/условие | Ожидаемые события | Проверка |
|---|---|---|
| Открыть форму | sign_up_form_view один раз |
SPA/back не создаёт дубль |
| Начать ввод | form_start при первом начале |
повторный focus не повторяет событие без правила |
| API вернул validation error | form_error с разрешённым кодом поля |
нет email или введённого текста |
| Пользователь отправил форму | form_submit как попытка/submit-сигнал |
не трактовать как завершение |
| Backend создал аккаунт и UI получил подтверждение | registration_success / sign_up_completed по утверждённой схеме |
только после серверного успеха; один раз на созданную запись |
Названия здесь иллюстративные, это не обязательная схема Google. Продукт выбирает имена и семантику; принципиально не смешивать попытку отправки с результатом API. Одно действие может вызвать два разных события, поэтому «один event на любое действие» — плохой универсальный критерий.
Прогони тестовые и отрицательные сценарии
В тестовом аккаунте проверь первый визит, повторное открытие формы, ошибку валидации, успешный ответ backend, повторный клик, переход назад/вперёд в SPA и отказ от consent. Для каждого укажи число событий и требуемые параметры. В Network можно увидеть попытку отправки; DebugView помогает проверить тестовые события, а консоль и Troubleshooter — диагностировать конфигурацию (GA4 troubleshooting). HTTP 200/204 доказывает только ответ на запрос, но не правильную семантику события или полноту production-настройки.
Если интеграция дополнительно отправляет события через Measurement Protocol, используй его validation endpoint для проверки формата payload. Google предупреждает: такие запросы не попадают в отчёты, а api_secret и firebase_app_id валидатор не проверяет. Это отдельный инструмент для MP, а не обязательная пересылка браузерных gtag/GTM-событий через сервер. Для браузерной настройки включи тестовый debug mode и сопоставь действие, сетевой запрос и событие в DebugView. Затем отдельно проверь рабочую property и ожидаемый отчёт. Не отправляй реальные email, client IDs или секреты в промпт/скриншоты.
Сверь фактический лог
Для каждого кейса сравни expected с обезличенной записью: event name, разрешённые параметры, количество, timestamp и consent. Не пиши PII в параметрах; проверь, что ошибка не содержит введённый текст. Если backend вернул ошибку, registration_success отсутствует. Если сервер создал аккаунт, success-событие связано с этим подтверждённым результатом и не дублируется при повторном рендере страницы.
Пример обнаруженного дубля
Учебная схема требует ровно один registration_success после создания аккаунта. Все наблюдения ниже вымышлены:
| Кейс | Ответ тестового backend | Число success в логе | Решение |
|---|---|---|---|
| Ошибка обязательного поля | validation error | 0 | Соответствует схеме; отдельно проверить form_error |
| Регистрация без повторного рендера | created | 1 | Соответствует схеме |
| Тот же результат, компонент повторно отрисовался | created | 2 | Дубль: исправить место отправки, повторить сценарий |
В третьей строке не нужны две регистрации, чтобы получить два события: причиной может быть повторный обработчик UI. Не объявляй это доказанной причиной до проверки кода. Зафиксируй шаг воспроизведения, проверь место вызова и повтори тест после исправления. Отсутствие дубля в одном кейсе не подтверждает остальные кейсы матрицы.
Промпт для генерации тест-матрицы:
По приложенной схеме GA4 создай QA-матрицу: действие, ожидаемые event names (их может быть несколько), параметры, число отправок, отрицательный сценарий и критерий DebugView. Отделяй form_submit/попытку от регистрации, подтверждённой успешным ответом backend. Не проси реальные email, client_id, api_secret или другие секреты. Не называй один HTTP 200 доказательством корректной аналитики.
Когда сбор проверен, можно переходить к анализу воронки формы.
ИИ помогает искать несовпадения схемы и тестов; решение о семантике принимает команда продукта, а production-отчёты проверяются отдельно. Материал подготовлен с помощью ИИ; инструкции Google проверены редакцией 6 ноября 2026 года. Реальная GA4 property не тестировалась.
