Quảng cáo video

Module này triển khai quảng cáo video dạng interstitial và rewarded. Đọc phần liên quan đến game engine của bạn trên trang JOGOS_SDK Giới thiệu và sử dụng các tính năng quảng cáo video như sau:

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 game của bạn không tuân thủ các yêu cầu này, game sẽ bị từ chối mà không có phản hồi.

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: interstitial (midgame) và rewarded (rewarded);

• Quảng cáo interstitial: Có thể kích hoạt khi người chơi chết, hoàn thành màn chơi...
• Quảng cáo rewarded: Người dùng chủ động xem để nhận thưởng (mạng sống thêm, hồi sinh nhân vật, vật phẩm bổ sung...)

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

// Yêu cầu hiển thị quảng cáo interstitial
window.JOGOS_SDK.ad.requestAd('midgame', callbacks);
// Yêu cầu hiển thị quảng cáo rewarded
window.JOGOS_SDK.ad.requestAd('rewarded', callbacks);

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

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

• Quảng cáo rewarded có giới hạn tối đa mỗi ngày (thường 30 lần/ngày/user). Vượt quá sẽ gây lỗi: 500 You can only watch up to ${max} rewarded ads per day.

• Khuyến nghị thiết kế thời gian chờ hoặc giới hạn số lần hiển thị cho quảng cáo rewarded. Có thể sử dụng API sau để kiểm tra số lần còn lại:

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

Phát hiện chặn quảng cáo

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

Game có thể chạy khi bị chặn quảng cáo nhưng cơ chế phát hiện có thể nhầm. Để tránh ảnh hưởng người dùng bình thường, nên áp dụng biện pháp hạn chế nhẹ: chỉ giới hạn nội dung trả phí (skin đặc biệt, màn chơi thêm...) với người dùng chặn quảng cáo và đảm bảo tính năng sẽ phục hồi khi tắt chặn quảng cáo. Cần hoàn thiện tính năng tự động lưu để tránh mất tiến trình khi refresh trang.

Sử dụng phương pháp sau để phát hiện chặn quảng cáo: :::

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