複数の広告リクエストを処理する

IMA SDK のほとんどの用途では、一度に管理する広告リクエストは 1 つだけです。ただし、ユーザーが動画を選択する前に広告データをプリロードするなど、一部のエッジケースの実装では、複数のリクエストを同時に行う必要がある場合があります。広告リクエストは非同期で行われるため、適切なアドマネージャーが適切なコンテキストに関連付けられていることを確認するのは、困難な作業に思えるかもしれません。

複数のアドマネージャーを区別するプロセスを簡素化するため、IMA SDK for HTML5 では、パブリッシャーは任意の値またはオブジェクトを広告リクエストの UserContext フィールドに渡すことができます。この値またはオブジェクトは、AdsManagerLoadedEvent ハンドラで getUserRequestContext() メソッドを使用して取得できます。

例

...
adsLoader.addEventListener(
      google.ima.AdsManagerLoadedEvent.Type.ADS_MANAGER_LOADED,
      onAdsManagerLoaded,
      false);
adsLoader.addEventListener(
      google.ima.AdErrorEvent.Type.AD_ERROR,
      onAdsManagerError,
      false);
const contextA = {id: "Request A", element: videoElementA};
const contextB = {id: "Request B", element: videoElementB}
adsLoader.requestAds(adsRequestA, contextA);
adsLoader.requestAds(adsRequestB, contextB);
...

function onAdsManagerLoaded(adsManagerLoadedEvent) {
  const context = adsManagerLoadedEvent.getUserRequestContext();
  adsManager = adsManagerLoadedEvent.getAdsManager(context.element);
  console.log("Successfully loaded ID: " + context.id);
}

function onAdsManagerError(adsManagerErrorEvent) {
  const context = adsManagerErrorEvent.getUserRequestContext();
  console.log("Error with AdRequest ID: " + context.id);
}
...

複数の広告リクエストを処理する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

例

複数の広告リクエストを処理する