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