IMA HTML5 SDK は VPAID 2 JavaScript クリエイティブに対応しています。サポートを有効にする方法は簡単ですが、VPAID 2 の仕様と IMA SDK が VPAID 2 をサポートする方法には 2 つの違いがあります。この違いはプレーヤーや SDK の実装コードには影響しませんが、IMA HTML5 SDK によるレンダリング時にクリエイティブがエラーをスローする場合や想定どおりに動作しない場合があるため、VPAID 2 JavaScript クリエイティブの作成者にとっては重要です。
前提条件
- IMA HTML5 SDK が統合された HTML5 動画プレーヤーアカウントがない場合は、スタートガイドをご覧ください。
- VPAID 2 JavaScript クリエイティブを指す VAST 広告タグ URL。
参考情報
- VPAID 2 について詳しくは、IAB の VPAID のページをご覧ください。
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 2 サポートの注意事項
iframe のセキュリティ
IMA SDK では、VPAID 2 JavaScript クリエイティブを表示する場合、同一ドメイン用の Friendly iFrame やページはめ込みスクリプトではなく、セキュアな iframe をデフォルトで使用します。つまり、クリエイティブに親ページの DOM へのアクセスを想定している場合は、エラーが発生する可能性があります。代わりに フレンドリーな iframe で広告をレンダリングするには、次のように ImaSdkSettings.setVpaidMode(...)
を使用します。
adsLoader.getSettings().setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.INSECURE);
動画プレーヤーのプロキシ要素
セキュリティと適切なモバイル機能のため、ENABLED
モードでは、IMA HTML5 SDK は実際の動画要素を広告に提供しません。代わりに通常の動画要素とほぼ同じ機能を装備したプロキシ要素を使用します。サポートされている API メソッドのみを呼び出す広告クリエイティブについては、クリエイティブのレンダリング時の動作は変わりません。VpaidMode.INSECURE
モードでは、SDK はプロキシではなく動画プレーヤー要素を提供します。
動画プロキシ要素で使用できるメソッド、リスナー、属性は次のとおりです。
Methods
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 クリエイティブに対応しています。