查看 SIMID 支援情形

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 類型:

  • requestChangeVolume
  • requestFullscreen
  • requestExitFullscreen

瞭解播放器與廣告素材訊息之間的訊息

下表列出 IMA SDK 支援傳送至 SIMID 廣告素材的訊息:

訊息 說明
init 在工作階段設定期間傳送,包含環境資料和廣告參數。
startCreative 通知廣告素材啟動並顯示廣告素材 iframe。
adStopped 通知廣告工作階段已結束,並提供原因代碼。
adSkipped 通知廣告素材,使用者或 IMA SDK 已略過廣告。
resize 通知廣告素材播放器或影片尺寸變更。
appBackgrounded 通知廣告素材,應用程式已進入背景。
appForegrounded 通知廣告素材,應用程式已返回前景。
fatalError 通知廣告素材發生播放器端錯誤。
log 將記錄訊息從播放器傳送至廣告素材。
focusIn 通知廣告素材已獲得焦點。

查看媒體狀態更新

IMA SDK 會針對下列事件,將 mediaStateUpdate 訊息傳送至廣告素材:

  • play
  • pause
  • stalled (緩衝處理中)
  • seeking
  • seeked
  • ended
  • durationchange
  • timeupdate,定期。
  • volumechange,包括忽略狀態。