การเรียก adConfig() จะแจ้งการกําหนดค่าปัจจุบันของเกมกับ Ad Placement API Ad Placement API ใช้ในการปรับแต่งวิธีที่โหลดโฆษณาล่วงหน้าและกรองประเภทโฆษณาที่คําขอต้องเหมาะสม (เช่น โฆษณาวิดีโอที่ต้องใช้เสียง)
ลายเซ็นของฟังก์ชัน:
adConfig({
preloadAdBreaks: 'on|auto', // Ad preloading strategy
sound: 'on|off' // This game has sound
onReady: () => {}, // Called when API has initialised and adBreak() is ready
});
พารามิเตอร์ adConfig
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
sound |
สตริง | (ไม่บังคับ) เกมนี้เล่นเสียงอยู่หรือไม่ ค่า: - on (ค่าเริ่มต้น) - off การโทรนี้ระบุว่าเกมมีเสียงไหม และมีการเปิดใช้เสียงหรือไม่ (เช่น เปิดเสียง) ก่อนโทรหา adBreak() วิธีนี้จะช่วยให้ Ad Placement API เลือกประเภทโฆษณาที่เหมาะสมให้กับเกมของคุณเรียกใช้ฟังก์ชันนี้ทันทีที่สถานะเสียงของเกมเปลี่ยนไป เนื่องจาก Ad Placement API อาจต้องขอครีเอทีฟโฆษณาใหม่ ซึ่งจะทําให้ใช้เวลาในการดําเนินการนานที่สุด ค่าเริ่มต้นจะเปิดอยู่ เกมส่วนใหญ่จึงต้องเรียกใช้ adConfig() เมื่อเริ่มประกาศว่าเปิดใช้เสียง |
preloadAdBreaks |
สตริง | (ไม่บังคับ) ระบุว่าควรโหลดโฆษณาก่อนการโทรไปยัง adBreak() ครั้งแรกหรือไม่ ค่า:- on - auto (ค่าเริ่มต้น)ค่าเริ่มต้น auto จะตัดสินใจเลือกขึ้นใน Ad Placement API ตั้งค่า preloadAdBreaks ได้ด้วย adConfig() เพียงครั้งเดียว และค่าเพิ่มเติมที่ส่งไปยัง preloadAdBreaks จะไม่มีผลการตั้งค่า preloadAdBreaks หลังจากการเรียกไปยัง adBreak() ครั้งแรกจะไม่มีผล |
onReady |
สตริง | (ไม่บังคับ) เรียกใช้เมื่อ API เริ่มต้นและโหลดโฆษณาไว้ล่วงหน้าแล้ว (หากคุณขอโหลดล่วงหน้าโดยใช้ preloadAdBreaks ด้านบน) |