VOC v2 – Analytics & Reminder

DomainsDOL EnglishUX1.024 words5 min read

active

Hardening sync: Event taxonomy được đồng bộ theo ../Core Logic/VOCV2_Product_Spec_Hardening_v1.md.

Mục tiêu đo lường

Hiểu hiệu quả SRS (tăng F, giữ decay thấp), phiên học, chuyển đổi Pro (Option A/B), và hiệu quả reminder.
Tách rõ cấp session vs item; track option truy cập.

vocab_session_start
- params: mode (timed|untimed), duration_target (phút, null nếu untimed), group_size, subject, listId?, entry_point (home|reminder|goal_popup), access (pro|trial|free).
vocab_micro_batch_generated
- params: batch_size, tier1_count, tier2_count, tier3_count, new_count, review_count, mixing_state (A|B|C).
vocab_session_end
- params: mode, duration_actual, items_seen, items_new, items_review, correct_count, incorrect_count, streak_days, access.
- derived: accuracy, items/hour.

vocab_item_answered
- params: itemId, subject, skill, result (success|fail), F_before, F_after, D_before, D_after, successCount_before, failCount_before, is_new (first-time), is_trial_item (Option A).
- dùng để backfill phân phối F/D và kiểm định công thức.
vocab_item_presented
- params: itemId, tier, skill, exercise_type, difficulty, is_retry, difficulty_level (0..5), skill_profile (core|new_ramp|urgent_repair|mastery_expand), skill_bucket (primary|adjacent|cross), difficulty_target_ratio, skill_target_ratio, difficulty_deficit_before, skill_deficit_before, selection_reason (normal|deficit_fill|fail_override|fallback), fallback_level (0..4).
vocab_retry_scheduled
- params: itemId, delay_items, retry_count_in_session.
vocab_exercise_distribution_snapshot
- params: difficulty_window_size, skill_window_size, difficulty_level, skill_profile, difficulty_mix_actual, difficulty_mix_target, skill_mix_actual, skill_mix_target, difficulty_deviation_pp, skill_deviation_pp.

vocab_leaderboard_view
- params: context (set|course|global), tab (cultivators|sleeping_beauties|…), duration.
vocab_revive_action
- params: itemId, start_state (withering|dead), result (success|fail).
vocab_social_interaction
- params: action (cheer|nudge), target_user_id, source (leaderboard|notification).

vocab_list_saved_event
- params: userId, listId, listSource (community|course), is_unique_save.
vocab_list_created_event
- params: userId, listId, listSize, is_qualified_created_list.
vocab_word_learned_qualified_event
- params: userId, itemId, skill, qualifiedTouches, is_first_learned_word.
vocab_list_completed_event
- params: userId, listId, listSize, masteryRate, is_qualified_completion.
vocab_achievement_unlocked_event
- params: userId, achievementId, tier, award_key, rule_version.
vocab_badge_awarded_event
- params: userId, badgeId, rarity, achievementId, tier.
vocab_achievement_reward_granted_event
- params: userId, grant_key, rewardPoints, weeklyCapState.

vocab_care_points_computed_event
- params: userId, retentionIndex, recoveryIndex, masteryIndex, consistencyIndex, vocab_care_points_week, rule_version.
learning_points_week_computed_event
- params: userId, practice_points_week, vocab_care_points_week, learning_points_week, module_eligibility, rule_version.
learning_points_reward_granted_event
- params: userId, learning_points_week, reward_points_earned_week, reward_cap_state.

vocab_reminder_sent (itemId, subject, reason=threshold_cross, F_now).
vocab_reminder_opened (latency).
vocab_session_start với entry_point=reminder để đo conversion từ thông báo sang học thật.
vocab_recap_cta_clicked
- params: cta (quick_fix|learn_more|back_home), needs_care_count.

Access: view list → practice start (by option) → lock/allow → session start → session end → Pro CTA → convert.
SRS hiệu quả: item answered (fail→success over time) → F_after distribution → retention (tỷ lệ F>=threshold sau N ngày).
Reminder: reminder_sent → reminder_opened → session_start(entry_point=reminder) → item_answered (các item được nhắc).

Retention per subject: % item có F_now >= threshold theo tuần.
Fail-heavy items: top item có failCount cao / decay cao để cải thiện nội dung.
Session adherence: % user dùng timed vs untimed, avg duration, items/phiên.
Conversion: CTR upsell, trial → Pro (Option A) hoặc free view → Pro (Option B).
Urgent dominance rate: % batch có tier1 chiếm >50%.
Doom loop rate: % item chạm max retry/session.
Skill alignment rate: % lượt exercise trùng skill item.
Difficulty ratio deviation: độ lệch giữa mix actual vs target theo difficulty_level.
Skill ratio deviation: độ lệch giữa mix actual vs target theo skill_profile.
Cross-skill urgent rate: % lượt Tier 1/2 bị chọn Cross-skill.
Fail override trigger rate: % item chạm rule force easy do fail streak.
Time-to-recover: số session để item từ Needs Care -> Healthy.
Vocab badge unlock rate theo family:
- save_list, create_list, learned_words_count, completed_lists_count.
Duplicate prevention hit rate:
- tỉ lệ event bị chặn do uniqueness/idempotency.
Reward cap pressure:
- % user chạm vocab_achievement_reward_cap_week.