Документация данных Salesfocus

page_sequence_computed

Что означает

Восстанавливает маршрут пользователя: откуда пришёл, куда перешёл, где оборвался.

Page-признаки восстанавливают последовательность маршрутов и intent страницы из безопасных page codes, а не из сырых URL.

Исходные события

Алгоритм

  • Триггер: При каждом page_view и batch обработке.
  • Расчет: page_sequence, entry_page_code, last_page_code, page_views_count, page_transition_ms_avg/min/max.
  • Приоритет: P0; рассчитывается сервером: Да.
  • Не просите SDK отправлять page_sequence_computed напрямую: сервер выводит это событие из принятых source-событий или безопасных импортов.

Текущий статус реализации: отправляется текущим backend/app/services/derived_processor.py, когда присутствуют нужные source-сигналы.

Формат хранения

Хранится в sf_server_derived_events с derived_type = "page_sequence_computed", derived_ts, source_event_id, если строка связана с конкретным source-событием, а также batch_id, session_id, mapping_version и payload_json.

Для агрегатов уровня сессии source_event_id может быть пустым; последнее состояние сессии также отражается в sf_session_snapshots, когда это применимо.

Пример payload

{ "derived_type": "page_sequence_computed", "source_event_id": "evt_example_or_empty", "mapping_version": "map_active", "payload": { "page_sequence": "example", "entry_page_code": "example", "last_page_code": "example", "page_views_count": "example", "page_transition_ms_avg_min_max": "example" } }

Примеры и допустимые значения из Excel: sequence: [home_page,catalog_page,product_page].

Крайние случаи

Если page_code unknown — включить unknown в sequence, path_hash сохранить для QA.

Если обязательных checkpoints не хватает, снижайте confidence или помечайте payload как partial. Никогда не синтезируйте положительный intent-сигнал только из-за отсутствия события.

Дашборд

Ожидаемое окно live-debug: Страницы и маршруты.

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

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

entry_page_code, last_page_code, visited_product_page, page_views_count.

Используйте стабильные codes и buckets вместо сырого текста, сырых URL или строк из DOM. Отсутствующие значения должны быть явными (not_available, unknown, partial), чтобы CatBoost отличал отсутствие сигнала от отрицательного сигнала.

Использование в детекции ботов

3 страницы за 2 секунды, регулярные переходы.

Логика детекции ботов должна комбинировать этот признак с независимыми поведенческими сигналами; эта страница не разрешает fingerprinting, cookies, canvas/WebGL/audio probes или сырые значения форм.

QA-проверки checklist

  • Сгенерируйте перечисленные source-события в одной сессии.
  • Запустите server-derived обработку для этой сессии.
  • Проверьте, что sf_server_derived_events содержит строку derived_type = "page_sequence_computed" или что событие явно помечено как еще не реализованное.
  • Откройте окно live-debug дашборда Страницы и маршруты и проверьте, что строка ссылается обратно на эту страницу.
  • Проверьте, что payload_json содержит только безопасные поля из списка выше и не содержит сырые ПДн, query string, cookies или значения форм.

Связанные страницы

Обновлено