VPAID 2 JavaScript 廣告素材

IMA HTML5 SDK 支援 VPAID 2 JavaScript 廣告素材。啟用支援功能很簡單，不過您必須留意 VPAID 2 規格和 IMA SDK 支援 VPAID 2 的方式。這些差異不會影響播放器或 SDK 導入程式碼，但對於 VPAID 2 JavaScript 廣告素材作者而言十分重要，因為在 IMA HTML5 SDK 顯示時，廣告素材可能會擲回錯誤或無法正常運作。

必要條件

  • 已整合 IMA HTML5 SDK 的 HTML5 影片播放器。如果沒有，請參閱入門指南。
  • 指向 VPAID 2 JavaScript 廣告素材的 VAST 廣告代碼網址。

有幫助的入門資源

啟用 VPAID 2 支援

如要啟用 VPAID 2 JavaScript 支援，請先呼叫以下方法，再初始化 AdDisplayContainer：

      google.ima.settings.setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.ENABLED);
      ...
      var adDisplayContainer = new google.ima.AdDisplayContainer(adContainerElement);
      var adsLoader = new google.ima.AdsLoader(adDisplayContainer);
      ...

可用的 VPAID 模式如下：

  • ENABLED - 允許採用預設設定的 VPAID 廣告。
  • INSECURE - 允許非安全模式的 VPAID 廣告。詳情請參閱「IFrame 安全性」和「影片播放器 Proxy 元素」。
  • DISABLED - VPAID 廣告不會播放。如果請求的廣告傳回 VPAID 廣告素材，系統就會擲回錯誤。
，瞭解如何調查及移除這項存取權。 如要進一步瞭解 VPAID 模式，請參閱 ImaSdkSettings.VpaidMode 的 API 說明文件。

VPAID 2 支援注意事項

iframe 安全性

根據預設，IMA SDK 會使用安全 iframe (同網域) 或網頁內指令碼來顯示 VPAID 2 JavaScript 廣告素材。也就是說，如果廣告素材預期存取上層網頁的 DOM，可能會造成錯誤。如果想在同網域的 iframe 中顯示廣告，請使用 ImaSdkSettings.setVpaidMode(...)，如下所示： 

adsLoader.getSettings().setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.INSECURE);

影片播放器 Proxy 元素

基於安全和適當的行動功能，在 ENABLED 模式下，IMA HTML5 SDK 不會將實際的影片元素提供給廣告。相反地，這個伺服器提供的 Proxy 元素會模仿一般影片元素的大部分功能。如果廣告素材只會呼叫支援的 API 方法，則廣告素材的顯示方式應該不會有任何變化。透過 VpaidMode.INSECURE 模式，SDK 會提供影片播放器元素，而非 Proxy。

以下是影片 Proxy 元素可用的方法、事件監聽器和屬性：

方法

  • addEventListener
  • canPlayType
  • load
  • play
  • pause
  • setattribute

addEventListener 事件類型

  • abort
  • canplay
  • canplaythrough
  • click
  • durationchange
  • emptied
  • ended
  • error
  • loadeddata
  • loadedmetadata
  • loadstart
  • pause
  • play
  • playing
  • progress
  • ratechange
  • suspend
  • seeked
  • seeking
  • timeupdate
  • waiting

屬性

  • currentTime
  • duration
  • ended
  • paused
  • playbackRate
  • src
  • type

常見問題

iOS 或 Android SDK 是否支援 VPAID 2 JavaScript 廣告素材？
IMA HTML5 SDK 是目前唯一支援 VPAID 2 JavaScript 廣告素材的 IMA SDK 平台。
這會啟用 IMA HTML5 SDK 中的 VPAID 廣告素材嗎？
可以，IMA HTML5 SDK 支援 VPAID 2 JavaScript 廣告素材。