Soạn nhiệm vụ — phía người vận hành

Trang này đi hết một vòng: từ Campaign trắng tới nhiệm vụ đang chạy thật, rồi tới lúc phải dừng khẩn.

Trước khi bắt đầu, chắc chắn bạn đang ở đúng làn — xem trang Reward — trang này nói về cái nào.

Thứ tự bắt buộc

Sáu việc dưới đây không đảo được. Mỗi việc là điều kiện của việc sau:

⚠️ Bảng này bắt đầu từ lúc bạn đã có sân. Bên dưới nó còn hai thứ nền — mệnh giá điểm và pháp nhân phát hành — do nền tảng khai trước khi bàn giao; xem trang Reward là gì. Thiếu chúng thì năm bước trên vẫn làm được hết, và hỏng ở tận lúc người chơi bấm nút.

🔴 Bước 3 và 4 tách nhau, và đây là chỗ ai cũng vấp lần đầu. Form tạo nhiệm vụ không có ô Điều khoản — tạo xong, bấm vào nhiệm vụ đó mở form sửa, ô Điều khoản mới xuất hiện ở đấy.

Lý do: điều khoản gắn vào một nhiệm vụ cụ thể, mà lúc đang điền form tạo thì nhiệm vụ chưa tồn tại nên chưa có gì để gắn vào.

Người mới hay làm ngược — tạo nhiệm vụ trước Điều khoản, rồi tới bước 4 mở ra thì danh sách chọn rỗng.

1. Bật năng lực Thưởng

Năng lực chọn ở form tạo Campaign, ô Loại chiến dịch. Tích Thưởng.

Ba lựa chọn ở ô Loại chiến dịch, và chúng tích được nhiều cái cùng lúc. Ở đây Nội dung và Thưởng cùng bật — một chiến dịch vừa nhận bài vừa chạy nhiệm vụ.

Không thấy ô Thưởng? Đơn vị của bạn chưa được mở cụm này. Đây là chuyện cấp phép, không phải cấu hình — liên hệ người quản trị nền tảng.

2. Tạo Điều khoản trước nhiệm vụ

Mở Campaign → tab Điều khoản.

Điều khoản trả lời đúng một câu: một lượt đạt đáng bao nhiêu điểm. Nó tách khỏi nhiệm vụ vì số điểm là cam kết kinh tế với người chơi, còn nhiệm vụ chỉ là mô tả việc phải làm — hai thứ đổi theo nhịp khác nhau.

Điều khoản có phiên bản. Bản đang hiệu lực là bản người chơi được ghim khi họ tham gia, nên sửa hôm nay không đổi số của người đã chơi hôm qua.

Bộ điều khoản Sao cho mỗi lượt điểm danh ở trạng thái Đang áp dụng. Nút Phát hành bản mới là cách đổi giá về sau — bản cũ vẫn giữ cho người đã tham gia.

3. Tạo nhiệm vụ

Mở Campaign → tab Nhiệm vụ → Tạo nhiệm vụ.

Mỗi dòng hiện mã nhiệm vụ và loại kích hoạt. Sao Vàng mùa Thu đang Tạm dừng — nó vẫn nằm trong danh sách, chỉ đổi nút thành Tiếp tục.

Các ô cần hiểu

Ô Điều khoản áp dụng không có ở form này — nó chỉ xuất hiện khi bạn mở lại nhiệm vụ để sửa. Xem bước tiếp theo.

Ô Hiệu lực kinh tế bị khoá và ghi sẵn "Chờ Terms", kèm dòng giải thích ngay dưới. Trong form này không có ô Điều khoản nào cả.

🔴 Mã nhiệm vụ khoá sau khi kích hoạt. Nó là định danh công khai, đã nằm trong liên kết người chơi đã lưu — đổi là làm hỏng những liên kết đó. Chọn mã cẩn thận ở lần đầu.

Bốn loại kích hoạt

Ô Loại kích hoạt hiện đúng bốn giá trị, và hiện bằng tiếng Anh viết hoa.

🔴 Câu hỏi đúng khi chọn loại không phải "người chơi bấm thì sao", mà là "AI làm cho nó nổ". Chỉ một trong bốn loại là do người chơi tự bấm:

⚠️ Ba dòng dưới không phải thiếu sót của giao diện. Hệ thống chặn thẳng ở máy chủ: người chơi gọi thử để tự nhận điểm cho một UI_ACTION hay ORDER_COMPLETED sẽ bị từ chối. Nếu để họ tự khai thì họ tự khai mình đã mua hàng, đã xem banner, đã đủ chuỗi — nên đây là hàng rào an toàn, không phải hạng mục còn nợ.

Đổi Loại kích hoạt là đổi cả bộ ô phải điền. Chọn ORDER_COMPLETED thì mọc thêm Giá trị đơn tối thiểu, Danh mục và Cửa sổ tính điểm — những ô loại CHECKIN không có.

STREAK_REACHED đòi hai quyết định: Mốc chuỗi (mấy ngày liền — từ 2 đến 365) và Chính sách thưởng lặp mốc. ONCE_PER_CAMPAIGN = thưởng một lần cho cả chương trình; PER_STREAK = mỗi lần đạt lại mốc là thưởng tiếp. Ô này không có giá trị mặc định — cố ý, để không ai vô tình chọn hộ bạn.

UI_ACTION chỉ có một ô: Mã hành vi (MSHT) — MSHT là hệ thống bên ngân hàng. Đây là tên mà bạn và bên kỹ thuật ngân hàng phải thống nhất trước. Gõ sai mã thì sự kiện vẫn tới hệ thống nhưng không khớp nhiệm vụ nào — không lỗi, không cảnh báo, chỉ là không ai được điểm.

Muốn mỗi mốc chuỗi một mức thưởng khác nhau — 5 ngày, 10 ngày, 15 ngày — thì tạo mỗi mốc một nhiệm vụ riêng, đừng tìm cách nhét nhiều mốc vào một nhiệm vụ.

Đây là chỗ hay bị hiểu nhầm thành "nút hỏng": khách bấm nhiệm vụ mua hàng, bị đưa sang cửa hàng, quay lại chưa thấy điểm. Đúng như thiết kế — đơn hàng phải được đối tác xác nhận.

4. Gắn Điều khoản cho nhiệm vụ

Bấm vào nhiệm vụ vừa tạo trong danh sách. Form sửa mở ra, và lần này có ô Điều khoản áp dụng.

Ô Điều khoản áp dụng chỉ có ở form sửa, hiện Sao cho mỗi lượt điểm danh — 50 SAOVANG (v1). Ở đây nó xám và không bấm được vì nhiệm vụ đang chạy — muốn đổi thì tạm dừng nhiệm vụ trước.

Chọn bộ điều khoản đã phát hành ở bước 2. Chưa chọn thì nhiệm vụ không kích hoạt được — hệ thống từ chối phát điểm khi chưa ai nói phát bao nhiêu.

✅ Form sửa nay LƯU ĐƯỢC (vá 2026-08-29 — #1088 · #1270). Mở một nhiệm vụ đã có, đổi tiêu đề · mô tả · thứ tự · ngày kết thúc · điều kiện kích hoạt · trần điểm, bấm Lưu — danh sách đổi theo.

Trước bản vá, bấm Lưu thì biểu mẫu từ chối gửi (ban đầu im lặng, về sau hiện một dòng đỏ chung chung), nên nhiệm vụ soạn sai chỉ chữa được bằng cách tạo cái mới — mà mã cũ thì đã bị chiếm vĩnh viễn.

Hai ô KHOÁ khi sửa, và màn hình nói rõ vì sao:

⚠️ Ô Điều khoản áp dụng đi đường ghi riêng, không nằm trong nút Lưu — chọn xong là ăn ngay, và lỗi (vd nhiệm vụ đang chạy) hiện đúng tại chỗ đó.

⚠️ Nhiệm vụ đang chạy thì không đổi Điều khoản được — phải tạm dừng nó trước. Đổi giá giữa lúc đang phát là đổi cam kết với người đang chơi.

5. Đặt ngân sách

Ngân sách đặt trên Campaign, không ở từng nhiệm vụ. Đó là trần chi cho cả chiến dịch.

⚠️ Chỗ đặt đổi theo trạng thái Campaign — nhớ theo trạng thái, đừng nhớ theo vị trí:

Lúc còn nháp mà đi tìm trong tab Cấu hình thì không thấy ô nào — nó ở tab Ngân sách đứng riêng bên cạnh.

Chạm trần, người chơi thấy: "Chương trình tạm hết ngân sách", kèm câu "Nhiệm vụ vẫn mở, chỉ là phần thưởng đã phát hết cho hôm nay." — và lượt của họ vẫn được ghi nhận. Nạp thêm là phần đã ghi nhận được trả tiếp.

Chiến dịch còn Bản nháp: Ngân sách và Cấu hình là hai tab tách rời. Ngân sách có ba tầng — tổng chiến dịch, giới hạn theo nội dung, giới hạn theo creator. Để trống là không giới hạn.

6. Bật nhiệm vụ lên chạy

Nhiệm vụ mới ở trạng thái Nháp. Bấm Kích hoạt để nó chuyển Đang chạy.

Bị chặn ở đây thì đọc câu báo lỗi — nó nói thẳng thiếu gì:

7. Dừng khẩn một nhiệm vụ đang chạy

Đây là thao tác bạn cần lúc gấp: một nhiệm vụ phát điểm sai, phải chặn ngay.

Mở Campaign đang chạy → tab Nhiệm vụ → nhiệm vụ đó → Tạm dừng.

Ảnh chụp sau khi tải lại trang. Điểm danh cuối tuần giữ nguyên Tạm dừng và nút đổi thành Tiếp tục — đó là bằng chứng lệnh dừng đi thẳng vào bảng đang chạy, không chờ xuất bản.

Có hiệu lực ngay, không cần xuất bản gì thêm. Đây là điểm khác biệt quan trọng: sửa giá trị kinh tế thì phải qua phiên bản và chờ xuất bản, nhưng bật hay tắt thì đi thẳng. Lý do là nếu lệnh dừng cũng phải chờ xuất bản, thì trong lúc chờ người chơi vẫn tiếp tục ăn điểm — mà lúc đó bạn đang dừng nó chính vì nó phát sai.

Kiểm chắc chắn bằng cách tải lại trang: trạng thái phải vẫn là Tạm dừng.

⚠️ Nhiệm vụ tạm dừng không biến mất khỏi màn người chơi — họ vẫn thấy nó, ở trạng thái khác. Cố ý: người đang làm dở mà nhiệm vụ bốc hơi thì họ mất dấu công sức.

Tạm dừng quay lại được; Kết thúc thì không. Gặp sự cố thì tạm dừng.

8. Sửa nhiệm vụ đang chạy

Sửa được, nhưng có độ trễ: thay đổi trên nhiệm vụ đang chạy chỉ có hiệu lực từ lần xuất bản chiến dịch kế tiếp, và các lượt phát sinh trước đó vẫn chấm theo bản cũ.

Riêng đổi Điều khoản thì phải tạm dừng nhiệm vụ trước — đổi giá giữa lúc đang phát là đổi cam kết với người đang chơi.

9. Chương trình đang chạy — bạn nhìn lại được gì

Phần này nói thẳng ranh giới, vì đây là chỗ khiến người vận hành mất nhiều thời gian nhất: đi tìm một màn hình chưa được dựng.

Nhìn được

Hai tab: Kênh đối tác (đường dây nào đang mở) và Tra biên nhận (cầm một mã trong tay, tìm nó thuộc lô nào). Ảnh chụp trên đơn vị demo nên bảng đang rỗng — chưa khai kênh đối tác nào. Màn này trả lời một câu: "những gì ngân hàng nói họ đã gửi, mình có nhận đủ không". Nó không nói gì về người chơi hay về quà.

Chưa nhìn được — và đây là bốn chỗ thật sự thiếu

🔴 Nói cho rõ, vì hai dòng đầu hay bị hiểu nhầm thành "tôi chưa tìm ra chỗ": hai màn đó chưa được dựng. Không phải bạn thiếu quyền, không phải nó nằm ở menu khác. Cần số liệu người chơi lúc này thì phải nhờ kỹ thuật truy vấn.

🔴 Dòng cuối là chỗ dễ báo nhầm thành lỗi tính điểm. Người chơi điểm danh 5 ngày liền vẫn nhận đúng phần thưởng mốc chuỗi — thứ sai chỉ là con số hiển thị trên trang chủ của họ. Khách phàn nàn "tôi điểm danh mấy ngày rồi mà vẫn thấy 0" thì kiểm ví của họ trước: điểm thường đã về.

Có một màn tên "Báo cáo thưởng" — nhưng không phải của bạn

Chiến dịch có tab Báo cáo thưởng, và thanh bên có mục cùng tên. Cả hai đều thuộc thưởng-cho-creator, không phải RewardOS — cột của nó là Lượt xem · Tổng thưởng · Đã chi, tính tiền trả cho người đăng bài. Xem lại bảng phân biệt ở trang Reward là gì.

Đường ngân hàng bắn sự kiện sang

Hai loại UI_ACTION và ORDER_COMPLETED sống hay chết là do phía ngân hàng gửi đúng hay không. Phần hợp đồng kỹ thuật đó — cách ký, cách chống trùng, mã lỗi, cách gửi lại — nằm ở tài liệu dành cho đối tác tích hợp, không nằm trong bộ hướng dẫn này.

Việc của bạn ở đây chỉ có một: khai đúng Mã hành vi như đã thống nhất, và báo lại cho bên kỹ thuật khi bạn đổi nó.

"Đã thống nhất" nằm ở đâu: trong hợp đồng tích hợp gửi cho đối tác — cùng bảng mã mà bên kỹ thuật của họ đọc để bắn. Đừng tra bằng trí nhớ và đừng hỏi miệng: chuỗi này so thô, phân biệt hoa thường, nên brand và Brand là hai mã khác nhau.

Không có nó trong tay thì hỏi bên kỹ thuật lấy đúng bảng, rồi chép từng ký tự. Chép sai thì đúng như đoạn trên: sự kiện vẫn tới, không lỗi, không cảnh báo, chỉ là không ai được điểm — và chuyện đó đã xảy ra thật.