IMA SDK की मदद से, अपनी वेबसाइटों और ऐप्लिकेशन में मल्टीमीडिया विज्ञापन आसानी से इंटिग्रेट किए जा सकते हैं. IMA SDK, VAST के साथ काम करने वाले किसी भी विज्ञापन सर्वर से विज्ञापनों का अनुरोध कर सकते हैं. साथ ही, आपके ऐप्लिकेशन में विज्ञापन चलाने की सुविधा को मैनेज कर सकते हैं. IMA DAI SDK की मदद से, ऐप्लिकेशन विज्ञापन और कॉन्टेंट वीडियो के लिए स्ट्रीम का अनुरोध करते हैं. यह अनुरोध, वीओडी या लाइव कॉन्टेंट के लिए किया जाता है. इसके बाद, SDK टूल एक साथ वीडियो स्ट्रीम दिखाता है, ताकि आपको अपने ऐप्लिकेशन में विज्ञापन और कॉन्टेंट वीडियो के बीच स्विच करने की ज़रूरत न पड़े.
वह DAI समाधान चुनें जिसमें आपकी दिलचस्पी है
डीएआई की पूरी सेवा
इस गाइड में, IMA DAI SDK टूल को किसी सामान्य वीडियो प्लेयर ऐप्लिकेशन में इंटिग्रेट करने का तरीका बताया गया है. अगर आपको इंटिग्रेशन का पूरा सैंपल देखना है या साथ-साथ इंटिग्रेट करना है, तो GitHub से BasicExample डाउनलोड करें.
IMA DAI के बारे में खास जानकारी
IMA DAI को लागू करने के लिए, चार मुख्य एसडीके कॉम्पोनेंट का इस्तेमाल किया जाता है. इनके बारे में इस गाइड में बताया गया है:
IMAAdDisplayContainer
– यह एक कंटेनर ऑब्जेक्ट है, जो वीडियो प्लेबैक एलिमेंट के ऊपर होता है. इसमें विज्ञापन के यूज़र इंटरफ़ेस (यूआई) एलिमेंट होते हैं.IMAAdsLoader
– यह एक ऐसा ऑब्जेक्ट है जो स्ट्रीम का अनुरोध करता है और स्ट्रीम के अनुरोध के रिस्पॉन्स ऑब्जेक्ट से ट्रिगर होने वाले इवेंट को हैंडल करता है. आपको सिर्फ़ एक विज्ञापन लोडर को इंस्टैंशिएट करना चाहिए. इसका इस्तेमाल पूरे ऐप्लिकेशन में किया जा सकता है.IMAStreamRequest
–IMAVODStreamRequest
याIMALiveStreamRequest
. यह ऑब्जेक्ट, स्ट्रीम के अनुरोध के बारे में बताता है. स्ट्रीम करने के अनुरोध, वीडियो ऑन डिमांड या लाइव स्ट्रीम के लिए किए जा सकते हैं. लाइव स्ट्रीम के अनुरोधों में, ऐसेट की के बारे में बताया जाता है. वहीं, वीडियो ऑन डिमांड के अनुरोधों में, सीएमएस आईडी और वीडियो आईडी के बारे में बताया जाता है. दोनों तरह के अनुरोधों में, एपीआई कुंजी शामिल की जा सकती है. इसकी ज़रूरत, तय की गई स्ट्रीम को ऐक्सेस करने के लिए होती है. साथ ही, इसमें Google Ad Manager नेटवर्क कोड भी शामिल किया जा सकता है, ताकि IMA SDK, Google Ad Manager की सेटिंग में बताए गए विज्ञापन आइडेंटिफ़ायर को मैनेज कर सके.IMAStreamManager
– यह एक ऐसा ऑब्जेक्ट है जो डाइनैमिक ऐड इंसर्शन वाली स्ट्रीम और डीएआई बैकएंड के साथ इंटरैक्शन को मैनेज करता है. स्ट्रीम मैनेजर, ट्रैकिंग पिंग को भी मैनेज करता है. साथ ही, स्ट्रीम और विज्ञापन इवेंट को पब्लिशर को भेजता है.
ज़रूरी शर्तें
शुरू करने से पहले, आपके पास ये चीज़ें होनी चाहिए:
- Xcode 13 या इसके बाद का वर्शन
- CocoaPods (सुझाया गया), 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 प्रोजेक्ट बनाएं.
IMA DAI SDK को Xcode प्रोजेक्ट में जोड़ना
IMA DAI SDK इंस्टॉल करने के लिए, इनमें से किसी एक तरीके का इस्तेमाल करें.
CocoaPods का इस्तेमाल करके एसडीके इंस्टॉल करना (सुझाया गया)
CocoaPods, Xcode प्रोजेक्ट के लिए डिपेंडेंसी मैनेजर है. साथ ही, IMA DAI SDK टूल को इंस्टॉल करने के लिए, इस तरीके का इस्तेमाल करने का सुझाव दिया जाता है. CocoaPods को इंस्टॉल करने या इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, CocoaPods का दस्तावेज़ देखें. CocoaPods इंस्टॉल करने के बाद, IMA DAI SDK इंस्टॉल करने के लिए यहां दिए गए निर्देशों का पालन करें:
अपनी BasicExample.xcodeproj फ़ाइल वाली डायरेक्ट्री में, Podfile नाम की टेक्स्ट फ़ाइल बनाएं और यह कॉन्फ़िगरेशन जोड़ें:
Podfile वाले डायरेक्ट्री से, यह कमांड चलाएं:
pod install --repo-update
Swift Package Manager का इस्तेमाल करके एसडीके इंस्टॉल करना
Interactive Media Ads SDK, Swift Package Manager के साथ काम करता है. इसके लिए, SDK का वर्शन 3.18.4 या उसके बाद का वर्शन होना ज़रूरी है. Swift पैकेज इंपोर्ट करने के लिए, यह तरीका अपनाएं.
Xcode में, IMA DAI SDK Swift Package इंस्टॉल करें. इसके लिए, File > Add Packages पर जाएं.
दिखने वाले प्रॉम्प्ट में, IMA DAI SDK Swift Package GitHub repository खोजें:
https://github.com/googleads/swift-package-manager-google-interactive-media-ads-ios
IMA DAI SDK के Swift पैकेज का वह वर्शन चुनें जिसका आपको इस्तेमाल करना है. नए प्रोजेक्ट के लिए, हमारा सुझाव है कि अगले मुख्य वर्शन तक का इस्तेमाल करें.
इसके बाद, Xcode आपके पैकेज की डिपेंडेंसी से जुड़ी समस्या को हल करता है और उन्हें बैकग्राउंड में डाउनलोड करता है. पैकेज डिपेंडेंसी जोड़ने के बारे में ज़्यादा जानने के लिए, Apple का लेख पढ़ें.
एसडीके को मैन्युअल तरीके से डाउनलोड और इंस्टॉल करना
अगर आपको Swift Package Manager या CocoaPods का इस्तेमाल नहीं करना है, तो IMA DAI 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 DAI स्ट्रीम का अनुरोध किया जा सकता है और उन्हें चलाया जा सकता है. SDK टूल की अन्य बेहतर सुविधाओं के बारे में जानने के लिए, बाईं ओर मौजूद साइडबार में दी गई अन्य गाइड देखें या GitHub पर मौजूद सैंपल देखें.