วิดีโอโฆษณา
โมดูลนี้ใช้สำหรับโฆษณาวิดีโอแบบแทรกกลางและโฆษณาวิดีโอแบบให้รางวัล อ่านหน้า JOGOS_SDK แนะนำ
และดูส่วนที่เกี่ยวข้องกับเอนจินเกมของคุณ จากนั้นใช้ฟีเจอร์วิดีโอโฆษณาตามคำแนะนำด้านล่าง:
window.JOGOS_SDK.ad;
โปรดอ่าน ข้อกำหนดโฆษณาของเรา อย่างละเอียด เพราะหากเกมของคุณไม่เป็นไปตามข้อกำหนด เกมของคุณจะถูกปฏิเสธโดยไม่มีการแจ้งกลับ
การร้องขอเล่นวิดีโอโฆษณา
เราสนับสนุนโฆษณาวิดีโอสองประเภท: โฆษณาแทรกกลาง (midgame
) และโฆษณาให้รางวัล (rewarded
);
- โฆษณาแทรกกลาง: สามารถแสดงเมื่อผู้เล่นตาย, ผ่านด่าน หรือเหตุการณ์อื่นๆ ตามความเหมาะสม
- โฆษณาให้รางวัล: ผู้เล่นเลือกดูเพื่อแลกกับรางวัล เช่น ชีวิตพิเศษ, การฟื้นคืนตัวละคร, ไอเท็มพิเศษ, หรือคุณสมบัติเพิ่มเติม
// ฟังก์ชัน callback
const callbacks = {
// เรียกใช้เมื่อเริ่มเล่นโฆษณา
onstarted: () => console.log('ad started'),
// เรียกใช้เมื่อเล่นโฆษณาเสร็จ
onfinished: () => console.log('ad finished'),
// เรียกใช้เมื่อเกิดข้อผิดพลาดระหว่างเล่นโฆษณา
onerror: (error) => console.log('ad error:', error),
};
// ร้องขอโฆษณาแทรกกลาง
window.JOGOS_SDK.ad.requestAd('midgame', callbacks);
// ร้องขอโฆษณาให้รางวัล
window.JOGOS_SDK.ad.requestAd('rewarded', callbacks);
ข้อควรระวังในการเรียกใช้โฆษณา
โฆษณาแทรกกลางมีเวลาการรีเฟรชขั้นต่ำ (โดยทั่วไป 60 วินาที) การเรียกใช้บ่อยเกินไปจะเกิดข้อผิดพลาด:
500 At least a ${time} second interval is required to display new advertisements
โฆษณาให้รางวัลมีข้อจำกัดสูงสุดต่อวัน (โดยทั่วไปผู้ใช้แต่ละคนดูได้ 50 ครั้งต่อวัน) การเรียกใช้เกินจะเกิดข้อผิดพลาด:
500 You can only watch up to ${max} rewarded ads per day
แนะนำให้คุณออกแบบจุดโฆษณาให้มีเวลาคูลดาวน์หรือจำกัดจำนวนต่อวัน นอกจากนี้คุณสามารถใช้ API ด้านล่างเพื่อดึงจำนวนโฆษณาให้รางวัลที่เหลือของผู้ใช้เพื่อตัดสินใจว่าจะซ่อนหรือแสดงโฆษณาให้รางวัล
const result = await window.JOGOS_SDK.ad.getRewardAdCount();
console.log('Remaining rewardAd count ', result);
การตรวจสอบการบล็อกโฆษณา
ใช้วิธีดังต่อไปนี้เพื่อตรวจสอบว่าผู้ใช้ใช้ตัวบล็อกโฆษณาหรือไม่:
const result = await window.JOGOS_SDK.ad.hasAdblock();
console.log('Adblock usage fetched', result);