Khuyến mãi
Đường dẫn: Menu → Người chơi & giao dịch → Khuyến mãi (/games/{gameId}/reward-campaigns)
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 |
|---|---|---|
| live_reward | READ | Super Admin, Game Owner, Live Ops, Economy Admin, Support Agent, Finance, Analyst, Auditor |
| live_reward | WRITE | Super Admin, Live Ops, Economy Admin |
| live_reward | PUBLISH | Super Admin, Live Ops, Economy Admin |
Điều kiện hiển thị: Có game đang chọn và quyền LIVE_REWARD/READ; thay đổi/publish cần quyền ghi/publish tương ứng.
Màn hình này dùng để làm gì
Phần tiêu đề “Màn hình này dùng để làm gì”Quản lý chiến dịch khuyến mãi và đối tượng áp dụng. 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
Phần tiêu đề “Các thao tác thường gặp”- Tạo bản nháp và cấu hình thời gian, audience cùng phần thưởng.
- Preview danh sách và nội dung; submit/publish. Kiểm tra trạng thái pending_approval hoặc scheduled sau thao tác.
Duyệt: campaign có thể ở trạng thái pending_approval; người có thẩm quyền khác duyệt theo approval workflow.
Lưu ý an toàn
Phần tiêu đề “Lưu ý an toàn”Kiểm tra khoảng thời gian, điều kiện và phần thưởng; dùng luồng duyệt nếu game bật approval_workflow.
Lỗi thường gặp
Phần tiêu đề “Lỗi thường gặp”“CSV chưa hợp lệ” → cần cột player_uid với UUID; “Không thể xem trước”/“Không thể hoàn tất thao tác” → xem detail API và sửa lỗi từng dòng trước khi thử lại.
Liên quan
Phần tiêu đề “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.
Áp dụng cho Portal v1.2.2