form_validation_signal

Что означает

Показывает проблемы заполнения формы: пользователь пытался, но столкнулся с ошибкой.

Источник

Контракт Excel/каталога для будущего коллектора SDK; серверный каталог и документация уже подготовлены до реализации.

Текущий статус реализации: событие зарезервировано в каталоге; текущий sdk/src/index.js пока не отправляет его напрямую.

Когда отправляется

Форма/поле показало ошибку валидации или invalid event.

Зачем нужно

Помогает отлаживать путь пользователя без сбора персональных данных.
Сохраняет сопоставимость события между версиями SDK через protocol_version и mapping context.
Поддерживает live QA в окнах дашборда, перечисленных ниже.

Поля payload

Поля контракта из Excel: form_hash, field_hash_optional, field_type, validation_error_type_hash, validation_source.

Поля mapping/context: form_code, page_code.

Общие поля envelope всегда включают event_id, event_type, event_ts, event_index, session_id, tab_id, page_instance_id, page_code, block_code, element_code, group_code, mapping_status и mapping_confidence.

Пример payload


{
  "event_type": "form_validation_signal",
  "protocol_version": "sf.events.v1",
  "event_id": "evt_example",
  "session_id": "sess_example",
  "page_code": "catalog_page",
  "block_code": "unknown",
  "element_code": "unknown",
  "mapping_status": "mapped",
  "payload": {
    "field_type": "email",
    "field_index": 0,
    "validation_state": "reserved_not_emitted"
  }
}

Запрещенные данные

Any typed value from the form control, including values supplied by autofill.
Сырые значения форм, поля, textarea/select, email, телефон, имя, адрес и комментарии.
Сырые query string URL, cookies, значения localStorage/sessionStorage, innerHTML/outerHTML, полный DOM и полный текст страницы.
Сырые координаты или поток движения указателя; разрешены только агрегаты и buckets.

Резервное поведение и ошибки

Если текст ошибки доступен — не отправлять raw, только hash/len bucket или error category.

Если опциональный mapping недоступен, оставляйте page_code, block_code, element_code или group_code как unknown; не блокируйте страницу и не добавляйте небезопасные резервные данные.

Экран дашборда

Ожидаемые окна live-debug: Формы.

QA также должен видеть строку в Лента сессии, если событие относится к загруженной сессии.

Использование в server-derived обработке

form_progress_features

Использование в ML

Builds form progress, abandon, submit-attempt, and friction features without field values.

QA-проверки checklist

Focus, change, blur, and submit a test form.
Проверьте, что значение поля не попадает в payload или rejected строки.