โหมดการทำงานของ SDK
SDK สามารถทํางานในโหมดอย่างน้อย 1 โหมดได้ โดยขึ้นอยู่กับการตอบกลับโฆษณาที่ได้รับจากเซิร์ฟเวอร์โฆษณา
- โฆษณาเดี่ยว
- โฆษณาที่เล่นได้ทุกเมื่อเมื่อมีการส่งข้อความ
startไปยังIMAAdsManagerคุณไม่จำเป็นต้อง เริ่มต้นใช้งานเป็นพิเศษเพื่อเล่นโฆษณาเดียว - พ็อดโฆษณา
- โฆษณาหลายรายการที่เล่นต่อเนื่องกันเมื่อมีการส่ง
startข้อความไปยังIMAAdsManagerคุณไม่จำเป็นต้องเริ่มต้นใช้งานเป็นพิเศษเพื่อ เล่นพ็อดโฆษณาเดียว - กฎของโฆษณา
- เพลย์ลิสต์ของช่วงพักโฆษณาที่กำหนดเวลาไว้ในช่วงเวลาหนึ่งๆ สำหรับเนื้อหา
ที่เฉพาะเจาะจง ระบบจะไม่สนใจข้อความ
startในโหมดกฎโฆษณา คุณสามารถ กำหนดเวลาช่วงพักโฆษณาหลายช่วงภายในเพลย์ลิสต์เดียวได้ (เช่น โฆษณาตอนต้น โฆษณาตอนกลาง โฆษณาตอนท้าย) ดูรายละเอียดการติดตั้งเพิ่มเติมได้ที่ส่วนกฎโฆษณาด้านล่าง
กฎของโฆษณา
IMA iOS 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
ก่อนเล่นเนื้อหาเสมอ