แบนเนอร์
โมดูลนี้ใช้เพื่อแสดงและลบโฆษณาแบนเนอร์ หลังจากอ่านส่วนที่เกี่ยวข้องกับเครื่องยนต์เกมของคุณในหน้า สาระสำคัญเกี่ยวกับ JOGOS_SDK คุณสามารถใช้ฟังก์ชันสंबंधितตามขั้นตอนต่อไปนี้:
window.JOGOS_SDK.banner;โปรดอ่าน ข้อกำหนดเกี่ยวกับโฆษณา อย่างระมัดระวัง เพราะถ้าเกมของคุณไม่ปฏิบัติตามข้อกำหนดเหล่านี้ เกมของคุณจะถูกปฏิเสธโดยไม่มีการแจ้งกลับใดๆ
แจ้งคำขอแสดงโฆษณาแบนเนอร์
มีขนาดของโฆษณาแบนเนอร์ทั้งหมด 5 ขนาดให้เลือก:
- ภาพรวม (728x90)
- ขนาดกลาง (300x250)
- อุปกรณ์เคลื่อนที่ (320x50)
- หน้าแรก (468x60)
- อุปกรณ์เคลื่อนที่ขนาดใหญ่ (320x100)
- ในเวลาเดียวกันสามารถแสดงได้เพียง 2 โฆษณาแบนเนอร์ที่มีขนาดต่างกันเท่านั้น
- ตำแหน่งโฆษณาแบนเนอร์เดียวกันต้องแสดงเป็นเวลา 60 วินาที ก่อนที่จะสามารถรีเฟรชโฆษณาอีกครั้ง
- หากแบนเนอร์ไม่ปฏิบัติตามกฎและขนาดข้างต้น มีโอกาสสูงว่าจะไม่แสดง
ก่อนอื่น คุณต้องสร้างคอนเทนเนอร์สำหรับโฆษณาแบนเนอร์บนหน้าจอ โดยสามารถระบุความกว้างและความสูงเป็นทางเลือก:
<div id="banner-container" style="width: 300px; height: 250px"></div>จากนั้นใช้เมธอดต่อไปนี้เพื่อแจ้งคำขอแสดงโฆษณาแบนเนอร์ (โปรดทราบว่า id ต้องตรงกับ id ของคอนเทนเนอร์):
try {
await window.JOGOS_SDK.banner.requestBanner('banner-container');
} catch (e) {
console.log('Banner request error', e);
}ไม่สามารถแสดงโฆษณาแบนเนอร์เกินสองโฆษณาในเวลาเดียวกัน มิฉะนั้นจะเกิดข้อยกเว้น: '500 At most two banners can be displayed at the same time'.
การดำเนินการเมธอดนี้ด้วย id เดียวกันจะแทนที่โฆษณาที่มีอยู่ หากดำเนินการซ้ำภายในเวลาที่กำหนด (โดยปกติเป็น 60 วินาที) จะเกิดข้อยกเว้น: 500 The time for each call to method requestBanner cannot exceed ${time} seconds.
ลบแบนเนอร์ที่ระบุ
จากนั้นใช้เมธอดต่อไปนี้เพื่อลบแบนเนอร์ที่มี id เป็นค่าที่ระบุ:
await window.JOGOS_SDK.banner.clearBanner('banner-container');ลบทุกแบนเนอร์
จากนั้นใช้เมธอดต่อไปนี้เพื่อลบทุกแบนเนอร์:
await window.JOGOS_SDK.banner.clearAllBanners();ทดสอบแบบโลคอล
ระหว่างการทดสอบแบบโลคอล โฆษณาที่จริงจะไม่ถูกแสดง เพื่อดูผลลัพธ์การแสดงผลสุดท้าย คุณสามารถบรรจุเกมของคุณและอัปโหลดไปยังเครื่องมือ QA ของแพลตฟอร์มผู้พัฒนาเพื่อดำเนินการทดสอบ