支援和相容性

本頁提供 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 至少小於文件內文的尺寸，我們會將影片的 offsetWidth 視為全螢幕模式。所有瀏覽器都支援此模式。如需模擬全螢幕的範例，請下載範例。

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

• mute、unmute

  iOS 和 Android 只有音量的原生控制項。因此 IMA SDK 無法判斷音量或靜音狀態，也不會收到變更通知。以下是支援及不支援 mute、unmute 的瀏覽器版本清單：

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

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

JavaScript 架構的注意事項

搭配 IMA HTML5 SDK 使用 JavaScript 架構 (例如 React 或 AngularJS) 時，您必須考量幾個重點。這些架構通常會移動 DOM 的元素，而這些元素可能會破壞 IMA 的功能，因為 IMA 預期在 SDK 啟動時將 DOM 保持靜態。IMA 支援 JavaScript 架構，但前提是 IMA 必須在架構完成移動 DOM 元素後啟動。具體來說，在建構 AdDisplayContainer 時，以 containerElement 引數傳遞的 HTML5 元素在執行個體化後，不應移動。

Apple AirPlay 支援

IMA SDK 目前不支援 Apple AirPlay。偵測到 AirPlay 時，停用 AirPlay 或停用廣告請求。

支援的影片播放器平台

下列平台支援 Google IMA SDK：

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

影片功能和 SDK 版本

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

	HTML5 第 3 版	iOS 第 3 版	Android 3.0 版	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
串流內 選用廣告
標準串流內廣告
全版位
隨播廣告
隨播廣告
重疊說明	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 第 2 版	HTML5 第 1 版	iOS 第 1 版	Android 第 1 版	Google Cast 第 2 版
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 功能
線性廣告