object_visibility_checkpoint

Что означает

Универсально считает среднее время просмотра, возвраты к объектам и порядок просмотра без финального summary.

Источник

Коллектор SDK runtime в sdk/src/index.js.

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

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

Регулярная видимость размеченных объектов: блоков, элементов, карточек/групп.

Зачем нужно

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

Поля payload

Поля контракта из Excel: object_type, object_code, visible_ms_delta, active_visible_ms_delta, max_visible_pct, view_instance_index, is_return_view, gap_since_prev_visible_ms, item_index optional.

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

Общие поля 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": "object_visibility_checkpoint",
  "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": {
    "visible_ms_delta": 15000,
    "active_visible_ms_delta": 5000,
    "max_visible_pct": 75,
    "return_views": 2
  }
}

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

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

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

Если объект исчез из DOM — отправить накопленный delta на следующем flush; unknown — только если debug/QA включен.

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

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

Ожидаемые окна live-debug: Активность и видимость, Blocks & Mapping.

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

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

object_visibility_features
unknown_mapping_detected

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

Builds block/element exposure, return-view, and active-visible-time features.

QA-проверки checklist

Use a mapping version with block/element selectors.
Скролл mapped objects into and out of view.
Проверьте mapped code и buckets видимости.