IMA SDK 可讓您輕鬆將多媒體廣告整合至您的網站和應用程式。IMA SDK 可以從任何 符合 VAST 規定的廣告伺服器請求廣告,並管理在應用程式中播放的廣告。使用 IMA DAI SDK 時,應用程式會向廣告和內容影片 (VOD 或直播內容) 發出串流請求。接著,SDK 會傳回合併的影片串流,因此您不必在應用程式中切換廣告和內容影片。
選取所需的 DAI 解決方案
廣告連播放送 DAI
本指南說明如何透過簡易的影片播放器,使用適用於 iOS 的 IMA DAI SDK,以播放 DAI Pod 放送直播或 VOD 串流。如要參考完整範例,請下載 Pod 提供範例。
IMA DAI 廣告連播放送總覽
使用適用於 iOS 的 IMA DAI SDK 導入廣告連播放送時,必須涵蓋兩個主要元件:
StreamRequest
:定義傳送至 Google 廣告伺服器的串流要求的物件。必須使用IMAPodStreamRequest
或IMAPodVODStreamRequest
建立,才能啟用 Pod 提供功能。這兩種方法都需使用聯播網代碼和IMAPodStreamRequest
,也需要自訂資產金鑰。API 金鑰是選填項目。IMAStreamManager
:這個物件會處理影片串流與 IMA DAI SDK 之間的通訊,例如觸發追蹤連線偵測 (ping),以及將串流事件轉送至發布商。
先備知識
開始之前,請先備妥以下項目:
- Xcode 13 以上版本。
- CocoaPods (建議使用)、Swift 套件管理工具或下載的 IMA DAI SDK 副本。
- iOS 應用程式已透過 IMA DAI SDK 設定,以便透過 DAI 廣告播放影片串流。如果您尚未安裝這類應用程式,建議您先使用 iOS DAI BasicExample 做為起點。BasicExample 含有本指南參照的程式碼集。如要進一步瞭解如何導入 IMA DAI SDK,請參閱快速入門指南。
設定廣告連播放送變數
對 Pod 提供服務所需的所有變更,都會在 Objective-C 中的 ViewController.swift 或 ViewController.m 內完成。本指南中的程式碼片段預設使用 Swift 語言。第一步是更新常數變數
以下是要新增的廣告連播串流請求常數:
STREAM_URL
(僅適用於直播):由資訊清單操縱器或第三方合作夥伴使用 Pod 放送功能提供的影片串流網址。在發出請求之前,您應該先插入 IMA DAI SDK 提供的串流 ID。在這種情況下,在提出要求之前,串流網址包含會替換為串流 ID 的預留位置"[[STREAMID]]"
。NETWORK_CODE
:Ad Manager 360 帳戶的聯播網代碼。CUSTOM_ASSET_KEY
(僅適用於直播):自訂素材資源鍵,用於識別 Ad Manager 360 中的廣告連播放送事件。這項資訊可由資訊清單操縱器或第三方 Pod 放送合作夥伴建立。API_KEY
(僅適用於直播):此為選用的 API 金鑰,可從 IMA DAI SDK 擷取串流 ID。
將範例的變數區段改為以下內容:
...
class ViewController:
UIViewController,
IMAAdsLoaderDelegate,
IMAStreamManagerDelegate,
AVPlayerViewControllerDelegate
{
static let streamUrl =
"https://encodersim.sandbox.google.com/masterPlaylist/9c654d63-5373-4673-8c8d-6d92b66b9d46/master.m3u8?gen-seg-redirect=true&network=51636543&event=google-sample&pids=devrel4628000,devrel896000,devrel3528000,devrel1428000,devrel2628000,devrel1928000&seg-host=dai.google.com&stream_id=[[STREAMID]]"
static let networkCode = "51636543"
static let customAssetKey = "google-sample"
static let APIKey = ""
static let backupStreamURLString =
"http://googleimadev-vh.akamaihd.net/i/big_buck_bunny/bbb-,480p,720p,1080p,.mov.csmil/master.m3u8"
var adsLoader: IMAAdsLoader?
...
建立直播或隨選廣告連播串流請求
直播活動廣告連播放送
修改 requestStream
方法,藉由執行個體化 IMAPodStreamRequest
來建立運作中的 Pod 串流要求。
...
func requestStream() {
guard let playerViewController = self.playerViewController else return
guard let adContainerView = self.adContainerView else return
guard let adsLoader = self.adsLoader else return
self.videoDisplay = IMAAVPlayerVideoDisplay(avPlayer: playerViewController.player)
adDisplayContainer = IMAAdDisplayContainer(
adContainer: adContainerView, viewController: self)
// Create a podserving stream request.
request = IMAPodStreamRequest(
networkCode: self.networkCode,
customAssetKey: self.customAssetKey,
adDisplayContainer: adDisplayContainer,
videoDisplay: self.videoDisplay,
userContext: nil)
adsLoader.requestStream(with: request)
}
...
VOD 串流廣告連播放送
修改 requestStream
方法,藉由例項化 IMAPodVODStreamRequest
來建立 VOD Pod 串流要求。
...
func requestStream() {
guard let playerViewController = self.playerViewController else return
guard let adContainerView = self.adContainerView else return
guard let adsLoader = self.adsLoader else return
self.videoDisplay = IMAAVPlayerVideoDisplay(avPlayer: playerViewController.player)
adDisplayContainer = IMAAdDisplayContainer(
adContainer: adContainerView, viewController: self)
// Create a podserving stream request.
request = IMAPodVODStreamRequest(
networkCode: self.networkCode,
adDisplayContainer: adDisplayContainer,
videoDisplay: self.videoDisplay,
userContext: nil)
adsLoader.requestStream(with: request)
}
...
編輯並設定串流網址
直播活動廣告連播放送
修改 IMAAdsLoaderDelegate
方法,使用 streamManager.streamId
取得串流 ID。接著,將串流 ID 插入 STREAM_URL
,取代 "[[STREAMID]]"
。完成這項變更後,您就可以使用 videoDisplay.loadStream()
設定新的串流網址。
...
// MARK: - IMAAdsLoaderDelegate
func adsLoader(_ loader: IMAAdsLoader!, adsLoadedWith adsLoadedData: IMAAdsLoadedData!) {
let streamManager = adsLoadedData.streamManager
let streamId = streamManager.streamId
let urlString = streamUrl.replacingOccurrences(of: "[[STREAMID]]", with: streamId)
let loadedStreamUrl = URL(string:urlString)
self.videoDisplay.loadStream(loadedStreamUrl, subtitles:@[])
self.videoDisplay.play()
streamManager.delegate = self
streamManager.initialize(with: nil)
self.streamManager = streamManager
}
...
VOD 串流廣告連播放送
修改 IMAAdsLoaderDelegate
方法,使用 streamManager.streamId
取得串流 ID。接著,向影片技術合作夥伴 (VTP) 要求串流網址。接著呼叫 IMAStreamManager.loadThirdPartyStream()
,要求 IMA 載入串流網址以及 TVP 傳回的所有字幕。
...
// MARK: - IMAAdsLoaderDelegate
func adsLoader(_ loader: IMAAdsLoader!, adsLoadedWith adsLoadedData: IMAAdsLoadedData!) {
let streamManager = adsLoadedData.streamManager
let streamId = streamManager.streamId
// 'vtpInterface' is a place holder for your own video technology partner
// (VTP) API calls.
let streamUrl = vtpInterface.requestStreamURL(streamID)
self.streamManager.loadThirdPartyStream(streamUrl, streamSubtitles:@[])
streamManager.delegate = self
streamManager.initialize(with: nil)
self.streamManager = streamManager
}
大功告成!現在,您會使用適用於 iOS 的 IMA DAI SDK,在廣告連播放送串流中請求及顯示廣告。如要查看其他使用 IMA DAI SDK 的範例,請參閱 GitHub 上的範例。