Vocab V2 – Notification & Engagement Rules

Tài liệu này quy định chiến lược thông báo (Push Notification / In-app) nhằm tối đa hóa tỷ lệ Retention và Engagement, dựa trên cơ chế “Vườn Cây” (Gamification).

---

0. Governance Precedence (Platform-first)

• Quy tắc gửi ở file này là rule cấp domain Vocabulary.
• Khi tích hợp với notification governor toàn nền tảng:
  • ưu tiên áp dụng rule nghiêm ngặt hơn,
  • nếu mâu thuẫn cap, cap toàn nền tảng thắng.

---

1. Nguyên tắc cốt lõi (Core Principles)

1. High Value, Low Noise: Chỉ gửi thông báo khi thực sự cần thiết (Cây sắp héo, Rớt hạng). Tránh spam các thông báo chung chung (“Học đi bạn ơi”).
2. Actionable: Mỗi thông báo phải gắn với một hành động cụ thể (Deep link) dẫn thẳng đến nơi cần xử lý.
3. Metaphor-driven: Sử dụng ngôn ngữ “Làm vườn” (Tưới cây, Cứu cây, Hạn hán) để tạo cảm xúc.

---

2. Các loại thông báo (Trigger Types)

A. Urgency (Cấp bách - P1)

Mục tiêu: Kéo user vào ôn tập ngay lập tức để tránh cây bị Héo/Chết.

Trigger Event	Điều kiện	Nội dung (Copy gợi ý)	Deep Link
Almost Withered (Sắp héo)	$F$ dự kiến tụt dưới Threshold trong 2h tới.	🆘 Cấp cứu! Cây “Serendipity” của bạn đang khát khô. Tưới ngay kẻo héo!	vocab/review?id={itemId}
Just Withered (Vừa héo)	Item vừa chuyển sang trạng thái Withering (Level cao).	🍂 Ôi không! Cây Cổ thụ “Ubiquitous” vừa rụng lá. Cứu nó ngay trước khi quá muộn!	vocab/revive?id={itemId}
Garden Decay (Cả vườn xuống cấp)	$> 20\%$ số lượng cây trong vườn chuyển sang màu vàng/nâu.	🚨 Báo động hạn hán! Khu vườn của bạn đang xuống cấp trầm trọng.	vocab/garden

B. Social & Competition (Tương tác - P2)

Mục tiêu: Đánh vào Ego và tính cạnh tranh.

Trigger Event	Điều kiện	Nội dung (Copy gợi ý)	Deep Link
Rank Dropped (Rớt hạng)	User bị đẩy khỏi Top 3 (Set/Course).	📉 Mất Top 1 rồi! {RivalName} vừa vượt qua bạn ở Set “IELTS Unit 1”. Lấy lại vị thế ngay!	vocab/leaderboard?set={setId}
Sleeping Beauty (Bị cà khịa)	User lọt vào Top 10 bảng “Sleeping Beauties”.	😴 Dậy đi bạn ơi! Bạn đang đứng Top bảng “Người Giàu Lười Biếng”. Đừng để mọi người cười chê!	vocab/leaderboard?tab=sleeping
Cheered (Được nhắc)	Có người khác bấm “Tưới nước” (Cheer) cho mình.	💧 {FriendName} vừa tưới nước cho bạn! Vào học ngay để đáp lại tấm lòng của họ nào.	vocab/home

C. System & Achievement (Thành tựu - P3)

Mục tiêu: Củng cố động lực tích cực.

Trigger Event	Điều kiện	Nội dung (Copy gợi ý)	Deep Link
Harvest Ready (Thu hoạch)	Có $\ge 5$ cây vừa đạt trạng thái “Flowering” (Mastery).	🌸 Mùa thu hoạch đến rồi! 5 cây của bạn vừa nở hoa. Vào ngắm thành quả nào!	vocab/garden
Weekly Report (Báo cáo tuần)	09:00 AM sáng Thứ Hai hàng tuần.	📊 Tổng kết tuần: Bạn đã cứu sống 12 cây và trồng mới 50 cây. Xem chi tiết.	vocab/analytics

---

3. Quy tắc gửi (Sending Rules)

A. Frequency Cap (Giới hạn tần suất)

• Urgency: domain cap tối đa 2 noti/ngày. Nếu có nhiều cây sắp héo, gộp lại thành 1 noti (“Cứu 5 cây đang héo”).
• Social: domain cap tối đa 1 noti/ngày (Tổng hợp các sự kiện tương tác).
• System: domain cap tối đa 1 noti/tuần (Report).
• Platform override: cap gửi thực tế phải đi qua governor toàn nền tảng; ngưỡng nào nghiêm ngặt hơn sẽ được áp dụng.

B. Do Not Disturb (Giờ yên tĩnh)

• Không gửi noti trong khoảng 10:00 PM - 07:00 AM (theo giờ thiết bị User), trừ khi User cài đặt khác.
• Các noti phát sinh trong giờ này sẽ được queue lại và bắn vào 08:00 AM sáng hôm sau (Morning Briefing).

C. Cool-down

• Một item đã được nhắc “Sắp héo” sẽ không nhắc lại trong 24h (tránh spam cùng một nội dung).

---

4. Tương tác & Dữ liệu

• Xem thêm định nghĩa dữ liệu tại VOCV2_Data_Model.md.
• Xem thêm chỉ số đo lường tại VOCV2_Analytics.md.