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– यह एक ऐसा ऑब्जेक्ट है जो डाइनैमिक ऐड इंसर्शन (डीएआई) की स्ट्रीम और डीएआई बैकएंड के साथ इंटरैक्शन को मैनेज करता है. स्ट्रीम मैनेजर, ट्रैकिंग पिंग को भी मैनेज करता है. साथ ही, स्ट्रीम और विज्ञापन इवेंट को पब्लिशर को भेजता है.
ज़रूरी शर्तें
शुरू करने से पहले, आपके पास ये चीज़ें होनी चाहिए:
- Xcode 13 या इसके बाद का वर्शन
- IMA SDK इंस्टॉल करने का तरीका:
- Swift Package Manager (सुझाया गया)
- CocoaPods
- 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 का लेख पढ़ें.
CocoaPods का इस्तेमाल करके आईएमए डीएआई एसडीके इंस्टॉल करना
CocoaPods, Xcode प्रोजेक्ट के लिए डिपेंडेंसी मैनेजर है. इसका इस्तेमाल IMA डीएआई एसडीके इंस्टॉल करने के लिए किया जाता है. CocoaPods को इंस्टॉल करने या इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, CocoaPods का दस्तावेज़ देखें. CocoaPods इंस्टॉल करने के बाद, IMA DAI SDK इंस्टॉल करने के लिए इन निर्देशों का पालन करें:
अपनी BasicExample.xcodeproj फ़ाइल वाली डायरेक्ट्री में, Podfile नाम की टेक्स्ट फ़ाइल बनाएं और यह कॉन्फ़िगरेशन जोड़ें:
Podfile वाली डायरेक्ट्री से, यह कमांड चलाएं:
pod install --repo-update
एसडीके को मैन्युअल तरीके से डाउनलोड और इंस्टॉल करना
अगर आपको Swift Package Manager का इस्तेमाल नहीं करना है, तो IMA SDK को डाउनलोड करें और अपने प्रोजेक्ट में मैन्युअल तरीके से जोड़ें.
एक आसान वीडियो प्लेयर बनाना
अपने मुख्य व्यू कंट्रोलर में एक वीडियो प्लेयर लागू करें; एक AV प्लेयर को UI व्यू में रैप करें. 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 पर मौजूद सैंपल देखें.