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

การเรียกใช้ 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 จะปล่อยให้ API ตำแหน่งโฆษณาเป็นผู้กำหนด preloadAdBreaks ตั้งค่าได้เพียงครั้งเดียวด้วย adConfig() และค่าเพิ่มเติมที่ส่งไปยัง preloadAdBreaks จะไม่มีผล
การตั้งค่า preloadAdBreaks หลังจากการเรียกใช้ adBreak() ครั้งแรกจะไม่มีผล
onReady สตริง (ไม่บังคับ) เรียกใช้เมื่อ API เริ่มต้นและโหลดโฆษณาล่วงหน้าเสร็จแล้ว (หากคุณขอโหลดล่วงหน้าโดยใช้ preloadAdBreaks ด้านบน)