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，而不是同網域 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 廣告素材。