SDK 作業模式
SDK 可根據廣告回應發出的廣告回應,在一種或多種模式下運作 伺服器
- 單一廣告
- 在
start
訊息傳送至IMAAdsManager
。沒有特殊初始化 才能播放單一廣告。 - 廣告連播
- 在
start
訊息傳送到IMAAdsManager
。不需要特殊初始化 播放單一廣告連播 - 廣告規則
- 針對特定時段安排的廣告時段播放清單
內容。系統會在廣告規則模式中忽略
start
訊息。這裡 在單一播放清單中排定多個廣告插播 (例如片頭廣告、 片中廣告、片尾廣告)。如要進一步瞭解導入作業,請參閱 廣告規則一節。
廣告規則
IMA tvOS SDK 支援全自動廣告播放清單。這項功能 可將廣告插播時間點插入內容 Google Ad Manager 所需的資訊這也大幅簡化了影片播放器程式碼 包括片頭廣告、片中廣告和片尾廣告。
- 在 Ad Manager 中投放廣告時,您可以指定各種廣告規則 例如「一律在內容開頭播放廣告插播」或「播放一分鐘的廣告插播」 每 30 分鐘顯示一次內容」。
- 請求廣告時,廣告伺服器可能會傳回廣告播放清單。SDK 系統會處理播放清單並自動排定 。
- 初始化
AdsManager
時,IMAContentPlayhead
物件會透過initializeWithContentPlayhead:adsRenderingSettings:
傳入 呼叫。如果您使用 AVPlayer 顯示內容, 向 SDK 傳送IMAAVPlayerContentPlayhead
例項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 指出
結束播放。然後播放片尾廣告時段 (如果已安排)。
所有廣告插播時間點均有時,就會引發 ALL_ADS_COMPLETED
事件
。此外請注意,內容追蹤會從
IMAAdsManager
的「initializeWithContentPlayhead:adsRenderingSettings
」
方法,且應一律呼叫 initializeWithContentPlayhead:adsRenderingSettings
再開始播放內容