メディアをプリロードする

プラットフォームを選択: HTML5 Android

IMA SDK は、動画広告アセットのプリロードに対応しています。この機能を SDK 統合で有効にすると、広告とコンテンツ間の移行がよりシームレスになります。このガイドでは、IMA SDK を使用してメディアのプリロードを実装する際の技術的な詳細について説明します。

プリローディングを有効にする

プリロードを有効にするには、AdsRenderingSettings.enablePreloading を true に設定します。これは ADS_MANAGER_LOADED イベントの結果として行われる必要があります。

function onAdsManagerLoaded(adsManagerLoadedEvent) {
  var adsRenderingSettings = new google.ima.AdsRenderingSettings();
  adsRenderingSettings.enablePreloading = true;
  ...
  var adsManager = adsManagerLoadedEvent.getAdsManager(
      videoContent, adsRenderingSettings);
}

タイミング

次の表は、プリロードが有効になっている場合の広告読み込みタイミングの変更点をまとめたものです。

イベント プリロードあり プリロードなし
広告の VAST がリクエストされました AdsLoader.requestAds() AdsLoader.requestAds()
プレロールが読み込まれた(単一広告) AdsManager.init() AdsManager.start()
プレロールが読み込まれた(VMAP/広告ルール) AdsManager.init() AdsManager.init()
ミッドロールまたはポストロールが読み込まれた 広告ブレークの最初の広告の場合、広告開始時刻の 8 秒前。連続する広告の場合、前の広告の再生が開始されたとき。 広告の開始時間。

制限事項

プリロードには次の制限があります。

  • メディアのプリロードは、iOS デバイスのモバイルウェブや、コネクテッド スマートテレビで HTML5 IMA SDK を使用している場合は利用できません。
  • VPAID はプリロードされますが、広告の依存関係(広告で再生されるメディアなど)は、広告が実行されるまで読み込まれません。
  • VMAP 広告をプリロードするには、自動再生を有効にする必要があります。settings.isAutoPlayAdBreaks() がデフォルト値の true に設定されていることを確認します。
  • ポストロールは、最後のミッドロールの後、または AdsRequest.contentDuration を使用して再生時間を設定している場合はコンテンツの終了の 8 秒前にプリロードされます。

よくある質問

メディアのプリロードではクリエイティブ全体が読み込まれますか?
いいえ。通常、広告の再生が開始された時点でクリエイティブの読み込みは完了していません。プリロードは、広告の読み込みにかかる時間を最小限に抑えることで、ユーザー エクスペリエンスを向上させることを目的としています。オフライン広告配信をサポートすることを目的としていません。IMA SDK は、ブラウザで許可される範囲で、ユーザーのインターネット接続とクリエイティブのサイズを上限として、メディアを読み込みます。
広告の VAST とメディアの両方でメディアのプリロードを有効にする必要がありますか?
いいえ。このプリロード設定に関係なく、SDK は常に広告の VAST をプリロードします。