📺 Quảng cáo trong app

Hướng dẫn cho Tester / BA — quảng cáo xuất hiện khi nào, ở đâu, bao lâu hiện lại. Không cần đọc code.

1 Có 2 kiểu quảng cáo

Toàn màn hình

Che kín màn hình, phải đóng (X / Skip) mới đi tiếp được.

Mở app (splash) — lúc khởi động.

Mở mini-app — Đồng hồ, Thời tiết, Máy tính, Thư viện ảnh, Control Center.

Quay lại app — thoát ra rồi mở lại.

Vài thao tác — vào Cài đặt, đóng mini-app, đổi hình nền.

Chèn trong màn

Một ô quảng cáo nhỏ nằm trong nội dung, không che, vẫn dùng app bình thường.

Nằm ở màn Intro, màn chọn ngôn ngữ, các màn Cài đặt, DailyOpen, App Library, tìm kiếm, Tối ưu app, Thư viện ảnh.

Lúc đang tải sẽ thấy ô xám nhấp nháy (shimmer), tải xong mới hiện quảng cáo.

2 Khi nào KHÔNG có quảng cáo

3 trường hợp này tắt toàn bộ quảng cáo — tester gặp thì là đúng, không phải bug.

User Premium (đã mua / nâng cấp) → sạch quảng cáo ở mọi màn.
Tắt từ server (công tắc tổng) → cả app không có quảng cáo nào.
Chưa đồng ý quảng cáo (popup consent lúc đầu) → không hiển thị cho tới khi đồng ý.

Ngoài 3 cái trên, từng màn còn có công tắc riêng trên server — QA có thể bật/tắt từng vị trí mà không ảnh hưởng chỗ khác.

3 Quảng cáo toàn màn — kịch bản chi tiết

🚀

A · Mở app (splash)

Chỉ ở lần khởi động — màn logo lúc đầu

Người dùng

Bấm icon app từ ngoài, app hiện màn splash.

Sẽ thấy

Quảng cáo toàn màn (mặc định kiểu App Open) khi splash đang chờ.

Quy tắc

Splash giữ tối thiểu 3 giây · chờ quảng cáo tối đa 15 giây · trần cứng cả splash 20 giây. Hết giờ là vào app dù quảng cáo chưa kịp hiện.

Sau đó

Đóng quảng cáo → vào màn Intro (hoặc Chọn ngôn ngữ).

📲

B · Mở mini-app

Đồng hồ · Thời tiết · Máy tính · Thư viện ảnh · Control Center · Hình nền

Người dùng

Bấm icon một mini-app trên màn hình.

Sẽ thấy

Màn "đang tải" hiện ~3 giây trước, RỒI mới đến quảng cáo toàn màn (mặc định kiểu Interstitial).

Sau đó

Lần đầu mở app đó → màn giới thiệu (có 1 ô quảng cáo nhỏ ở dưới). Lần sau → vào thẳng nội dung.

Lưu ý

Phải thấy màn "đang tải" trước quảng cáo. Nếu quảng cáo che ngay lập tức → là bug.

🔄

C · Quay lại app

Thoát ra ngoài (Home/đa nhiệm) rồi mở app lại

Người dùng

Đang ở trong app, thoát ra, lát sau quay lại.

Sẽ thấy

Overlay "Welcome back" hiện, kèm quảng cáo toàn màn.

KHÔNG hiện khi

Đang ở màn hình chính (Home) hoặc màn Tối ưu app — cố tình không hiện để khỏi phiền mỗi lần bấm Home.

👆

D · Vài thao tác đặc biệt

Mặc định ĐANG TẮT — chỉ bật khi server mở

Khi nào

Mở Cài đặt · đóng mini-app về Home · đóng màn chọn hình nền · bấm Đặt làm hình nền.

Sẽ thấy

Quảng cáo toàn màn (Interstitial) hiện trước, đóng xong thao tác mới chạy.

Lưu ý

Đóng quảng cáo là thao tác luôn hoàn tất (hình nền vẫn được đổi, Cài đặt vẫn mở). Không bao giờ kẹt.

4 Quy tắc giãn cách (không spam)

⏱️ Quảng cáo toàn màn kiểu Interstitial cách nhau tối thiểu

60 giây giữa 2 lần hiện liên tiếp (thấp nhất luôn là 30 giây dù server chỉnh thấp hơn).

Vừa xem 1 cái xong, trong vòng 60s làm thao tác khác → không hiện thêm, đi tiếp luôn.
Ngoại lệ: quảng cáo lúc splash không bị giãn cách (luôn được phép hiện).

Hai cái toàn màn không bao giờ chồng nhau. Đang có 1 quảng cáo toàn màn trên màn hình thì cái thứ 2 sẽ bị bỏ, không đè lên. Nếu thấy 2 quảng cáo chồng nhau → là bug.

5 Màn nào có quảng cáo gì

Tra nhanh khi test từng màn.

Màn hình	Toàn màn	Chèn trong màn
Splash (khởi động)	Có	—
Intro (giới thiệu)	—	Có (1 ô dưới)
Chọn ngôn ngữ	—	Có 2 ô — nút Continue chỉ bật sau khi ô thứ 2 tải xong
Mở mini-app (loading)	Có	—
Giới thiệu mini-app lần đầu	—	Có (1 ô dưới)
Màn hình chính (Home)	— cố tình không	—
DailyOpen (vuốt phải)	—	Có (trên cùng)
App Library (vuốt trái)	—	Có (sau 2 nhóm app)
Tìm kiếm (Spotlight)	—	Có (giữa)
Cài đặt (màn chính)	Khi mở mặc định tắt	Có
Các màn Cài đặt con	—	Có (dưới cùng)
Đổi tên app / Đổi icon app	—	Có
Tối ưu app	—	Có (dưới + trong hộp thoại)
Thư viện ảnh	—	Có (giữa header và lưới ảnh)
Đổi hình nền (đóng / đặt)	Khi thao tác mặc định tắt	—

6 Checklist test nhanh

Premium: mua/bật Premium → kiểm mọi màn ở mục 5, phải không còn quảng cáo nào.
Công tắc server tắt: tắt công tắc tổng → cả app sạch quảng cáo.
Splash: mở app → thấy quảng cáo toàn màn, đóng xong vào được app; mạng yếu thì chờ tối đa ~20s vẫn vào được (không treo).
Mini-app: bấm icon → thấy "đang tải" trước, rồi mới quảng cáo (không che ngay).
Lần đầu vs lần sau: mini-app lần đầu có màn giới thiệu, lần sau vào thẳng.
Giãn cách 60s: xem 1 quảng cáo toàn màn, trong 1 phút làm thao tác khác → không hiện thêm.
Không chồng: không bao giờ thấy 2 quảng cáo toàn màn đè lên nhau.
Quay lại app: thoát rồi vào lại (không phải từ Home) → có "Welcome back" + quảng cáo.
Home không phiền: ở Home thoát ra vào lại → KHÔNG có quảng cáo toàn màn.
Không kẹt: đóng quảng cáo ở thao tác (đổi hình nền…) → thao tác vẫn hoàn tất bình thường.
Ô chèn: các màn có ô chèn → thấy shimmer xám lúc tải, tải xong ra quảng cáo (hoặc trống nếu lỗi mạng, không crash).

Ghi chú: "mặc định tắt / cố tình không" là hành vi hiện tại; server có thể bật/tắt từng vị trí. Bản debug luôn dùng quảng cáo test của Google (không phải quảng cáo thật) — đừng báo "quảng cáo sai nội dung" trên bản debug.