09 — Kiếm tiền (Monetization)

1Mục tiêu & nguyên tắc

Mô hình lai: quảng cáo thưởng (IAA) + IAP, mục tiêu doanh thu IAA ~40% / IAP ~60%. Ba trụ doanh thu: gói định kỳ (Thẻ Tuần/Tháng, Lantern Pass), Triệu Hồi Anh Hùng (sưu tầm + sao), gói đúng khoảnh khắc (Khởi Đầu, Mốc Độ Sâu, Quỹ Xuống Vực).

1.1 Đường xác định (không ngẫu nhiên, không trả tiền) tới từng anh hùng

Đường xác định cho mọi anh hùng là cơ sở tuân thủ ở quốc gia cấm loot box trả phí (§10) và là cam kết "không anh hùng nào chỉ mua được bằng gacha".

2Tỷ giá, định giá & giá khu vực

2.1 Tỷ giá gốc

• Base = 80 KC / $0.99 = 80.8 KC/$ (gói gem_80). Mọi "giá trị/giá" (×base) = giá trị quy đổi KC của gói ÷ (giá USD × 80.8).
• Doanh thu ròng tính 85% giá bán (chương trình small-business của hai store).
• Thang giá USD dùng đúng 10 tier: $0.99, $1.99, $2.99, $4.99, $6.99, $9.99, $14.99, $19.99, $49.99, $99.99. Không SKU nào trên $99.99 (00 D7).

2.2 Bảng định giá (KC-tương đương của một đơn vị)

Mảnh anh hùng được định giá từ tỉ lệ Triệu Hồi công bố (lượt trung bình có bảo hiểm × 270 KC/lượt ÷ số mảnh của thẻ), nên khi đổi tỉ lệ ở §4.2, giá trị mọi gói tự cập nhật.

2.3 Giá khu vực

16 thị trường mới nổi (VN, ID, TH, PH, IN, PK, BD, BR, MX, CO, PE, AR, TR, EG, UA, NG) trả 65% quy đổi của giá USD cho mọi SKU (một hệ số chung giữ nguyên thang giá trị và nhãn % trong từng vùng); vùng khác dùng quy đổi mặc định của store. Đặt bằng play_convert_price + play_upsert_product (bf-store) và App Store Connect price tier tương ứng. price_vnd trong IapCatalog.csv = giá store VN (dự phòng khi store chưa trả giá local).

3Danh mục IAP

Product id: com.blackface.deepstair.<sku>. Nhãn tiếng Anh/khác: #pack_<sku>_name, #pack_<sku>_desc (Localization.csv, 11). Cột luật mở gói của IapCatalog.csv: min_install_day, min_record, min_payer_tier + payer_waiver_day, requires_sku, season_day_min/max, rule_key — không ai bật/tắt SKU bằng tay (LiveOps Auto, 10 §1). IapCatalog.IsOnSale(sku) = trạng thái live · không nằm trong Remote Config iap_hidden_skus · mọi luật đạt (iap_rules_disabled = true bỏ qua cột luật; iap_min_day_disabled chỉ bỏ cột ngày cài). SKU chưa mở không hiện ở Shop, rail, popup hay trigger nào; mua / khôi phục / giao hàng treo không bao giờ hỏi luật.

3.1 Loại sản phẩm (store)

Thẻ Tuần/Tháng là consumable gia hạn thủ công (không phải subscription tự động) — tránh luồng hủy/grace period của subscription và giữ offline-first. Lantern Pass là consumable gắn season_id khi mua.

3.2 Thang giá trị & nhãn profit

Dải giá trị theo mục đích (cột ×base ở bảng §3): tiện ích 1–1.75 · tình huống 2–12 · chuyển đổi 4–20 · gắn kết 8–25 · cam kết 8–30; cosmetic và quà không có dải. Gói ngoài dải phải có lý do chấp nhận trong monetization.py (validator dừng build nếu thiếu) — hiện chỉ starter_pack, remove_ads, vip_adfree (lý do ở §3.3). Nhãn profit trong Shop (cột profit_label của IapCatalog.csv): thang KC = % thưởng so với base; gói khác = ×base ×100, trần hiển thị 1000%; Gỡ QC/VIP/Trang Phục không hiện nhãn.

Quy tắc thang: (1) % thưởng thang KC tăng nghiêm ngặt theo giá; (2) Thẻ Tháng cho nhiều KC/$ hơn Thẻ Tuần (gói lời hơn luôn là gói dài hơn); (3) gói tình huống luôn dưới Thẻ Tháng ở cùng giá trị/ngày để người chơi định kỳ không bị thiệt; (4) Pass Premium < 25× (A10: Pass không thay thế banner — chỉ 10 mảnh L nổi bật/mùa).

3.3 Chi tiết từng họ gói

Thang Kim Cương (gem_*, Shop › Kim Cương). Lần mua đầu mỗi tier ×2 KC (một lần/tier/tài khoản, cờ firstBuyDone[sku]). Bên dưới thang là Túi Vàng mua bằng KC (08 quyết định số lượng/giá). Nút "+" KC ở Home mở thẳng tab này.

Gói Khởi Đầu (starter_pack, $0.99, 1 lần/tài khoản). Móc câu: Rook — anh hùng E quyền sư, phong cách khác hẳn Kaito/Aldric, mở khóa ★1 ngay (đã có Rook từ Triệu Hồi → 20 mảnh Rook). Icon cạnh phải Home xuất hiện ngay khi run 1 kết thúc (run 1 luôn gục ở B13–15 theo FTUE 00 §7.1) hoặc cấp tài khoản 3; popup tự động chỉ từ run 3 (A11); hạn 72 giờ kể từ lúc icon xuất hiện; chưa mua → quay lại đúng 1 lần sau 7 ngày (72 giờ). Màn mua cho xem trước Rook bằng hoạt ảnh Thạch Vũ Quyền (act pixelfx, 02) — người chơi thấy phong cách trước khi mua. Giá trị ~42× nằm ngoài dải chuyển đổi 4–20×, chấp nhận: nhiệm vụ của gói là giao dịch đầu, không phải doanh thu; móc câu là một anh hùng E định giá theo EV Triệu Hồi nên không nội dung giữ được móc câu nào lọt dưới 20× ở $0.99; doanh thu rủi ro ≤ $0.99/người.

Quà Nạp Đầu (first_purchase, miễn phí). Tặng ngay sau giao dịch tiền thật đầu tiên (mọi SKU, kể cả $0.99): Lyra (20 mảnh — mở sớm phong cách giáo dài/trên không thay vì chờ B40) + 200 KC + 3 Ấn + 5 Chìa Di Vật. Mốc B40 vẫn trao 20 mảnh Lyra (đã có → ★2). Banner thường trực ở Shop › Ưu Đãi + rail tới khi nhận. Hai gói ($0.99 Khởi Đầu → Quà Nạp Đầu) là bậc thang D0 → D1 có chủ đích: một giao dịch, hai anh hùng mới.

Thẻ Tuần / Thẻ Tháng (weekly_card, monthly_card). KC nhận mỗi ngày ở lần mở game đầu ngày (popup nhận, hoặc Hộp thư nếu đang Auto-Rerun); ngày lỡ không cộng dồn. Mua lại khi đang hiệu lực → cộng thêm số ngày (gia hạn chồng). Thẻ Tháng đem +58% KC/ngày so với F2P không xem quảng cáo (A09 — 10 §15) và 4 đặc quyền tiện ích; x3 chỉ rút thời gian thực (INV-13); +1 Đổi thẻ/run theo 06 §5; trần Lửa Trại +4 giờ (07); Auto-Rerun dừng sau 10 run không chạm thay vì 5 (A07, 05 §12). Lượt x3 thử miễn phí 1 run/ngày (kỷ lục ≥ 20, ngày cài ≥ 1, Remote Config speed_x3_trial_*) cho người chưa có thẻ — Kết Quả của lượt đó hiện chip x3 khóa ở RunPrep mở thẳng gói.

Lantern Pass / Lantern Pass+ (lantern_pass $6.99, lantern_pass_plus $14.99). Track 50 cấp, mùa 28 ngày — đặc tả ở 10 §6. Premium mua bất kỳ ngày nào và nhận hồi tố mọi cấp đã đạt; Premium+ chỉ bán ngày 1–7 của mùa cho người chưa Premium mùa đó (nhảy 15 cấp có giá trị thật khi còn cả mùa phía trước). Mảnh L nổi bật trên Premium: 10/mùa (cấp 25, 50) — trần A10; tổng mảnh L nổi bật ngoài Triệu Hồi ≤ 30/mùa/người (10 §6).

Quỹ Xuống Vực (growth_fund, $9.99, non-consumable). Mua một lần, nhận KC ở mỗi mốc kỷ lục B10…B100 và 30 mảnh Sable (B40/B70/B100 — đủ mở khóa ở B100, sớm hơn đường thành tựu). Mua muộn → nhận hồi tố mọi mốc đã đạt. Icon rail từ kỷ lục B10 + ngày cài ≥ 1. Khôi phục trên máy mới trả lại trạng thái "đã mua" (các mốc đã nhận không trả lại lần hai — cờ nhận lưu theo tài khoản store khi có cloud save v1.2; trước đó theo máy).

Gói Mốc Độ Sâu (depth_pack_1..4, "tường Boss"; DepthPacks.csv: B20 → I, B30 → II, B40/50/60 → III, B70/80/90/100 → IV). Kích hoạt khi hạ lần đầu Boss mốc hoặc thua 2 run ở cùng Boss mốc (depth_pack_defeat_count; không tính "Bỏ cuộc" < 60 s; chỉ đếm khi gói đang bán). B10 không có gói (run 1 hạ B10 ở ngày 0, nhận Aldric). Hiện ở Home sau Kết Quả, 1 lần/Boss (A12), cửa sổ 48 giờ. Mốc vượt khi gói chưa mở bán → bù 1 lần 72 giờ cho mốc cao nhất khi gói mở bán (depth_pack_catchup_hours). Nội dung giúp vượt bức tường kế tiếp bằng sao (Mảnh Vạn Năng chỉ nâng sao anh hùng đã có), không bán sức mạnh trong run.

Heo Đất (piggy_1..3). +2 KC mỗi tầng clear (trừ Thử Thách Ngày); icon từ 300 KC; đầy trần thì ngừng tích. Đập heo = mua, nhận toàn bộ KC đang có. Tier kế mở theo requires_sku + ngày cài; trước đó heo bán tiếp tier hiện tại.

Tiếp Tế KC (gem_refill_s/m). Khi một giao dịch KC ngoài run thất bại: popup trong ngữ cảnh đề nghị gói nhỏ nhất đủ bù (thiếu < 500 → S, ≥ 500 → M), 1 lần/ngày/gói. Thiếu KC trong run (hồi sinh/Đổi thẻ) → chỉ hiện nút quảng cáo (nếu còn lượt) và ghi nhận gem_shortfall_run để popup ở lần về Home kế (INV-08).

Gói Cuối Tuần (weekend_pack). T7 00:00 → CN 23:59 giờ đã xác thực, 1 lần/tuần, ngày cài ≥ 3. Popup tự động tối đa 1 lần mỗi cuối tuần (ưu tiên 4).

Gói anh hùng — mảnh xác định (không ngẫu nhiên), đường trả tiền hợp lệ ở mọi quốc gia (§10). hero_pack_featured trao mảnh cho anh hùng L nổi bật đang chọn (§4.6); 2 gói = 30 mảnh = mở khóa. hero_pack_select: chọn anh hùng R/E đã sở hữu lúc mua (danh sách sắp theo anh hùng chơi nhiều nhất).

Gói Sự Kiện (event_pass, $2.99). Nhánh Cao Cấp của sự kiện điểm hiện tại (10 §7.3) — chỉ hiện khi đã đạt mốc miễn phí 2 và chưa Cao Cấp (rule event_pass_eligible, Remote Config event_pass_enabled); 1/cửa sổ 14 ngày; mua qua lúc đổi sự kiện → Hộp thư 400 KC.

Trang Phục (non-consumable, Sảnh Anh Hùng › Trang Phục). Chỉ đổi phụ kiện + ramp phụ + màu VFX (INV-04); mỗi Trang Phục sở hữu +1% ATK tài khoản (trần +10%, 00 §10). Chỉ bán cho anh hùng đã sở hữu. KC kèm không khôi phục. Trang Phục còn đến từ Pass (mùa), sự kiện, lễ hội, Thông Thạo (07 §6).

Gỡ Quảng Cáo / VIP Không Quảng Cáo (remove_ads $4.99, vip_adfree $9.99). Gỡ QC tắt mọi quảng cáo xen kẽ vĩnh viễn (+300 KC cảm ơn). VIP gồm Gỡ QC + mọi vị trí quảng cáo thưởng nhận ngay không cần xem (vẫn tính trần từng vị trí và trần ngày, INV-08 giữ nguyên) + khung hồ sơ VIP; người đã có Gỡ QC mua VIP → +500 KC bù. Gợi ý Gỡ QC chỉ sau quảng cáo xen kẽ thứ 3 trong ngày (§6.3 luật 7). Cả hai ngoài dải tiện ích, chấp nhận: thứ được bán là thời gian (hết quảng cáo), định giá 0 có chủ đích vì không có đường KC tương đương; VIP giữ mọi trần nên không cho tài nguyên vượt người F2P chịu xem; $9.99 = trung vị sản phẩm ad-skip thị trường.

4Triệu Hồi Anh Hùng (gacha mảnh anh hùng)

Mở ở lần về Home sau khi Sảnh Anh Hùng được phát (FTUE bước 13, 00 §7.1): hướng dẫn mở 1 lượt bằng Ấn Triệu Hồi tặng kèm Aldric, theo đúng tỉ lệ công bố (không lượt mở kịch bản). Cờ summonTutorialDone.

4.1 Banner

4.2 Kết quả mỗi lượt & tỉ lệ

Mỗi lượt cho một kết quả. Thẻ Anh Hùng = gói mảnh bằng đúng số mảnh mở khóa của độ hiếm (R 10 · E 20 · L 30 — 03 §5.2): chưa sở hữu → mở khóa ★1 ngay; đã sở hữu → cộng mảnh. Anh hùng trong một độ hiếm được chọn đều nhau trong pool banner (banner Nổi Bật áp §4.3). "Mảnh ×N (ngẫu nhiên)" chọn 1 anh hùng đã phát hành của độ hiếm đó (đều nhau, kể cả chưa sở hữu — mảnh tích lũy tới khi đủ mở khóa). Vàng tính theo Gold(kỷ lục) = Vàng 1 tầng ở độ sâu kỷ lục (08).

"Tỉ lệ tổng hợp" = tần suất dài hạn đã tính bảo hiểm, tính chính xác bằng chuỗi Markov hai bộ đếm (consolidated() trong monetization.py), và được công bố song song với tỉ lệ gốc.

4.3 Bảo hiểm (pity) & 50/50

Thuật toán một lượt (mỗi banner có bộ đếm riêng, lưu bền, chuyển sang mùa sau):

roll = WeightedPick(rates)                          # RNG mật mã (không seed theo run)
if pityLegend == 59:            roll = max(roll, LCARD)      # lượt thứ 60
elif pityEpic == 9:             roll = max(roll, ECARD)      # lượt thứ 10 (L vẫn có thể ra)
pityEpic   = 0 if roll >= ECARD else pityEpic + 1
pityLegend = 0 if roll == LCARD else pityLegend + 1
if roll == LCARD and banner == FEATURED:
    hero = featuredL if (guaranteed or Rand() < 0.5) else RandomOther(L pool)
    guaranteed = (hero != featuredL)
elif roll in (ECARD, E5) and banner == FEATURED and featuredE:
    hero = featuredE if Rand() < 0.5 else RandomOther(E pool)
Save(result, counters) → rồi mới phát hoạt ảnh       # thoát app giữa chừng không đổi kết quả

• ×10 = 10 lượt đơn liên tiếp theo đúng luật trên (bảo hiểm ≥ E tự đảm bảo ≥ 1 Thẻ E/L mỗi ×10 nếu bộ đếm bắt đầu từ 0).
• Lượt miễn phí/quảng cáo tính vào bộ đếm của banner Thường.
• Đổi Tiêu Điểm (§4.6) không reset bộ đếm hay cờ bảo đảm: cờ áp cho anh hùng L đang chọn lúc ra Thẻ L.
• Màn banner luôn hiện "Còn N lượt tới Thẻ Huyền Thoại bảo đảm" và trạng thái 50/50 ("Lượt L kế: chắc chắn <tên>").

4.4 Trùng lặp → mảnh → sao → Mảnh Vạn Năng

1. Thẻ/mảnh của anh hùng chưa sở hữu: mảnh vào kho của anh hùng đó; đủ mảnh mở khóa (R 10/E 20/L 30) → mở ★1 tự động, hoạt ảnh "Anh hùng mới".
2. Anh hùng đã sở hữu, < ★6: mảnh vào kho; nâng sao bằng tay ở Sảnh Anh Hùng (03 §5.2, có badge khi đủ).
3. Anh hùng ★6: mảnh tự đổi 5 : 1 thành Mảnh Vạn Năng cùng độ hiếm (720/721/722); phần dư < 5 giữ lại chờ đủ (03 §5.2). Mảnh Vạn Năng chỉ dùng nâng sao anh hùng cùng độ hiếm đã sở hữu, không mở khóa.
4. Kết quả hiển thị rõ đường đi: "+20 mảnh Vex (★3 → còn 12 tới ★4)" hoặc "+4 Mảnh Vạn Năng Sử Thi (Vex ★6)".

4.5 Giá, lượt miễn phí, ×10

Ấn Triệu Hồi lưu thành hai bộ đếm theo nguồn: sigilFree (đăng nhập, nhiệm vụ, Pass miễn phí, sự kiện, thành tựu, mã quà) và sigilPaid (IAP, Thẻ, Pass/Gói Sự Kiện Cao Cấp, mua bằng KC). UI hiện tổng; tiêu sigilFree trước. Tách nguồn là bắt buộc cho §10.

4.6 Xoay vòng nổi bật & Tiêu Điểm

• L nổi bật mặc định: Mora mùa lẻ, Sable mùa chẵn (khóa).
• E nổi bật: một anh hùng E mỗi mùa (50% kết quả E ở banner Nổi Bật, không có bảo đảm).
• Tiêu Điểm (chọn L nổi bật): từ S2, mọi mùa có anh hùng L mới (Zerran S2, Isolde S5, Vulkar S14) hoặc tái xuất, người chơi được đổi L nổi bật giữa anh hùng mặc định và anh hùng L được liệt kê; mặc định = anh hùng ra mắt. Đổi tối đa 1 lần/24 giờ; hero_pack_featured và mảnh nổi bật của Pass/sự kiện trao cho anh hùng đang chọn tại lúc nhận.
• Hàng có anh hùng chưa có trong bản build (cập nhật chưa tới) bị bỏ qua: không E nổi bật / không Tiêu Điểm. Remote Config featured_l_override chỉ dùng khẩn cấp.

4.7 Trình bày

• Shop › Triệu Hồi: carousel 2 banner (Nổi Bật trước), nút ×1/×10 ở 45% dưới, nút "Tỉ lệ" (SummonRateInfo: bảng §4.2 + bộ đếm hiện tại + pool từng độ hiếm), nút "Tiêu Điểm" khi có.
• Hoạt ảnh: một Đèn Hồn rơi theo trục cầu thang xoắn, vỡ thành thẻ; thẻ lật theo màu độ hiếm (ramp 06 §3: R water, E arcane, L gold), L có tia sáng vàng trước khi lật (≤ 0.6 s, không lừa: ánh vàng chỉ khi là L). Anh hùng mới → màn trình diễn 2.5 s bằng act intro + đòn chữ ký của anh hùng (02), chạm để bỏ qua từ 0.5 s. ×10: lưới 5×2, nút "Bỏ qua tất cả" → bảng tổng hợp.
• Tốc độ hoạt ảnh không ảnh hưởng kết quả (đã lưu trước khi phát).

4.8 Nhịp Triệu Hồi theo phân khúc DERIVED

5Rương Di Vật

Di Vật là phụ kiện 4 ô (Bùa/Nhẫn/Phù/Ấn), 24 mẫu, 6 độ hiếm, 6 bộ (07). Mỗi lượt = 1 Di Vật: mẫu chọn đều trong 24 mẫu, độ hiếm theo bảng dưới. Di Vật trùng mẫu + độ hiếm → xử lý theo 07 (nguyên liệu nâng cấp / Bụi Di Vật 14).

Bảo hiểm: ≥ Hiếm mỗi 10 lượt; ≥ Huyền Thoại ở lượt 100 (đếm reset khi ra ≥ Huyền Thoại); Thần Thoại không có bảo hiểm. Thuật toán và lưu trữ như §4.3 (bộ đếm relic.pityR, relic.pityL; Chìa tách relicKeyFree/relicKeyPaid).

Tên 6 độ hiếm Di Vật (Thường/Tốt/Hiếm/Sử Thi/Huyền Thoại/Thần Thoại, mã C/U/R/E/L/M) dùng chung với 07; nếu 07 đổi tên, chỉ đổi cột tên ở RELIC_TABLE.

6Quảng cáo

Mediation: Unity LevelPlay qua com.blackface.ads (UMP consent, ATT trên iOS). Không banner (dải chiến đấu dọc cần trọn màn hình). Mất mạng/không fill → nút quảng cáo xám "Không có quảng cáo" (00 G4), không trừ lượt.

6.1 Quảng cáo thưởng

• Trần tổng 25 quảng cáo thưởng/ngày (ads_rewarded_daily_cap) cộng mọi vị trí; vị trí trong run (hồi sinh, Đổi thẻ, Phước Lành) vẫn hiện khi chạm trần tổng để không phá INV-08 nhưng không vượt trần riêng 1/run.
• Thưởng chỉ trao khi xem hết (callback rewarded); hủy giữa chừng → không thưởng, không trừ lượt.
• VIP: mọi vị trí nhận ngay (nút ghi "Nhận ngay — VIP"), vẫn trừ lượt và trần.
• Phước Lành chỉ ở lượt chọn tầng Boss (x0), 1/run, cộng thẻ thứ 4 theo 06 §4.2 ô D; không cộng với E10 thành 5 thẻ (đã có 4 thẻ → nút ẩn).

6.2 DailyAds (mốc quảng cáo trong ngày)

Đếm mọi quảng cáo thưởng đã xem hết trong ngày (template DailyAds):

6.3 Quảng cáo xen kẽ (interstitial)

1. Chỉ 2 điểm nghỉ: (a) nút Tiếp ở màn Kết Quả khi run kéo dài ≥ 180 s thực và không vừa lập kỷ lục (ads_interstitial_skip_new_record); (b) rời tầng Boss (x0) sau khi đã chọn Hồi Âm, lúc anh hùng bắt đầu đi xuống (placement boss_break, ads_interstitial_boss_enabled) — INV-10
2. Khoảng cách tối thiểu 180 s kể từ quảng cáo gần nhất (xen kẽ hoặc thưởng); điểm boss_break 300 s
3. Không hiện ở ngày cài D0–D1 (ads_interstitial_min_install_day = 2), trước cấp tài khoản 6 và trước run thứ 3
4. Trần 8/ngày, hai điểm nghỉ tính chung; lần bị bỏ qua không tính trần và không đặt lại đồng hồ
5. Không hiện khi Auto-Rerun đang chạy mà người chơi không chạm màn hình trong 60 s gần nhất; ở boss_break cần Auto-Pick tắt và có lần chạm trong 30 s gần nhất (không quảng cáo cho máy để tự chạy)
6. Không bao giờ trong trận, màn chọn thẻ, Chiếu Nghỉ, màn Gục; không với người sở hữu Gỡ Quảng Cáo/VIP; không trong 7 ngày sau giao dịch ≥ $4.99. Ở boss_break mô phỏng tạm dừng trong lúc quảng cáo chạy (INV-14)
7. Sau quảng cáo xen kẽ thứ 3 trong ngày → lần về Home kế gợi ý Gỡ Quảng Cáo (tối đa 1/ngày)

Lý do hai điểm nghỉ: run dài 8–40 phút, một quảng cáo ở Kết Quả là quá ít, nhưng quảng cáo mỗi vài tầng phá nhịp và chạy cả khi máy tự chơi. Boss (mỗi 10 tầng, ~5–8 phút) là nhịp nghỉ tự nhiên; quảng cáo đặt sau khi đã chọn Hồi Âm, lúc anh hùng bắt đầu đi xuống — không bao giờ ở màn chọn thẻ (INV-10). Placement LevelPlay: results_continue, boss_break. Mọi số ở InterstitialRules.csv và Remote Config ads_interstitial_* (10 §13): chỉnh không cần build.

7Cửa hàng

7.1 Bố cục tab

Trang Phục bán ở Sảnh Anh Hùng (tab Trang Phục của từng anh hùng), không ở Shop. Rail cạnh phải Home: tối đa 4 icon gói có đồng hồ (ưu tiên theo §8), còn lại gom vào icon "Ưu Đãi".

7.2 Không có điểm mua trong run

Trong state Run không có nút mua IAP, không popup ưu đãi, không mở Shop (INV-08). Thiếu KC trong run chỉ hiện quảng cáo (nếu còn) — xem §3.3 Tiếp Tế.

7.3 Ưu Đãi Ngày (DailyShop)

Làm mới 00:00 giờ đã xác thực. Hai món mua bằng KC ra Ấn/Chìa bị ẩn ở quốc gia trong paid_gacha_disabled_countries (§10).

8Luật kích hoạt ưu đãi (OfferDirector)

Luật chung:

1. Popup tự động chỉ ở Home, tối đa offer_popup_max_per_session = 1 mỗi lần về Home, không trước run 3 (offer_popup_min_runs). Lần về Home có phát tính năng mới hoặc quà FTUE (00 §8) → không popup ưu đãi.
2. Nhiều trigger cùng đủ điều kiện → ưu tiên số nhỏ: Gợi ý Gỡ QC (0) > Mốc Độ Sâu (1) > Khởi Đầu (2) > Thiếu KC trong run (3) > Cuối Tuần (4) > Quay lại (5). Trigger thua vẫn giữ icon rail (nếu có cửa sổ) và được xét lại ở lần về Home sau.
3. Chống "ép mua lúc bực": gói tường Boss không hiện nếu run vừa kết thúc bằng "Bỏ cuộc" < 60 s; không hiện trên màn Gục/Kết Quả; mỗi Boss tối đa 1 lần (dù kích hoạt bởi hạ hay thua).
4. Mọi đồng hồ là thật (TimeManager, giờ đã xác thực); hết hạn là hết, không "gia hạn bất ngờ".
5. Cửa sổ trigger của SKU chưa mở bán (luật cột) không bắt đầu; ngoại lệ duy nhất là bù 72 giờ của Mốc Độ Sâu (§3.3).
6. Mỗi lần hiện/đóng/mua ghi analytics offer_show / offer_dismiss / iap_purchase với trigger_id (§13).

9Phễu & bao phủ D0–D30

Giỏ phân khúc 30 ngày (đầu vào mô phỏng 08 §6): Dolphin ≈ $31 = Khởi Đầu $0.99 + Thẻ Tháng $4.99 + Lantern Pass $6.99 + Quỹ $9.99 + Mốc Độ Sâu I $2.99 + II $4.99. Whale ≈ $310 = Dolphin + Pass+ $14.99 + 2 × Gói Anh Hùng Nổi Bật $39.98 + Mốc Độ Sâu III/IV $29.98 + ~$190 KC vào banner Nổi Bật. Minnow ≈ $6 = Khởi Đầu + Thẻ Tuần ×1 + Thẻ Tháng.

10Tuân thủ & sự cố

11Áp lực whale & công bằng

12KPI BENCHMARK idle roguelite / hero collector mobile

13Triển khai

13.1 Tái dùng feature template

13.2 Dữ liệu người chơi (PlayerDataManager.Monetization)

13.3 Analytics

iap_offer_show{sku, trigger_id}, iap_purchase{sku, usd, local_price, currency, trigger_id, payer_tier}, iap_restore, iap_refund_detected, summon_pull{banner, count, results[], pity_epic_hit, pity_legend_hit, featured_won, currency}, relic_open{count, rarities[], pity_hit}, ad_rewarded{placement, result}, ad_interstitial{placement, shown | skip_reason}, paid_gacha_blocked{country_source}, offer_dismiss{trigger_id}, currency_spend{currency, sink, amount} (13 §9 sở hữu schema chung).

14Edge cases

15QA

• [ ] Mọi SKU trong IapCatalog.csv có trong IAP catalog Unity + Play Console + App Store Connect; product id đúng com.blackface.deepstair.<sku>; loại consumable/non-consumable khớp §3.1.
• [ ] Không có điểm mua IAP hay popup ưu đãi nào trong state Run (test UI tự động duyệt mọi màn trong run).
• [ ] Giá trị/giá mọi gói nằm trong dải hoặc có lý do (validator monetization.py); thang KC tăng nghiêm ngặt.
• [ ] Triệu Hồi: 1,000,000 lượt mô phỏng khớp tỉ lệ tổng hợp ±0.05 điểm %; bảo hiểm 10/60 đúng biên; 50/50 + bảo đảm đúng; bộ đếm chuyển mùa; Tiêu Điểm không reset bộ đếm.
• [ ] Rương Di Vật: bảo hiểm 10/100 đúng; tỉ lệ tổng hợp khớp.
• [ ] Kill app giữa ×10 → kết quả không đổi.
• [ ] Quảng cáo xen kẽ tuân thủ 7 luật §6.3 (unit test InterstitialPolicy với đồng hồ giả: D0–D1, run < 180 s, kỷ lục mới, Auto-Rerun không chạm, sau IAP ≥ $4.99, trần 8, khoảng cách 180/300 s).
• [ ] Trần quảng cáo thưởng 25/ngày và trần từng vị trí; INV-08 (hồi sinh ≤ 1 QC + 1 KC, Đổi thẻ 1 QC + ≤ 3 KC, Phước Lành 1/run).
• [ ] Gói Khởi Đầu: icon sau run 1, popup chỉ từ run 3, 72 giờ, quay lại 1 lần sau 7 ngày.
• [ ] Gói Mốc Độ Sâu: kích hoạt khi hạ lần đầu hoặc sau đúng 2 lần thua cùng Boss; chỉ ở Home sau Kết Quả; 1/Boss; bù 72 giờ 1 lần; không có ở B10.
• [ ] paid_gacha_disabled_countries: với locale BE/BR — không mở bằng KC, Ấn/Chìa trả phí quy đổi KC ở lúc nhận và ở màn xem trước, DD5/DD6 ẩn, gói mảnh xác định vẫn bán.
• [ ] Khôi phục trả lại Gỡ QC/VIP/Quỹ/Trang Phục trên thiết bị mới, không trả lại KC kèm.
• [ ] Giá VN hiển thị đúng bảng §2.3 khi store chưa trả giá local.

HANDOFF — giả định module khác phải giữ

• 08 Economy: thu nhập KC F2P ổn định ≈ 225/ngày (không xem QC) / ≈ 320/ngày (xem QC); Ấn Triệu Hồi ≈ 0.74/ngày + 2 lượt Triệu Hồi miễn phí/QC mỗi ngày (bảng 10 §15). Định giá Vàng 0.04 KC và Quyển Chiến 6 KC là [ASSUMED] — 08 chốt giá Túi Vàng thì sửa VAL trong monetization.py. Tỉ lệ Triệu Hồi §4.2 (Thẻ L tổng hợp 2.33%, ≥ E 13.67%) là đầu vào mô phỏng sao anh hùng. Gold(kỷ lục) = GOLD_FLOOR(max(10, kỷ lục)).
• 07 Meta: Di Vật 6 độ hiếm mã C/U/R/E/L/M; Trang Phục IAP dùng id SK<CODE>2 (SKKAI2, SKALD2, SKVEX2, SKBRN2, SKMOR2, SKSAB2); nhóm Trang Phục pass và festival cho 10; trần Lửa Trại +4 giờ cho Thẻ Tháng; cấp tài khoản 3 (icon Khởi Đầu) và 6 (quảng cáo xen kẽ).
• 05 Descent: Auto-Rerun dừng sau 5 run không chạm (Thẻ Tháng 10); hồi sinh QC/KC 1 + 1/run; điểm nghỉ boss_break sau khi chọn thẻ ở tầng x0; Thử Thách Ngày nhận thêm 1 lượt QC.
• 03 Heroes: Quà Nạp Đầu là nguồn mở Lyra thứ hai (bảng 03 §6 nên thêm); roster sau ra mắt H09–H21 (mỗi mùa 1, S2–S14) theo 03 §9; độ hiếm khóa ở HERO_RARITY (monetization.py) = 03 §9.
• 11 UI: màn SummonRateInfo, nút Tiêu Điểm, rail ≤ 4 icon, nút quảng cáo xám khi không fill, cài đặt Khôi phục + Giới hạn chi tiêu.