Проверка интеграции

Первое событие

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

Позже проверку можно запустить в любой момент: Настройки → Установка, раздел «Проверка подключения».

Экран «Проверка интеграции»

Данные и сбор → Проверка интеграции.

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

Три вкладки.

Нарушения

Список событий, к которым есть претензии.

Столбцы: время в UTC, событие со ссылкой на его карточку в реестре, результат, источник и сведения о проверке. Фильтры — период, имя события, код нарушения и решение. Максимальный период — 31 день, по умолчанию последние 7 суток.

Коды нарушений, которые здесь встречаются:

Код	Что означает
event_unregistered	события нет в реестре
reserved_event	попытка занять зарезервированное имя pp.*
schema_version_unknown	указана версия схемы, которой нет
required_property_missing	не хватает обязательного свойства
property_type_mismatch	тип свойства не совпал со схемой
unknown_property	свойство не описано в схеме
forbidden_property	свойство запрещено к сохранению

Начинайте отсюда: если разметка «поехала», причина почти всегда видна на этой вкладке.

История событий

Последние события с фильтрами по имени, user_id и анонимному идентификатору. Карточка события показывает наблюдавшуюся форму данных — имена полей и их типы JSON, без значений.

Это ровно то, что нужно, чтобы ответить на вопрос «а какой тип у total на самом деле приходит».

Проверка в реальном времени

Живой поток входящих событий. Начинается сразу при открытии вкладки, есть остановка и продолжение. Рядом с потоком видно состояние подключения.

Удобно для проверки «нажал кнопку — увидел событие».

Живой поток на экране событий

Данные и сбор → События — полный список событий проекта.

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

Столбцы: время, событие, посетитель, адрес страницы, устройство, страна. Анонимные посетители показываются как «Аноним» с коротким суффиксом. Фильтры — одно или несколько имён событий, user_id, anon_id и период.

Если событий в проекте ещё нет, экран показывает готовый сниппет для вставки и ссылку на выбор способа подключения.

Реестр событий

Данные и сбор → Реестр событий — описание того, какие события существуют и что у них внутри.

У события есть статус — черновик, активно или устарело — и версии схемы. У каждого свойства указан тип, обязательность и классификация: обычное, возможные персональные данные или запрещённое.

Встроенные события pp.* управляются ActionPulse: их схема фиксирована и не редактируется.

Регистрируя своё событие, укажите имя по правилу ^[a-z0-9_.]{1,128}$ — начинать с pp. нельзя.

Режимы проверки

Режим	Поведение
Выключена	схема не проверяется
Мониторинг	нарушения записываются, событие принимается
Строгая	элемент с ошибкой отклоняется

Отклонённое событие возвращается вызывающему в rejected с кодом schema_violation; отправитель видит это сразу.

Свойства, помеченные как запрещённые, удаляются из сохранённого события в любом режиме, кроме выключенного. Свойства с пометкой «возможные PII» проходят проверку на персональные данные, и совпавшее значение заменяется.

Устаревшие события

Если в отчёте выбрано событие со статусом «устарело», построители воронок, удержания, путей и поведения показывают предупреждение. Это способ вывести старую разметку из обращения, не ломая существующие отчёты.

Порядок проверки после изменения разметки

1. Отправьте событие из нового кода.
2. Посмотрите ответ: 202 и пустой rejected.
3. Откройте «Проверка в реальном времени» и убедитесь, что событие пришло.
4. Проверьте вкладку «Нарушения» за сегодня.
5. Загляните в карточку события в реестре: типы свойств те, что вы ожидали.

Если что-то не сходится — дерево диагностики разбирает причины по кодам ответа.