VPAID 2 JavaScript クリエイティブ

IMA HTML5 SDK は VPAID 2 JavaScript クリエイティブに対応しています。サポートを有効にするのは簡単ですが、VPAID 2 の仕様と IMA SDK での VPAID 2 のサポート方法には異なる点が 2 つあります。これらの違いがプレーヤーや SDK の実装コードに影響することはありませんが、IMA HTML5 SDK でレンダリングすると、クリエイティブでエラーがスローされたり、想定どおりに機能しなかったりする可能性があるため、VPAID 2 JavaScript クリエイティブの作成者にとっては重要な違いです。

前提条件

  • IMA HTML5 SDK が統合された HTML5 動画プレーヤーです。Google アカウントがない場合は、スタートガイドをご覧ください。
  • VPAID 2 JavaScript のクリエイティブを指す VAST 広告タグ URL。

参考情報

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 セキュリティと動画プレーヤーのプロキシ要素をご覧ください。
  • DISABLED - VPAID 広告は再生されません。リクエストされた広告が VPAID クリエイティブを返すと、エラーがスローされます。
で確認できます。 VPAID モードについて詳しくは、API ドキュメントで ImaSdkSettings.VpaidMode をご覧ください。

VPAID 2 の注意点

iframe セキュリティ

IMA SDK のデフォルトでは、VPAID 2 JavaScript クリエイティブのレンダリングに、わかりやすい iframe（同じドメイン）やページ内スクリプトの代わりにセキュアな iframe が使用されます。つまり、クリエイティブが親ページの DOM にアクセスすることを想定している場合は、エラーの原因となる可能性があります。代わりに friend 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 または Android の SDK でサポートされていますか？
IMA HTML5 SDK は、現在 VPAID 2 JavaScript のクリエイティブをサポートしている唯一の IMA SDK プラットフォームです。
これにより、IMA HTML5 SDK で VPAID クリエイティブが有効になりますか？
はい。IMA HTML5 SDK は VPAID 2 JavaScript クリエイティブに対応しています。