Google 互動式媒體廣告 (IMA) SDK HTML5 版支援安全互動媒體介面定義 (SIMID) 1.1 版。本指南說明 IMA SDK 支援的特定 SIMID 功能和訊息。
瞭解廣告素材與播放器之間的訊息
下表列出 SIMID 廣告素材可傳送至 IMA SDK 的訊息:
| 訊息 | 說明 |
|---|---|
clickThru |
根據廣告素材提供的 URI 處理廣告點擊。 |
fatalError |
終止廣告工作階段,並回報廣告素材的嚴重錯誤。 |
getMediaState |
傳回媒體播放器的目前狀態,包括 URI、currentTime、duration、volume 和 muted 狀態。 |
log |
將廣告素材記錄訊息轉送至 IMA SDK 進行偵錯。 |
reportTracking |
要求 IMA SDK 代替廣告素材連線偵測追蹤網址。 |
requestChangeAdDuration |
要求修改廣告工作階段的總長度。 |
requestNavigation |
要求前往外部 URI。 |
requestPause |
要求 IMA SDK 暫停媒體播放器。 |
requestPlay |
要求 IMA SDK 繼續播放或播放媒體播放器。 |
requestResize |
要求調整影片播放器大小。如果播放器允許調整大小,IMA SDK 就會調整播放器大小。 |
requestSkip |
要求 SDK 略過目前的廣告。 |
requestStop |
要求 SDK 停止廣告工作階段。 |
handleSkipShown |
通知 IMA SDK,廣告素材已顯示廣告略過 UI。 |
requestFocus |
要求聚焦廣告素材的 iframe。 |
查看「播放器不支援廣告素材」訊息
IMA SDK 不會處理下列 CreativeMessage 類型:
requestChangeVolumerequestFullscreenrequestExitFullscreen
瞭解播放器與廣告素材訊息之間的訊息
下表列出 IMA SDK 支援傳送至 SIMID 廣告素材的訊息:
| 訊息 | 說明 |
|---|---|
init |
在工作階段設定期間傳送,包含環境資料和廣告參數。 |
startCreative |
通知廣告素材啟動並顯示廣告素材 iframe。 |
adStopped |
通知廣告工作階段已結束,並提供原因代碼。 |
adSkipped |
通知廣告素材,使用者或 IMA SDK 已略過廣告。 |
resize |
通知廣告素材播放器或影片尺寸變更。 |
appBackgrounded |
通知廣告素材,應用程式已進入背景。 |
appForegrounded |
通知廣告素材,應用程式已返回前景。 |
fatalError |
通知廣告素材發生播放器端錯誤。 |
log |
將記錄訊息從播放器傳送至廣告素材。 |
focusIn |
通知廣告素材已獲得焦點。 |
查看媒體狀態更新
IMA SDK 會針對下列事件,將 mediaStateUpdate 訊息傳送至廣告素材:
playpausestalled(緩衝處理中)seekingseekedendeddurationchangetimeupdate,定期。volumechange,包括忽略狀態。