การกําหนดค่าโฆษณา

การเรียก 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 ด้านบน)