查看 SDK 支援和相容性

選取平台： HTML5 Android iOS tvOS

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

支援的影片格式和瀏覽器

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

支援的影片播放器

一般 HTML5 影片播放器支援大多數 IMA 功能，包括 HTML <video> 標記。如要查看支援 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 和 Android 3.0 之前的平台上，影片一律會以全螢幕模式播放。

• 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 啟動 SDK 時，DOM 必須是靜態的，因此可能會導致 IMA 功能中斷。只要在架構完成移動 DOM 元素後啟動 IMA，IMA 就支援 JavaScript 架構。具體來說，建構 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 第 2 版 SDK 已淘汰。如要瞭解如何在 Google Cast 裝置上放送用戶端廣告，請參閱「CAF 原生廣告插播」。

影片功能和 SDK 版本

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

	HTML5 v3	iOS v3	Android v3	tvOS
IAB 影片套件
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
串流內 選用廣告
標準串流內廣告
Full-slot
隨播廣告
隨播廣告回填
重疊說明	5
素材資源預先載入	7
Ad Manager Ad Exchange 功能
TrueView 插播廣告	5
串流內 選用廣告
標準串流內廣告
Full-slot
隨播廣告
隨播廣告回填
重疊說明	5
Active View 可視度
素材資源預先載入	7
為什麼會顯示這則廣告？

¹ 非 HTML5 SDK 目前不支援下列 VAST 3.0 功能：

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

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

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

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

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

⁵ 在 iOS 10 以上的 HTML5 行動版網頁上，系統支援非線性廣告 (重疊)、可略過的廣告 (非 TrueView) 和 TrueView 串流內廣告，但須使用 playsinline 。

⁶ 廣告規則展示頻率上限和競爭排除需要使用 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 v1	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 功能
線性廣告