Xử lý nhiều yêu cầu quảng cáo bằng UserContext

Hầu hết các trường hợp sử dụng SDK IMA chỉ yêu cầu quản lý một yêu cầu quảng cáo tại một thời điểm. Tuy nhiên, một số trường hợp triển khai đặc biệt (chẳng hạn như tải trước dữ liệu quảng cáo trước khi người dùng chọn một video) có thể yêu cầu thực hiện nhiều yêu cầu đồng thời. Vì các yêu cầu quảng cáo được thực hiện không đồng bộ, nên việc đảm bảo liên kết đúng trình quản lý quảng cáo với đúng ngữ cảnh có vẻ như là một nhiệm vụ khó khăn.

Để đơn giản hoá quá trình phân biệt nhiều trình quản lý quảng cáo, SDK IMA cho HTML5 cho phép nhà xuất bản truyền bất kỳ giá trị hoặc đối tượng nào vào trường UserContext của bất kỳ yêu cầu quảng cáo nào. Sau đó, bạn có thể truy xuất giá trị hoặc đối tượng này trong trình xử lý AdsManagerLoadedEvent bằng cách sử dụng phương thức getUserRequestContext().

Ví dụ:

...
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);
}
...