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
को कॉल करना चाहिए.