IMA SDK की मदद से, अपनी वेबसाइटों और ऐप्लिकेशन में मल्टीमीडिया विज्ञापन आसानी से इंटिग्रेट किए जा सकते हैं. IMA SDK, वीएएसटी के साथ काम करने वाले किसी भी विज्ञापन सर्वर से विज्ञापनों का अनुरोध कर सकते हैं. साथ ही, आपके ऐप्लिकेशन में विज्ञापन दिखाने की सुविधा को मैनेज कर सकते हैं. IMA DAI SDK की मदद से, ऐप्लिकेशन विज्ञापन और कॉन्टेंट वीडियो के लिए स्ट्रीम का अनुरोध करते हैं. यह कॉन्टेंट, वीओडी या लाइव कॉन्टेंट हो सकता है. इसके बाद, SDK टूल एक साथ वीडियो स्ट्रीम दिखाता है, ताकि आपको अपने ऐप्लिकेशन में विज्ञापन और कॉन्टेंट वीडियो के बीच स्विच करने की ज़रूरत न पड़े.
डीएआई का वह समाधान चुनें जिसमें आपकी दिलचस्पी है
डीएआई की पूरी सेवा
इस गाइड में, IMA DAI SDK को वीडियो प्लेयर ऐप्लिकेशन में इंटिग्रेट करने के बारे में बताया गया है. अगर आपको इंटिग्रेशन का पूरा सैंपल देखना है या उसका पालन करना है, तो GitHub से BasicExample डाउनलोड करें.
आईएमए डीएआई की खास जानकारी
IMA डीएआई को लागू करने के लिए, एसडीके के चार मुख्य कॉम्पोनेंट का इस्तेमाल किया जाता है. इस गाइड में इनके बारे में बताया गया है:
IMAAdDisplayContainer– यह एक कंटेनर ऑब्जेक्ट है, जो वीडियो प्लेबैक एलिमेंट के ऊपर होता है. इसमें विज्ञापन के यूज़र इंटरफ़ेस (यूआई) एलिमेंट होते हैं.IMAAdsLoader– यह एक ऐसा ऑब्जेक्ट है जो स्ट्रीम का अनुरोध करता है और स्ट्रीम के अनुरोध के रिस्पॉन्स ऑब्जेक्ट से ट्रिगर होने वाले इवेंट को हैंडल करता है. आपको सिर्फ़ एक विज्ञापन लोडर को इंस्टैंशिएट करना चाहिए. इसका इस्तेमाल पूरे ऐप्लिकेशन में किया जा सकता है.IMAStreamRequest–IMAVODStreamRequestयाIMALiveStreamRequest. यह एक ऐसा ऑब्जेक्ट है जो स्ट्रीम के अनुरोध के बारे में बताता है. स्ट्रीम के अनुरोध, वीडियो-ऑन-डिमांड या लाइव स्ट्रीम के लिए किए जा सकते हैं. लाइव स्ट्रीम के अनुरोधों में ऐसेट कुंजी के बारे में बताया जाता है. वहीं, वीओडी के अनुरोधों में सीएमएस आईडी और वीडियो आईडी के बारे में बताया जाता है. दोनों तरह के अनुरोधों में, एपीआई पासकोड शामिल किया जा सकता है. इसकी ज़रूरत, चुनी गई स्ट्रीम को ऐक्सेस करने के लिए होती है. साथ ही, Google Ad Manager नेटवर्क कोड भी शामिल किया जा सकता है. इसकी ज़रूरत, IMA SDK को विज्ञापन आइडेंटिफ़ायर मैनेज करने के लिए होती है. ये आइडेंटिफ़ायर, Google Ad Manager की सेटिंग में तय किए जाते हैं.IMAStreamManager– यह एक ऐसा ऑब्जेक्ट है जो डाइनैमिक ऐड इंसर्शन वाली स्ट्रीम और DAI बैकएंड के साथ इंटरैक्शन को मैनेज करता है. स्ट्रीम मैनेजर, ट्रैकिंग पिंग को भी मैनेज करता है. साथ ही, स्ट्रीम और विज्ञापन इवेंट को पब्लिशर को भेजता है.
ज़रूरी शर्तें
शुरू करने से पहले, आपके पास ये चीज़ें होनी चाहिए:
- Xcode 13 या उसके बाद का वर्शन
- IMA SDK इंस्टॉल करने का तरीका:
- Swift Package Manager (सुझाया गया)
- iOS के लिए IMA SDK टूल की डाउनलोड की गई कॉपी
आपको IMA SDK से स्ट्रीम का अनुरोध करने के लिए, पैरामीटर की भी ज़रूरत होती है. अनुरोध के पैरामीटर के उदाहरणों के लिए, सैंपल स्ट्रीम देखें.
| लाइव स्ट्रीम के पैरामीटर | |
|---|---|
| ऐसेट की |
ऐसेट की
Google Ad Manager में आपकी लाइव स्ट्रीम की पहचान करती है. उदाहरण: c-rArva4ShKVIAkNfy6HUQ
|
| वीओडी स्ट्रीम के पैरामीटर | |
| कॉन्टेंट सोर्स आईडी |
Google Ad Manager से मिला
कॉन्टेंट सोर्स
आईडी. उदाहरण: 2548831
|
| वीडियो का आईडी |
Google Ad Manager से मिला वीडियो का आईडी. उदाहरण: tears-of-steel
|
| सामान्य पैरामीटर (वीओडी और लाइव स्ट्रीम) | |
| नेटवर्क कोड |
आपका Google Ad Manager नेटवर्क कोड. उदाहरण: 21775744923
|
नया Xcode प्रोजेक्ट बनाना
Xcode में, Objective-C का इस्तेमाल करके "BasicExample" नाम का नया iOS प्रोजेक्ट बनाएं.
Xcode प्रोजेक्ट में आईएमए डीएआई एसडीके जोड़ना
IMA SDK इंस्टॉल करने के लिए, अपनी पसंद का तरीका चुनें.
सुझाया गया: Swift Package Manager का इस्तेमाल करके एसडीके इंस्टॉल करें
Interactive Media Ads SDK, Swift Package Manager के साथ काम करता है. इसके लिए, SDK का वर्शन 3.18.4 या उसके बाद का वर्शन होना ज़रूरी है. Swift पैकेज इंपोर्ट करने के लिए, यह तरीका अपनाएं.
Xcode में, आईएमए डीएआई एसडीके Swift Package इंस्टॉल करें: इसके लिए, File > Add Packages पर जाएं.
दिखने वाले प्रॉम्प्ट में, आईएमए डीएआई एसडीके स्विफ्ट पैकेज GitHub रिपॉज़िटरी खोजें:
https://github.com/googleads/swift-package-manager-google-interactive-media-ads-iosIMA DAI SDK के Swift पैकेज का वह वर्शन चुनें जिसका आपको इस्तेमाल करना है. नए प्रोजेक्ट के लिए, Up to Next Major Version का इस्तेमाल करें.
इसके बाद, Xcode आपके पैकेज की डिपेंडेंसी से जुड़ी समस्या को हल कर देगा और उन्हें बैकग्राउंड में डाउनलोड करेगा. पैकेज डिपेंडेंसी जोड़ने के तरीके के बारे में ज़्यादा जानने के लिए, Apple का लेख पढ़ें.
एसडीके को मैन्युअल तरीके से डाउनलोड और इंस्टॉल करना
अगर आपको Swift Package Manager का इस्तेमाल नहीं करना है, तो IMA SDK को डाउनलोड करें और अपने प्रोजेक्ट में मैन्युअल तरीके से जोड़ें.
वीडियो प्लेयर बनाना
अपने मुख्य व्यू कंट्रोलर में वीडियो प्लेयर लागू करें; AV प्लेयर को यूज़र इंटरफ़ेस व्यू में रैप करें. IMA SDK, विज्ञापन दिखाने के लिए यूज़र इंटरफ़ेस (यूआई) व्यू का इस्तेमाल करता है.
Objective-C
Swift
विज्ञापन लोडर को शुरू करना
अपने व्यू कंट्रोलर में IMA SDK इंपोर्ट करें. साथ ही, विज्ञापन लोडर और स्ट्रीम मैनेजर इवेंट को मैनेज करने के लिए, IMAAdsLoaderDelegate और IMAStreamManagerDelegate प्रोटोकॉल अपनाएं.
IMA SDK के मुख्य कॉम्पोनेंट सेव करने के लिए, इन निजी प्रॉपर्टी को जोड़ें:
IMAAdsLoader- यह कुकी, आपके ऐप्लिकेशन के पूरे जीवनकाल में स्ट्रीम के अनुरोधों को मैनेज करती है.
IMAAdDisplayContainer- यह कुकी, विज्ञापन के यूज़र इंटरफ़ेस एलिमेंट को डालने और मैनेज करने का काम करती है.
IMAAVPlayerVideoDisplay- यह IMA SDK और आपके मीडिया प्लेयर के बीच कम्यूनिकेट करता है. साथ ही, टाइम किए गए मेटाडेटा को मैनेज करता है.IMAStreamManager- यह स्ट्रीम के प्लेबैक को मैनेज करता है और विज्ञापन से जुड़े इवेंट ट्रिगर करता है.
व्यू लोड होने के बाद, विज्ञापन लोडर, विज्ञापन दिखाने वाला कंटेनर, और वीडियो डिसप्ले को शुरू करें.
Objective-C
Swift
स्ट्रीम करने का अनुरोध करना
जब कोई उपयोगकर्ता 'चलाएं' बटन दबाता है, तब स्ट्रीम करने का नया अनुरोध करें.
लाइव स्ट्रीम के लिए, IMALiveStreamRequest क्लास का इस्तेमाल करें. वीओडी स्ट्रीम के लिए, IMAVODStreamRequest क्लास का इस्तेमाल करें.
स्ट्रीम के अनुरोध के लिए, आपके स्ट्रीम पैरामीटर के साथ-साथ विज्ञापन दिखाने वाले कंटेनर और वीडियो डिसप्ले का रेफ़रंस भी ज़रूरी है.
Objective-C
Swift
स्ट्रीम लोड होने से जुड़े इवेंट सुनने की अनुमति
IMAAdsLoader क्लास, स्ट्रीम के अनुरोध के शुरू होने या न होने पर IMAAdsLoaderDelegate तरीकों को कॉल करता है.
adsLoadedWithData
डेलिगेट तरीके में, अपना
IMAStreamManagerDelegate सेट करें.
स्ट्रीम मैनेजर को शुरू करें. शुरू होने पर, स्ट्रीम मैनेजर वीडियो चलाना शुरू कर देता है.
failedWithErrorData डेलिगेट तरीके में, गड़बड़ी को लॉग करें. इसके अलावा, बैकअप स्ट्रीम को चलाया जा सकता है. DAI इस्तेमाल करने के सबसे सही तरीके देखें.
Objective-C
Swift
विज्ञापन इवेंट सुनने की अनुमति
IMAStreamManager, आपके ऐप्लिकेशन को स्ट्रीम इवेंट और गड़बड़ियां पास करने के लिए IMAStreamManagerDelegate तरीकों का इस्तेमाल करता है.
इस उदाहरण के लिए, मुख्य विज्ञापन इवेंट को कंसोल में लॉग करें:
Objective-C
Swift
अपना ऐप्लिकेशन चलाएं. अगर यह काम करता है, तो IMA SDK की मदद से Google डीएआई स्ट्रीम का अनुरोध करें और उन्हें चलाएं. SDK टूल की अन्य ऐडवांस सुविधाओं के बारे में जानने के लिए, बाईं ओर मौजूद साइडबार में दी गई अन्य गाइड देखें या GitHub पर मौजूद सैंपल देखें.