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