Ad Reward Rules

Đường dẫn: Menu → Nội dung & cấu hình → Ad Reward Rules (/games/{gameId}/ad-reward-rules)

Ai dùng được

Đây là quyền endpoint theo backend/src/admin_portal/core/permissions.py; các thao tác nhạy cảm như PII có kiểm tra step-up riêng. Super Admin vượt ma trận bằng quyền khẩn cấp.

Tài nguyên endpoint	Hành động cần	Vai trò được backend cho phép
ad_reward_rule	READ	Super Admin, Game Owner, Live Ops, Economy Admin, Finance, Analyst, Auditor
ad_reward_rule	WRITE	Super Admin, Live Ops
ad_reward_rule	PUBLISH	Super Admin, Live Ops

Điều kiện hiển thị: Có game đang chọn và quyền AD_REWARD_RULE/READ; publish cần AD_REWARD_RULE/PUBLISH.

Màn hình này dùng để làm gì

Quản lý luật phần thưởng từ quảng cáo.

Gợi ý trong Portal (frontend/src/app/(portal)/games/[gameId]/ad-reward-rules/page.tsx): Luật thưởng cho quảng cáo có thưởng (rewarded video) — số lượng, loại tiền tệ, giới hạn/ngày và thời gian chờ giữa các lần xem. Tìm theo rule_key hoặc lọc theo trạng thái để thu hẹp danh sách. Publish 1 rule mới sẽ tự động thay thế rule đang published cùng rule_key. Thay đổi chỉ áp dụng cho lượt xem quảng cáo mới — không ảnh hưởng phần thưởng đã phát trước đó. Dữ liệu nghiệp vụ được giới hạn theo gameId đang chọn.

Các thao tác thường gặp

1. Tạo hoặc cập nhật luật với provider/ad unit và phần thưởng tương ứng.
2. Publish luật; kiểm tra trạng thái sau publish. Doanh thu ads đến từ provider, không nhập từ client.

Lưu ý an toàn

Rà soát reward và giới hạn trước khi publish; doanh thu quảng cáo là dữ liệu bên ngoài, không nhập thủ công như dữ liệu client.

Chú ý

Trước khi xác nhận thay đổi có thể ảnh hưởng người chơi, kiểm tra đúng game, đối tượng, giá trị và lý do. Không dùng dữ liệu người chơi thật trong ví dụ hoặc ảnh chụp.

Lỗi thường gặp

“Thao tác luật thưởng thất bại” → xem lỗi API/provider, xác minh rule key và quyền publish.

Liên quan

Quy trình thường gặp · Audit Log · Vai trò và quyền

Kiểm tra lần cuối với Portal v1.2.2. Hướng dẫn được đối chiếu mã nguồn; chưa chạy thao tác trên dev stack.