UserContext के साथ कई विज्ञापन अनुरोधों को मैनेज करना

IMA SDK टूल के ज़्यादातर इस्तेमाल के लिए, एक बार में सिर्फ़ एक विज्ञापन अनुरोध मैनेज करना ज़रूरी होता है. हालांकि, कुछ खास मामलों में, एक साथ कई अनुरोध करने पड़ सकते हैं. जैसे, उपयोगकर्ता के वीडियो चुनने से पहले, विज्ञापन डेटा को प्रीलोड करना. विज्ञापन अनुरोध, एक साथ नहीं किए जाते. इसलिए, यह पक्का करना मुश्किल हो सकता है कि सही विज्ञापन मैनेजर, सही संदर्भ से जुड़ा हो.

एक से ज़्यादा विज्ञापन मैनेजर के बीच अंतर करने की प्रोसेस को आसान बनाने के लिए, tvOS के लिए IMA SDK टूल की मदद से पब्लिशर, किसी भी विज्ञापन अनुरोध के UserContext फ़ील्ड में कोई भी वैल्यू या ऑब्जेक्ट पास कर सकते हैं. इसके बाद, इस वैल्यू या ऑब्जेक्ट को IMAAdsLoadedData ऑब्जेक्ट के userContext एट्रिब्यूट के ज़रिए AdsLoader:AdsLoadedWithData डेलिगेट फ़ंक्शन में वापस लाया जा सकता है.

उदाहरण

...
  adsLoader = IMAAdsLoader(settings: nil)
  adsLoader.delegate = self

  let userContextA = {id: "Request A", element: videoElementA}
  let userContextB = {id: "Request B", element: videoElementB}
  let requestA = IMAAdsRequest(
        adTagUrl: ViewController.AdTagURLString,
        adDisplayContainer: adDisplayContainer,
        contentPlayhead: contentPlayhead,
        userContext: userContextA)
  let requestB = IMAAdsRequest(
        adTagUrl: ViewController.AdTagURLString,
        adDisplayContainer: adDisplayContainer,
        contentPlayhead: contentPlayhead,
        userContext: userContextB)
  adsLoader.requestAds(with: requestA)
  adsLoader.requestAds(with: requestB)

...

// MARK: - IMAAdsLoaderDelegate

func adsLoader(_ loader: IMAAdsLoader!, adsLoadedWith adsLoadedData: IMAAdsLoadedData!) {
  let userContext = adsLoadedData.userContext
  print("Loaded ads for ID: " + userContext.id)
  adsManager = adsLoadedData.adsManager
  adsManager.initialize(with: nil)
}

func adsLoader(_ loader: IMAAdsLoader!, failedWith adErrorData: IMAAdLoadingErrorData!) {
  let userContext = adsLoadingErrorData.userContext
  print("Error loading ads for ID: " + userContext.id)
}

...