SDK टूल के ऑपरेशन मोड
एसडीके, एक या उससे ज़्यादा मोड में काम कर सकता है. यह इस बात पर निर्भर करता है कि विज्ञापन सर्वर से उसे विज्ञापन रिस्पॉन्स कैसा मिलता है.
- एक विज्ञापन
- ऐसा विज्ञापन जिसे
IMAAdsManagerकोstartमैसेज भेजे जाने के दौरान कभी भी चलाया जा सकता है. एक विज्ञापन चलाने के लिए, किसी खास शुरुआती सेटिंग की ज़रूरत नहीं होती. - विज्ञापनों का पॉड
startको मैसेज भेजने पर, एक के बाद एक कई विज्ञापन दिखाए जाते हैं.IMAAdsManagerएक विज्ञापन पॉड चलाने के लिए, किसी खास शुरुआती सेटिंग की ज़रूरत नहीं होती.- विज्ञापन के नियम
- किसी खास कॉन्टेंट के लिए, विज्ञापन के ब्रेक की एक ऐसी प्लेलिस्ट जिसे किसी खास समय पर शेड्यूल किया गया हो. विज्ञापन नियमों के मोड में,
startमैसेज को अनदेखा कर दिया जाता है. किसी एक प्लेलिस्ट में, विज्ञापन दिखाने के लिए कई ब्रेक शेड्यूल किए जा सकते हैं. जैसे, वीडियो शुरू होने से पहले, उसके बीच में या खत्म होने के बाद. लागू करने के बारे में ज़्यादा जानकारी के लिए, यहां दिया गया विज्ञापन के नियम सेक्शन देखें.
विज्ञापन के नियम
IMA tvOS SDK, पूरी तरह से अपने-आप चलने वाली विज्ञापन प्लेलिस्ट के साथ काम करता है. यह सुविधा, विज्ञापनों को ट्रैफ़िक करते समय, Google Ad Manager में बताए गए तरीके से कॉन्टेंट में विज्ञापन ब्रेक डालती है. इससे वीडियो प्लेयर के कोड को भी काफ़ी आसान बनाया जा सकता है. यह कोड, विज्ञापन ब्रेक के लिए ज़रूरी होता है. इसमें प्री-रोल, मिड-रोल, और पोस्ट-रोल विज्ञापन शामिल हैं.
- Ad Manager में विज्ञापनों को ट्रैफ़िक करते समय, विज्ञापन से जुड़े अलग-अलग नियम तय किए जा सकते हैं. जैसे, "कॉन्टेंट की शुरुआत में हमेशा विज्ञापन ब्रेक चलाएं" या "हर 30 मिनट के कॉन्टेंट के बाद, एक मिनट का विज्ञापन ब्रेक चलाएं".
- विज्ञापनों का अनुरोध किए जाने पर, विज्ञापन सर्वर एक विज्ञापन प्लेलिस्ट दिखा सकता है. एसडीके, प्लेलिस्ट को प्रोसेस करता है और विज्ञापन दिखाने के लिए तय की गई जगहों को अपने-आप शेड्यूल करता है.
AdsManagerको शुरू करते समय,IMAContentPlayheadऑब्जेक्ट कोinitializeWithContentPlayhead:adsRenderingSettings:कॉल के ज़रिए पास किया जाता है. अगर कॉन्टेंट दिखाने के लिए AVPlayer का इस्तेमाल किया जा रहा है, तोIMAAVPlayerContentPlayheadका इंस्टेंस, SDK टूल को तब पास किया जाता है, जबadDisplayContainerबनाया जाता है. इस ऑब्जेक्ट का इस्तेमाल, कॉन्टेंट के प्लेबैक की प्रोग्रेस को ट्रैक करने के लिए किया जाता है. इससे Ad Manager में तय किए गए समय पर, विज्ञापन के लिए ब्रेक अपने-आप जुड़ जाते हैं.
AVPlayer के साथ:
IMAContentPlayhead *contentPlayhead = [[IMAAVPlayerContentPlayhead alloc] initWithAVPlayer:self.contentAVPlayer]; IMAAdsRequest *request = [[IMAAdsRequest alloc] initWithAdTagUrl:adTagUrl adDisplayContainer:adDisplayContainer contentPlayhead:contentPlayhead userContext:nil];
AVPlayer के बिना:
IMAContentPlayheadइंटरफ़ेस लागू करें.- अपने वीडियो प्लेयर का मौजूदा समय वापस लाने के लिए,
currentTimeलागू करें. IMAAdsManagerके बजायinitializeWithContentPlayhead:selfका इस्तेमाल करने के लिए,IMAAdsManagerके इनिशियलाइज़ेशन कॉल में बदलाव करें.
- IMAAdsManagerDelegate का इस्तेमाल, विज्ञापन ब्रेक के दौरान कॉन्टेंट को रोकने और फिर से शुरू करने के लिए किया जाता है.
ध्यान दें: जब कॉन्टेंट चलना बंद हो जाए या उपयोगकर्ता ने वीडियो चलाना बंद कर दिया हो, तो IMAAdsLoader पर contentComplete को कॉल करना न भूलें. इससे SDK को यह सिग्नल मिलेगा कि कॉन्टेंट चलना बंद हो गया है. इसके बाद, एसडीके पोस्ट-रोल विज्ञापन ब्रेक दिखाता है. हालांकि, ऐसा तब होता है, जब उसे शेड्यूल किया गया हो.
सभी विज्ञापन ब्रेक दिखाए जाने के बाद, ALL_ADS_COMPLETED इवेंट ट्रिगर होता है. इसके अलावा, ध्यान दें कि कॉन्टेंट को ट्रैक करने की प्रोसेस तब शुरू होती है, जब IMAAdsManager का initializeWithContentPlayhead:adsRenderingSettings तरीका कॉल किया जाता है. साथ ही, आपको कॉन्टेंट चलाने से पहले हमेशा initializeWithContentPlayhead:adsRenderingSettings को कॉल करना चाहिए.