處理多個廣告請求

選取平台： HTML5 Android iOS tvOS

大多數 IMA SDK 用途一次只需要管理單一廣告請求。不過，在某些特殊情況下，例如在使用者選取影片前預先載入廣告資料，可能需要同時發出多個請求。由於廣告請求是以非同步方式發出，因此確保適當的廣告管理工具與正確的內容建立關聯，似乎是艱鉅的任務。

為簡化區分多個廣告管理工具的程序，Android 適用的 IMA SDK 可讓發布商將任何值或物件傳遞至任何廣告請求的 UserRequestContext 欄位。接著，您可以使用 getUserRequestContext() 方法，在 AdsManagerLoadedEvent 處理常式中擷取這個值或物件。

範例

...

adsLoader = sdkFactory.createAdsLoader(context, imaSdkSettings, adDisplayContainer);

Map<String, String> userContextA = new HashMap<String, String>();
Map<String, String> userContextB = new HashMap<String, String>();
userContextA.put("id", "Request A");
userContextB.put("id", "Request B");
userContextA.put("element", "videoElementA");
userContextB.put("element", "videoElementB");
adRequestA.setUserRequestContext(userContextA);
adRequestB.setUserRequestContext(userContextB);

adsLoader.addAdsLoadedListener(
    new AdsLoader.AdsLoadedListener() {
      @Override
      public void onAdsManagerLoaded(AdsManagerLoadedEvent adsManagerLoadedEvent) {
        Map<String, String> context = adsManagerLoadedEvent.getUserRequestContext();
        adsManager = adsManagerLoadedEvent.getAdsManager();
        Log.i("ImaExample", "Successfully loaded ID: " + context.get("id"));
      }
    });

adsLoader.addAdErrorListener(
    new AdErrorEvent.AdErrorListener() {
      @Override
      public void onAdError(AdErrorEvent adErrorEvent) {
        Map<String, String> context = adErrorEvent.getUserRequestContext();
        Log.i("ImaExample", "Error with AdRequest. ID: " + context.get("id"));
        Log.i("ImaExample", "Ad Error: " + adErrorEvent.getError().getMessage());
      }
    });

adsLoader.requestAds(adRequestA);
adsLoader.requestAds(adRequestB);

...