適用於 HTML5 的 Google 動態廣告插播 (DAI) SDK 支援安全互動媒體介面定義 (SIMID) 1.1 版。本指南說明 DAI SDK 支援的特定 SIMID 功能和訊息。
瞭解廣告素材到播放器的訊息
下表列出 SIMID 廣告素材可傳送至 IMA DAI 的訊息:
| 訊息 | 說明 |
|---|---|
clickThru |
DAI SDK 會對 DAI 廣告代碼中設定的點閱追蹤網址執行 Ping 作業。DAI SDK 會忽略廣告素材提供的任何自訂 URI 或導覽選項。 |
getMediaState |
傳回媒體播放器的目前狀態,包括 currentTime、duration、volume、muted、paused 和 fullscreen 屬性。由於動態廣告插播使用伺服器端縫合串流,因此 currentSrc 屬性一律會傳回 null。 |
log |
將廣告素材記錄訊息轉送至 DAI SDK 偵錯控制台記錄,以利排解問題。 |
reportTracking |
要求 DAI SDK 對廣告素材的追蹤網址發出通知。 |
requestPause |
要求 DAI SDK 暫停媒體播放器。 |
requestPlay |
要求 DAI SDK 在媒體播放器上繼續播放。 |
requestSkip |
要求 DAI SDK 略過目前的廣告。僅支援隨選視訊串流。如果廣告素材為直播傳送這則訊息,系統會拒絕。 |
查看「不支援的廣告素材至播放器」訊息
DAI SDK 不會處理下列 CreativeMessage 類型:
fatalErrorrequestChangeAdDurationrequestFullscreenrequestExitFullscreenhandleSkipShownrequestFocusrequestNavigation:一律遭拒。播放器會預期廣告素材處理導覽。requestResize:一律遭拒。DAI SDK 不支援調整廣告素材大小。requestStop:一律遭拒。這類廣告適用於長時間使用情境,但 DAI 不支援這類廣告。requestChangeVolume:DAI SDK 成功解決此事件,但不會變更廣告素材的音量。
瞭解玩家與創作者之間的訊息
下表列出 DAI SDK 支援傳送至 SIMID 廣告素材的訊息:
| 訊息 | 說明 |
|---|---|
init |
在工作階段設定期間傳送,內含環境資料和廣告參數。 |
startCreative |
通知廣告素材啟動並顯示廣告素材 iframe。 |
adStopped |
通知廣告工作階段已結束,包括原因代碼。 |
adSkipped |
通知廣告素材,使用者或 DAI SDK 已略過廣告。僅支援隨選視訊串流。 |
查看不支援的播放器至廣告素材訊息
DAI SDK 不支援或傳送下列訊息給廣告素材:
resizeappBackgroundedappForegroundedlog
查看媒體狀態更新
DAI SDK 會在下列事件發生時,將 mediaStateUpdate 訊息傳送至廣告素材:
playpausestalled(緩衝)seekingseekedtimeupdate(定期)volumechange(包括靜音狀態)
DAI SDK 不支援下列事件,且事件發生時不會傳送媒體狀態更新:
endeddurationchangeerror