Thay đổi bản v1.0.15

1 Bản này đổi gì

Đọc 30 giây là đủ nắm. Chi tiết từng phần ở các mục dưới.

2 Flow mở app → màn hình chính: trước và sau

Cùng số màn hình, chỉ bớt thứ chen vào giữa. Chữ đỏ là phần đã bỏ, chữ xanh là phần mới.

Splash        native ads + full-screen ads
              chờ tối thiểu ~4 giây
   │
Intro 5 trang native ads
              khoá vuốt + khoá nút Next 8 giây
   │
Sub (paywall)  → đóng lại thì ra inter ads
   │
Language      native ads #1 + native ads #2
              khoá cả danh sách ngôn ngữ 8 giây
   │
ChooseWallpaper
   │
Hello
   │
Màn hình chính

Splash        full-screen ads
              giao diện mới, không có ads trong màn
   │
Intro 5 trang native ads
              vuốt / bấm được ngay từ giây đầu
   │
Language      native ads #1
              danh sách bấm được ngay
              chọn xong → hiện "Applying language…" ~3 giây
   │
ChooseWallpaper
   │
Hello
   │
Màn hình chính

Từng màn đổi gì

3 Bỏ gì, xoá gì

Danh sách đủ. Cột cuối cho biết việc bỏ đó ảnh hưởng số liệu ra sao.

Bỏ khỏi flow

Xoá khỏi bộ event

7 event bị xoá vì trùng thời điểm với event ngay trước nó. "Màn A xong" và "màn B hiện" là cùng một giây, cùng một đoạn code, không có chỗ nào người dùng bỏ được ở giữa — hai dòng số luôn bằng nhau, đọc chậm mà không thêm thông tin nào.

Toàn bộ tên event bộ cũ đã xoá hẳn khỏi app — ob01…ob17 (lần mở đầu tiên) và rt01…rt05 (các lần mở sau). Không có bản chạy song song hai bộ tên: từ ngày phát hành, tên cũ tụt về 0.

4 Event funnel hiện tại còn gì

Trang chính để đọc funnel vẫn là Flow mở app → Home. Mục này chỉ chốt lại: sau khi cắt, còn đúng những event nào và tên cũ tương ứng là gì.

Lần cài xong mở đầu tiên — 9 step

Một event phụ ở màn Language: on06_lang_select (kèm lang) bắn mọi lần người dùng đổi ý chọn ngôn ngữ khác — cố ý không chống trùng, để đếm số lần đổi ý. Không phải step funnel, đừng kéo vào báo cáo.

Các lần mở app sau — 4 step

Còn đúng 2 vị trí ads có event riêng

Mỗi vị trí có 4 event con cùng tiền tố với step của nó — on03_splash… (hoặc rn03_splash…) và on05_intro…:

Các giá trị của reason khi ads không hiện: rc_off (cấu hình từ xa tắt) · premium (đã mua gói) · not_init (bộ ads chưa khởi tạo kịp) · no_consent (consent không cho) · no_fill (không có ads để trả) · timeout (hết giờ chờ) · loaded_no_show (có ads nhưng không show được) · capped (chặn vì quá gần lần trước) · no_ad.

Dò tên cũ ↔ tên mới

Vị trí native ads ở màn Language vẫn chạy nhưng không có step funnel nào. Nó sống suốt màn nên không có mốc "rời vị trí" để đo. Đếm impression của nó bằng event ad_displayed với param placement = native_language_1 — xem trang Events.

5 Card set_default + carousel promo

Một dialog duy nhất, chạy ở 2 mode. Mode nào chạy khi nào, chặn bởi gì, bấm vào thì đi đâu.

"Lượt" tính thế nào

Một lượt = một lần quay lại màn hình chính. Không còn điều kiện "ở nền quá 10 phút" như thiết kế ban đầu — bỏ đi vì carousel đã bị chặn ở phía sau bằng maxShowsPerDay + minMinutesBetweenShows rồi, và lượt chạy nhanh chính là cái làm card set_default xuất hiện đều đặn.

Số lượt cộng dồn từ lúc cài, không bao giờ reset. mode FULL rơi vào lượt 1, rồi cứ mỗi 5 lượt một lần → 1, 6, 11, 16… Con số 5 đổi được từ xa.

Quyết định — 4 nhánh, xét theo đúng thứ tự này

Limit — chỉ mode FULL mới có

Khi nào KHÔNG hiện

Áp cho cả hai chế độ. Xét trước khi trừ suất, nên lượt bị chặn không tiêu mất suất của ngày.

• Đang không ở màn hình chính (Cài đặt, Theme Store, một app trong app…)
• Đang mở control center hoặc notification center
• Hỏi quyền thông báo chưa xong — hộp thoại hệ thống phải đóng trước
• Đang ở chế độ rung icon để sắp xếp, đang mở menu giữ-icon, hoặc đang mở picker
• Đang có full-screen ads hiện hoặc đang tải — không bao giờ đè dialog lên ads
• Dialog đang mở sẵn (chặn đánh giá lại lần hai)
• Không còn trang nào đủ điều kiện — đã là mặc định + đã mua gói thì carousel rỗng

Sau khi ads mở-app lúc quay lại app chạy xong, cờ "lần chạy này đã hiện carousel" được mở lại — carousel có thể hiện thêm một lần nữa nếu vẫn còn suất ngày và đủ giãn cách.

6 trang trong carousel

Thứ tự trang vừa xoay vòng vừa ưu tiên theo mức dùng: trang của app người dùng ít mở được đẩy lên trước. Xếp theo 4 nhóm mức dùng — 0 lần · 1–3 · 4–10 · trên 10 — trong cùng nhóm thì giữ nguyên thứ tự xoay vòng. Thứ tự được nhớ lại giữa các lần mở app, kể cả trang đang không đủ điều kiện hiện vẫn giữ chỗ trong hàng. Ưu tiên theo mức dùng luôn bật, không còn công tắc tắt nó nữa.

Bấm vào một trang thì gì xảy ra

Đóng bằng cách khác: bấm ra ngoài card hoặc bấm nút back → đóng và ghi nhận là bỏ qua, không xoay thứ tự. Vuốt qua trang khác hoặc bấm dấu chấm → chỉ đổi trang.

Event mới

Param source mới trên mini_app_open

Không phải event mới — mini_app_open đã chạy từ trước. Đợt này nó được gắn thêm param source: mở mini app đó từ chỗ nào.

🧪 Demo thử tại chỗ

Mô phỏng đúng 4 nhánh quyết định ở trên — cùng cách đếm lượt, cùng limit, cùng cách xếp thứ tự trang. Đổi cấu hình rồi bấm các nút hành động để xem chế độ nào chạy, hoặc vì sao không hiện gì.

6 Cấu hình từ xa mới

Đúng 1 khoá mới trong cả bản này. Các công tắc còn lại không đổi — xem trang Remote Config.

Khoá: promo_carousel_config. Kiểu JSON chứ không phải một dãy công tắc rời, vì bên trong có một danh sách thứ tự trang — dạng công tắc số/bật-tắt không diễn tả được danh sách. Không set gì thì app dùng toàn bộ giá trị mặc định ở bảng dưới.

Giá trị mẫu — dán được thẳng vào Firebase

{
  "enabled": true,
  "recurrenceEveryTurns": 5,
  "maxShowsPerDay": 3,
  "minMinutesBetweenShows": 5,
  "pageOrder": ["SET_DEFAULT", "THEME", "SETTINGS", "CONTROL_CENTER", "CHAT_AI", "SUB"]
}

Ba kịch bản chỉnh nhanh

7 Thay đổi ads khác trong cùng đợt

Không thuộc flow mở app, nhưng nằm cùng khoảng thời gian này — ghi ở đây để không ai tưởng chúng rơi khỏi tài liệu.

• Bỏ hẳn 3 vị trí native ads có show rate dưới 35%: trong tab Alarm của Clock (29%) · trong album ảnh của Gallery (32%) · trong thùng rác ảnh của Gallery (30%). Cả ba đều nằm dưới màn hình đầu ở những màn người dùng rời rất nhanh — số request bỏ ra không thu lại được impression tương ứng. Ba tab còn lại của Clock giữ nguyên. Không thêm lại nếu chưa đổi được vị trí đặt slot.
• Native ads ở 2 trang màn hình chính: giờ chỉ bắt đầu load khi trang đã dừng hẳn (trước đây trang bên cạnh được dựng sẵn nên load cả ads của trang người dùng chưa xem). Đồng thời giữ lại ads chưa ai xem thay vì huỷ đi rồi load lại.
• Trả lại inter ads khi đóng màn mua gói từ Cài đặt / Theme Store — xem mục 3.