โหมดการทำงานของ 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
เมื่อเล่นช่วงพักโฆษณาทั้งหมดแล้ว
นอกจากนี้ โปรดทราบว่าการติดตามเนื้อหาจะเริ่มขึ้นเมื่อมีการเรียกใช้เมธอด IMAAdsManager
's initializeWithContentPlayhead:adsRenderingSettings
และคุณควรเรียกใช้ initializeWithContentPlayhead:adsRenderingSettings
ก่อนเล่นเนื้อหาเสมอ