hover_qualified

Что означает

Фиксирует интерес/сомнение без клика: завис над кнопкой, формой, карточкой, ценой.

Источник

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

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

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

Пользователь навёлся на размеченный объект дольше порога.

Зачем нужно

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

Поля payload

Поля контракта из Excel: object_type, object_code, hover_ms, hover_threshold_ms, hover_instance_index.

Поля mapping/context: page_code, block_code, group_code, element_code, mapping_status.

Общие поля 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": "hover_qualified",
  "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": {
    "target_hash": "hash_hero_cta",
    "visible_ms_delta": 5000,
    "qualification": "reserved_not_emitted"
  }
}

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

Сырые значения форм, поля, textarea/select, email, телефон, имя, адрес и комментарии.
Сырые query string URL, cookies, значения localStorage/sessionStorage, innerHTML/outerHTML, полный DOM и полный текст страницы.
Сырые координаты или поток движения указателя; разрешены только агрегаты и buckets.

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

Если mapping неизвестен — object_code=unknown только для QA или drop по config.

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

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

Ожидаемые окна live-debug: Указатель и hover.

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

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

session_snapshot_updated
bot_score_updated, когда хватает контекста сессии

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

Builds pointer movement, stop-count, exit-intent, and suspicious-motion features without raw trajectories.

QA-проверки checklist

Move pointer over the page and exit through the top edge.
Проверьте агрегированные счетчики или exit_intent, а не координаты.