VPAID 2 JavaScript クリエイティブを有効にする

IMA HTML5 SDK は VPAID 2 JavaScript クリエイティブをサポートしています。サポートを有効にする場合、 VPAID 2 仕様 と IMA SDK による VPAID 2 のサポート方法には、注意すべき 2 つの大きな違いがあります。これらの違いはプレーヤーや SDK の実装コードには影響しませんが、IMA HTML5 SDK でレンダリングされたときにクリエイティブがエラーをスローしたり、期待どおりに動作しなかったりする可能性があるため、VPAID 2 JavaScript クリエイティブの作成者にとっては重要です。

前提条件

このガイドに沿って操作するには、次のものを含むアプリから始めます。

参考資料

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 モードは次のとおりです。

VPAID モードについて詳しくは、 ImaSdkSettings.VpaidMode の API ドキュメントをご覧ください。

VPAID 2 のサポートに関する注意事項

iframe のセキュリティ

デフォルトでは、IMA SDK は Friendly iframe（同じドメイン）やページ内スクリプトではなく、安全な iframe を使用して VPAID 2 JavaScript クリエイティブをレンダリングします。 つまり、クリエイティブが親ページの DOM にアクセスすることを想定している場合、エラーが発生する可能性があります。代わりに Friendly iframe で広告をレンダリングするには、次のように ImaSdkSettings.setVpaidMode(...) を使用します。

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

動画プレーヤーのプロキシ要素

セキュリティと適切なモバイル機能のために、ENABLED モードでは、IMA HTML5 SDK は実際の動画要素を広告に提供しません。代わりに、通常の動画要素の機能の多くを模倣するプロキシ要素を提供します。 サポートされている API メソッドのみを呼び出す広告クリエイティブの場合、クリエイティブのレンダリング動作は変更されません。VpaidMode.INSECURE モードでは、SDK はプロキシの代わりに動画プレーヤー要素を提供します。

動画プロキシ要素で使用できるメソッド、リスナー、属性は次のとおりです。

メソッド

  • 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

よくある質問

VPAID 2 JavaScript クリエイティブは iOS SDK または Android SDK でサポートされていますか？
IMA HTML5 SDK は、VPAID 2 JavaScript クリエイティブをサポートする唯一の IMA SDK プラットフォームです。
これにより、IMA HTML5 SDK で VPAID クリエイティブが有効になりますか？
はい。IMA HTML5 SDK は VPAID 2 JavaScript クリエイティブをサポートしています。