form_progress_features
Что означает
Считает прогресс формы без значений полей.
Form-признаки отслеживают прогресс и abandon без чтения значений.
Исходные события
- form_detected
- form_field_focus
- form_field_blur
- form_field_change_signal
- form_submit_attempt
- form_validation_signal
Алгоритм
- Триггер: После каждого form event.
- Расчет: forms_seen, form_start_flag, touched_fields_count, form_active_ms, submit_attempt_flag, validation_error_count.
- Приоритет:
P0; рассчитывается сервером:Да. - Не просите SDK отправлять
form_progress_featuresнапрямую: сервер выводит это событие из принятых source-событий или безопасных импортов.
Текущий статус реализации: отправляется текущим backend/app/services/derived_processor.py, когда присутствуют нужные source-сигналы.
Формат хранения
Хранится в sf_server_derived_events с derived_type = "form_progress_features", derived_ts, source_event_id, если строка связана с конкретным source-событием, а также batch_id, session_id, mapping_version и payload_json.
Для агрегатов уровня сессии source_event_id может быть пустым; последнее состояние сессии также отражается в sf_session_snapshots, когда это применимо.
Пример payload
{
"derived_type": "form_progress_features",
"source_event_id": "evt_example_or_empty",
"mapping_version": "map_active",
"payload": {
"forms_seen": "example",
"form_start_flag": "example",
"touched_fields_count": "example",
"form_active_ms": "example",
"submit_attempt_flag": "example",
"validation_error_count": "example"
}
}Примеры и допустимые значения из Excel: form_start=true, touched_fields=3, submit_attempt=true.
Крайние случаи
Если blur/change не пришли — считать по focus/submit partial.
Если обязательных checkpoints не хватает, снижайте confidence или помечайте payload как partial. Никогда не синтезируйте положительный intent-сигнал только из-за отсутствия события.
Дашборд
Ожидаемое окно live-debug: Формы.
Если строка относится к загруженной сессии, она также должна находиться в окне Лента сессии.
Использование в ML
form_start, submit_attempt, abandon risk, funnel features.
Используйте стабильные codes и buckets вместо сырого текста, сырых URL или строк из DOM. Отсутствующие значения должны быть явными (not_available, unknown, partial), чтобы CatBoost отличал отсутствие сигнала от отрицательного сигнала.
Использование в детекции ботов
Слишком быстрое заполнение/отправка — сильный bot/spam signal.
Логика детекции ботов должна комбинировать этот признак с независимыми поведенческими сигналами; эта страница не разрешает fingerprinting, cookies, canvas/WebGL/audio probes или сырые значения форм.
QA-проверки checklist
- Сгенерируйте перечисленные source-события в одной сессии.
- Запустите server-derived обработку для этой сессии.
- Проверьте, что
sf_server_derived_eventsсодержит строкуderived_type = "form_progress_features"или что событие явно помечено как еще не реализованное. - Откройте окно live-debug дашборда
Формыи проверьте, что строка ссылается обратно на эту страницу. - Проверьте, что
payload_jsonсодержит только безопасные поля из списка выше и не содержит сырые ПДн, query string, cookies или значения форм.