Quảng cáo video

Module này triển khai quảng cáo video chèn giữa (interstitial) và quảng cáo video thưởng (rewarded). Đọc trang JOGOS_SDK Giới thiệu và xem phần liên quan đến engine trò chơi của bạn, sau đó sử dụng các tính năng quảng cáo video như hướng dẫn dưới đây:

window.JOGOS_SDK.ad;

Yêu cầu quảng cáo

Vui lòng đọc kỹ yêu cầu quảng cáo của chúng tôi, vì nếu trò chơi của bạn không tuân thủ các yêu cầu này, trò chơi sẽ bị từ chối mà không có phản hồi nào.

Yêu cầu phát quảng cáo video

Chúng tôi hỗ trợ hai loại quảng cáo video: quảng cáo chèn giữa (midgame) và quảng cáo thưởng (rewarded);

• Quảng cáo chèn giữa: có thể hiển thị khi người chơi chết, hoàn thành màn chơi hoặc các sự kiện khác.
• Quảng cáo thưởng: người dùng chủ động xem để nhận phần thưởng (mạng thêm, hồi sinh nhân vật khi chết, vật phẩm thêm, thuộc tính thêm, v.v.).

// Hàm callback
const callbacks = {
  // Gọi khi quảng cáo bắt đầu
  onstarted: () => console.log('ad started'),
  // Gọi khi quảng cáo kết thúc
  onfinished: () => console.log('ad finished'),
  // Gọi khi quảng cáo gặp lỗi
  onerror: (error) => console.log('ad error:', error),
};

// Yêu cầu hiển thị quảng cáo chèn giữa
window.JOGOS_SDK.ad.requestAd('midgame', callbacks);
// Yêu cầu hiển thị quảng cáo thưởng
window.JOGOS_SDK.ad.requestAd('rewarded', callbacks);

Lưu ý khi gọi quảng cáo

• Quảng cáo chèn giữa có thời gian làm mới tối thiểu (thường là 60 giây). Gọi quá thường xuyên sẽ gây lỗi: 500 At least a ${time} second interval is required to display new advertisements.

• Quảng cáo thưởng có giới hạn tối đa mỗi ngày (thường mỗi người dùng xem được 50 lần). Gọi quá nhiều sẽ gây lỗi: 500 You can only watch up to ${max} rewarded ads per day.

• Chúng tôi khuyến nghị bạn thiết kế điểm quảng cáo thưởng với thời gian cooldown hoặc giới hạn số lần mỗi ngày. Bạn cũng có thể sử dụng API dưới đây để lấy số lần quảng cáo thưởng còn lại của người dùng, nhằm quyết định có nên ẩn quảng cáo thưởng hay không.

const result = await window.JOGOS_SDK.ad.getRewardAdCount();
console.log('Remaining rewardAd count ', result);

Kiểm tra chặn quảng cáo

Yêu cầu quảng cáo

Trong thiết kế game của chúng tôi, trò chơi vẫn có thể chạy khi người dùng chặn quảng cáo. Tuy nhiên, cơ chế kiểm tra có thể xảy ra sai lệch. Để tránh ảnh hưởng tới người dùng bình thường, chúng tôi khuyến nghị áp dụng biện pháp hạn chế nhẹ: chỉ giới hạn nội dung giá trị gia tăng (ví dụ skin đặc biệt, màn chơi thêm) cho người dùng chặn quảng cáo, và đảm bảo khi họ tắt chặn quảng cáo chỉ cần refresh trang là có thể dùng đầy đủ chức năng.

Sử dụng các phương pháp dưới đây để kiểm tra người dùng có sử dụng trình chặn quảng cáo hay không:

const result = await window.JOGOS_SDK.ad.hasAdblock();
console.log('Adblock usage fetched', result);