查看 SDK 支援和相容性

選取平台： HTML5 Android iOS tvOS

本頁提供 HTML5 IMA 用戶端支援的一般資訊，以及瀏覽器、影片格式和平台的相容性。

支援的影片格式和瀏覽器

各瀏覽器支援的功能不盡相同，且沒有任何一種預設影片格式是所有主要瀏覽器都支援的。大多數瀏覽器使用的三種主要影片格式為 H.264、WebM 和 Ogg Theora。

支援的影片播放器

一般 HTML5 影片播放器 (包括 HTML <video> 標記) 支援大多數 IMA 功能。如需支援 IMA SDK 的已知影片播放器清單，請參閱「影片技術合作夥伴計畫」。

VAST 事件相容性

本節列出系統根據 VAST 回應中傳回的資訊，自動向伺服器回報的 VAST 事件。

完全支援

complete、creativeView、firstQuartile、impression、midpoint、pause、resume、rewind (在向後跳轉幅度較大時觸發)、start、thirdQuartile。

部分支援

• click

  Click 事件僅適用於影片廣告。Android、iOS 或電腦的原生全螢幕播放器無法擷取點擊，但影片關閉時，網頁內點擊追蹤元素仍可擷取點擊。不過，如果影片元素在 iPad 上使用原生控制項，就無法擷取點擊。

• fullscreen
  

  IMA SDK 支援模擬全螢幕模式，影片會占滿整個瀏覽器視窗。如果影片的 offsetWidth 和 offsetHeight 至少與文件內文大小相同，系統就會將影片視為全螢幕模式。所有瀏覽器都支援這個模式。 如需模擬全螢幕的範例，請下載範例。

  在 iPhone 和 3.0 之前的 Android 平台上，影片一律會以全螢幕模式播放。

• mute、unmute

  iOS 和 Android 僅提供原生音量控制功能。因此，IMA SDK 無法判斷音量或靜音狀態，也無法接收變更通知。以下列出支援和不支援 mute、unmute 的瀏覽器版本：

  • 支援：Firefox 3.5 以上版本、Chrome 8 以上版本、Safari 4 以上版本
  • 不支援：iOS、Android

如要進一步瞭解 VAST 廣告放送，請參閱 IAB 指南。

JavaScript 架構注意事項

搭配使用 JavaScript 架構 (例如 React 或 AngularJS) 與 IMA HTML5 SDK 時，請留意下列事項。這些架構通常會移動 DOM 的元素，這可能會破壞 IMA 功能，因為 IMA 預期 DOM 在 SDK 啟動時是靜態的。IMA 支援 JavaScript 架構，前提是 IMA 必須在架構完成移動 DOM 元素後啟動。具體來說，建構 AdDisplayContainer 時，做為 containerElement 引數傳遞的 HTML5 元素在例項化後不應移動。

支援的影片播放器平台

Google IMA SDK 支援下列平台：

平台	版本	廣告類型
HTML5	電腦：Chrome、Firefox、Safari、Edge、Opera 行動裝置：Chrome/Android 瀏覽器 (Android 手機和平板電腦)、Safari 和 Chrome (iOS)	線性影片、線性多媒體、非線性和隨播廣告、Ad Manager 影片解決方案、Ad Exchange 影片和 AFV 廣告
iOS	iOS 10.0 以上版本	線性廣告和隨播廣告、Ad Manager 影片廣告、Ad Exchange 影片廣告，以及 AFV 廣告
Android	Android 4.4 以上版本	線性廣告和隨播廣告、Ad Manager 影片廣告、Ad Exchange 影片廣告，以及 AFV 廣告
tvOS	tvOS 15 以上版本	線性廣告、Ad Manager 影片和 Ad Exchange 影片

注意：IMA Cast v2 SDK 已淘汰。如要瞭解如何在 Google Cast 裝置上放送用戶端廣告，請參閱「CAF 原生廣告插播」。

影片功能和 SDK 版本

如要進一步瞭解下列功能，請參閱影片廣告總覽。

	HTML5 v3	iOS v3	Android v3	tvOS
IAB Video Suite
VAST 4	9	9	9	9
VAST 3		1	1	1
VAST 2
SIMID 1.0
VPAID 2 (HTML5)
VMAP 1.0.1	2 3	2	2	2
OM SDK 1.3
Ad Manager 影片功能
線性廣告
線性多媒體廣告
YouTube 代管的素材資源	4
非線性廣告 (重疊廣告)	5
隨播廣告
VAST 3 替代隨播廣告資源
Active View 可視率
音訊廣告
VAST 重新導向
透過多媒體請求遞補隨播廣告
Google 發布商廣告代碼 (GPT) 相容性
情境感知
廣告規則	3
廣告規則中的手動廣告插播
6：展示頻率上限
競爭排除項目 (串流)
競爭排除項目 (廣告連播)
競爭排除項目 (整頁)
廣告連播	3
串場廣告
多事件追蹤 (MET) 報表
動態分配 (AdSense 影片廣告、Ad Manager Ad Exchange)
可略過 (非 TrueView) 8	5
串流內 選用廣告
素材資源預先載入	7
AdSense 影片廣告功能
TrueView 插播廣告	5
串流內 選用廣告
標準串流內廣告
完整版位
隨播廣告
隨播廣告候補
重疊說明	5
素材資源預先載入	7
Ad Manager Ad Exchange 功能
TrueView 插播廣告	5
串流內 選用廣告
標準串流內廣告
完整版位
隨播廣告
隨播廣告候補
重疊說明	5
Active View 可視率
素材資源預先載入	7
為什麼會顯示這則廣告？

¹ 非 HTML5 SDK 尚未支援下列 VAST 3.0 功能：

• 隨播 adSlotId
• 隨播廣告放送選項
• 圖示

² 系統目前不支援下列 VMAP 功能：

• VMAP 專屬追蹤事件
• VMAP 專屬錯誤代碼
• 重疊廣告
• 時間偏移值並非 hh:mm:ss 或「start」和「end」
• 顯示 breakType 屬性
• repeatAfter 項屬性

³ 如要在 iPhone 上支援 VMAP 和廣告規則，必須使用自訂廣告播放。

⁴ YouTube 代管廣告素材支援電腦版，但不支援行動版網站。

⁵ 如果 使用 playsinline ，iOS 10 以上版本的 HTML5 行動版網站支援非線性廣告 (重疊廣告)、可略過廣告 (非 TrueView) 和 TrueView 串流內廣告。

⁶ 廣告規則展示頻率上限和競爭排除條件需要使用 Cookie 或 PPID。

⁷ 原生素材資源預先載入功能不適用於下列項目：

• iOS 裝置上的行動版網站
• Android 4.0 之前的行動版網站
• YouTube 代管廣告，包括 TrueView 格式
• IMA 手動插播廣告播放功能 (任何依賴 AD_BREAK_READY 事件的導入方式)

⁸ SDK 不支援長度少於 8 秒的可略過廣告。 如果廣告長度短於最低長度，系統就不會顯示「略過」按鈕。

⁹ 在 Google Ad Manager 支援的 VAST 4 功能中，IMA 支援下列功能：

• VAST 4.2
  • 支援安全互動媒體介面定義 (SIMID)
  • 允許多個 UniversalAdID 節點
• VAST 4.0
  • AdID
  • Mezzanine 檔案
  • 新的 VAST 錯誤代碼
  • 「AdVerifications」支援頁面

已淘汰的 SDK

	Flash v2	HTML5 v1	iOS 第 1 版	Android 第 1 版	Google Cast v2
Ad Manager 影片功能
線性廣告
非線性廣告
互動式 (VPAID 1.0) 廣告
重新導向 (VAST 2.0)
隨播候補廣告 (AdSense 影片廣告、Ad Manager Ad Exchange)
音訊廣告
Google 發布商廣告代碼 (GPT) 相容性
展示頻率上限
競爭排除項目 (串流)
競爭排除項目 (廣告連播)
競爭排除項目 (整頁)
情境感知
廣告規則和廣告規則中的手動廣告插播
廣告連播
串場廣告
報表的多事件追蹤 (MET)
動態分配
可略過的廣告
串流內 選用廣告
AdSense 影片廣告功能
文字廣告
AdSense VAST 串流內廣告
AdSense 疊加廣告
可略過的廣告
串流內 選用廣告
使用者選擇 (YouTube)
Ad Manager 中的 F2F 廣告
Ad Manager Ad Exchange 功能
線性廣告