โหมดการทำงานของ SDK
SDK สามารถทำงานในโหมดอย่างน้อย 1 โหมด ขึ้นอยู่กับการตอบกลับโฆษณาที่ได้รับจากโฆษณา เซิร์ฟเวอร์
- โฆษณาเดียว
- โฆษณาที่เล่นได้ทุกเมื่อเมื่อ
start
ส่งข้อความไปยังIMAAdsManager
ไม่มีการเริ่มต้นแบบพิเศษ จำเป็นต้องแสดงเพียงโฆษณาเดียว - พ็อดโฆษณา
- โฆษณาหลายรายการที่เล่นย้อนกลับเมื่อส่งข้อความ
start
ไปยังIMAAdsManager
ไม่จำเป็นต้องมีการเริ่มต้นเป็นพิเศษเพื่อ เล่นพ็อดโฆษณาเดียว - กฎของโฆษณา
- เพลย์ลิสต์ช่วงพักโฆษณาที่กำหนดไว้ในช่วงเวลาที่เฉพาะเจาะจงสำหรับ
เนื้อหา ระบบจะไม่สนใจข้อความ
start
ในโหมดกฎโฆษณา สามารถ เป็นช่วงพักโฆษณาหลายๆ ครั้งที่กำหนดเวลาไว้ภายในเพลย์ลิสต์เดียว (เช่น โฆษณาตอนต้น โฆษณาตอนกลาง โฆษณาตอนท้าย) ดูรายละเอียดการติดตั้งใช้งานเพิ่มเติมได้ที่ ส่วนกฎโฆษณาด้านล่าง
กฎของโฆษณา
IMA tvOS SDK รองรับเพลย์ลิสต์โฆษณาแบบอัตโนมัติทั้งหมด ฟีเจอร์นี้ จะแทรกช่วงพักโฆษณาลงในเนื้อหาตามที่ระบุไว้ใน Google Ad Manager เมื่อดูแลการแสดงโฆษณา และยังทำให้โค้ดโปรแกรมเล่นวิดีโอง่ายขึ้นมาก ที่จำเป็นต่อการรองรับช่วงพักโฆษณา ซึ่งรวมถึงโฆษณาตอนต้น โฆษณาตอนกลาง และโฆษณาตอนท้าย
- เมื่อดูแลการแสดงโฆษณาใน Ad Manager คุณจะระบุกฎโฆษณาที่หลากหลายได้ เช่น "เล่นช่วงพักโฆษณาที่ตอนต้นของเนื้อหาเสมอ" หรือ "เล่นช่วงพักโฆษณา 1 นาที ของเนื้อหาทุก 30 นาที"
- เมื่อมีการขอโฆษณา เซิร์ฟเวอร์โฆษณาสามารถส่งคืนเพลย์ลิสต์โฆษณา SDK ประมวลผลเพลย์ลิสต์และกำหนดเวลาช่วงพักโฆษณา ที่ระบุ
- เมื่อเริ่มต้น
AdsManager
IMAContentPlayhead
มีการส่งผ่านinitializeWithContentPlayhead:adsRenderingSettings:
การโทร หากคุณใช้ AVPlayer เพื่อแสดงเนื้อหาของคุณ คุณจะต้องส่ง ของIMAAVPlayerContentPlayhead
ไปยัง SDK เมื่อคุณสร้างadDisplayContainer
ออบเจ็กต์นี้ใช้เพื่อติดตามความคืบหน้าของการเล่นเนื้อหา ระบบจะแทรกช่วงพักโฆษณาโดยอัตโนมัติตามเวลาที่ระบุไว้ใน Ad Manager
เมื่อใช้ AVPlayer
IMAContentPlayhead *contentPlayhead = [[IMAAVPlayerContentPlayhead alloc] initWithAVPlayer:self.contentAVPlayer]; IMAAdsRequest *request = [[IMAAdsRequest alloc] initWithAdTagUrl:adTagUrl adDisplayContainer:adDisplayContainer contentPlayhead:contentPlayhead userContext:nil];
เมื่อไม่มี AVPlayer
- ใช้อินเทอร์เฟซ
IMAContentPlayhead
- ใช้งาน
currentTime
เพื่อแสดงผลเวลาปัจจุบัน โปรแกรมเล่นวิดีโอ - เปลี่ยนการเรียกการเริ่มต้น
IMAAdsManager
เป็น ใช้initializeWithContentPlayhead:self
- ใช้อินเทอร์เฟซ
- IMAAdsManagerDelegate จะใช้เพื่อหยุดเล่นเนื้อหาชั่วคราวและเล่นต่อเมื่อมีการเล่นช่วงพักโฆษณา
หมายเหตุ: เมื่อเนื้อหาเล่นเสร็จแล้ว หรือ
ผู้ใช้หยุดเล่นแล้ว โปรดโทรติดต่อ contentComplete
ใน IMAAdsLoader
เพื่อส่งสัญญาณไปยัง SDK ว่าเนื้อหา
เล่นเสร็จแล้ว จากนั้น SDK จะเล่นช่วงพักโฆษณาตอนท้ายหากมีการกำหนดเวลาไว้
เหตุการณ์ ALL_ADS_COMPLETED
จะปรากฏขึ้นเมื่อช่วงพักโฆษณาทั้งหมดมี
เล่นแล้ว นอกจากนี้ โปรดทราบว่าการติดตามเนื้อหาจะเริ่มต้นเมื่อ
initializeWithContentPlayhead:adsRenderingSettings
ของ IMAAdsManager
มีการเรียกใช้เมธอด และคุณควรเรียกใช้ initializeWithContentPlayhead:adsRenderingSettings
เสมอ
ก่อนที่จะเล่นเนื้อหา