HTML5 適用的 Google 互動式媒體廣告 (IMA) SDK 支援安全互動媒體介面定義 (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,廣告素材已顯示廣告略過使用者介面。 |
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包括靜音狀態。