IMA SDK की मदद से, अपनी वेबसाइटों और ऐप्लिकेशन में मल्टीमीडिया विज्ञापन आसानी से इंटिग्रेट किए जा सकते हैं. IMA SDK, वीएएसटी के साथ काम करने वाले किसी भी विज्ञापन सर्वर से विज्ञापनों का अनुरोध कर सकते हैं. साथ ही, आपके ऐप्लिकेशन में विज्ञापन दिखाने की सुविधा को मैनेज कर सकते हैं. IMA DAI SDK की मदद से, ऐप्लिकेशन विज्ञापन और कॉन्टेंट वीडियो के लिए स्ट्रीम का अनुरोध करते हैं. यह कॉन्टेंट, वीओडी या लाइव कॉन्टेंट हो सकता है. इसके बाद, SDK टूल एक साथ वीडियो स्ट्रीम दिखाता है, ताकि आपको अपने ऐप्लिकेशन में विज्ञापन और कॉन्टेंट वीडियो के बीच स्विच करने की ज़रूरत न पड़े.
डीएआई का वह समाधान चुनें जिसमें आपकी दिलचस्पी है
डीएआई की पूरी सेवा
इस गाइड में, आईएमए डीएआई एसडीके को किसी सामान्य वीडियो प्लेयर ऐप्लिकेशन में इंटिग्रेट करने का तरीका बताया गया है. अगर आपको इंटिग्रेशन का पूरा सैंपल देखना है या साथ-साथ इंटिग्रेट करना है, तो GitHub से BasicExample डाउनलोड करें.
आईएमए डीएआई की खास जानकारी
आईएमए डीएआई को लागू करने के लिए, एसडीके के चार मुख्य कॉम्पोनेंट का इस्तेमाल किया जाता है. इनके बारे में इस गाइड में बताया गया है:
StreamDisplayContainer: यह एक कंटेनर ऑब्जेक्ट है, जो वीडियो चलाने वाले एलिमेंट के ऊपर दिखता है. इसमें विज्ञापन के यूज़र इंटरफ़ेस (यूआई) वाले एलिमेंट शामिल होते हैं.AdsLoader: यह ऐसा ऑब्जेक्ट है जो स्ट्रीम का अनुरोध करता है और स्ट्रीम के अनुरोध के जवाब वाले ऑब्जेक्ट से ट्रिगर होने वाले इवेंट को मैनेज करता है. आपको सिर्फ़ एक विज्ञापन लोडर को इंस्टैंशिएट करना चाहिए. इसका इस्तेमाल पूरे ऐप्लिकेशन में किया जा सकता है.StreamRequest: यह एक ऐसा ऑब्जेक्ट है जो स्ट्रीम के अनुरोध के बारे में बताता है. स्ट्रीम के अनुरोध, वीडियो-ऑन-डिमांड या लाइव स्ट्रीम के लिए किए जा सकते हैं. लाइव स्ट्रीम के अनुरोधों में ऐसेट कुंजी के बारे में बताया जाता है. वहीं, वीओडी के अनुरोधों में सीएमएस आईडी और वीडियो आईडी के बारे में बताया जाता है. दोनों तरह के अनुरोधों में, एपीआई पासकोड शामिल किया जा सकता है. इसकी ज़रूरत, चुनी गई स्ट्रीम को ऐक्सेस करने के लिए होती है. साथ ही, Google Ad Manager नेटवर्क कोड भी शामिल किया जा सकता है. इसकी ज़रूरत, IMA SDK को विज्ञापन आइडेंटिफ़ायर मैनेज करने के लिए होती है. ये आइडेंटिफ़ायर, Google Ad Manager की सेटिंग में तय किए जाते हैं.StreamManager: यह एक ऐसा ऑब्जेक्ट है जो डाइनैमिक ऐड इंसर्शन वाली स्ट्रीम और DAI बैकएंड के साथ इंटरैक्शन को मैनेज करता है. स्ट्रीम मैनेजर, ट्रैकिंग पिंग को भी मैनेज करता है. साथ ही, स्ट्रीम और विज्ञापन इवेंट को पब्लिशर को भेजता है.
ज़रूरी शर्तें
- Android Studio
- एसडीके इंटिग्रेशन के लिए वीडियो प्लेयर ऐप्लिकेशन का सैंपल
सैंपल वीडियो प्लेयर ऐप्लिकेशन डाउनलोड और चलाएं
सैंपल के तौर पर मिले ऐप्लिकेशन में, काम करने वाला एक वीडियो प्लेयर दिया गया है. यह एचएलएस वीडियो चलाता है. IMA डीएआई एसडीके की डीएआई सुविधाओं को इंटिग्रेट करने के लिए, इसे शुरुआती पॉइंट के तौर पर इस्तेमाल करें.
सैंपल वीडियो प्लेयर ऐप्लिकेशन डाउनलोड करें और इसे एक्सट्रैक्ट करें.
Android Studio शुरू करें और कोई मौजूदा Android Studio प्रोजेक्ट खोलें को चुनें. अगर Android Studio पहले से चल रहा है, तो फ़ाइल > नया > प्रोजेक्ट इंपोर्ट करें को चुनें. इसके बाद,
SampleVideoPlayer/build.gradleको चुनें.Tools > Android > Sync Project with Gradle Files को चुनकर, Gradle सिंक करें.
पक्का करें कि प्लेयर ऐप्लिकेशन, Android डिवाइस या Android वर्चुअल डिवाइस पर कंपाइल और चल रहा हो. इसके लिए, Run > Run 'app' का इस्तेमाल करें. वीडियो स्ट्रीम को चलने से पहले लोड होने में कुछ समय लग सकता है.
सैंपल वीडियो प्लेयर की जांच करना
सैंपल वीडियो प्लेयर में, IMA डीएआई एसडीके इंटिग्रेशन कोड अभी तक शामिल नहीं किया गया है. सैंपल के तौर पर मिले ऐप्लिकेशन में दो मुख्य हिस्से होते हैं:
samplevideoplayer/SampleVideoPlayer.java: यह ExoPlayer पर आधारित एचएलएस प्लेयर है. यह आईएमए डीएआई इंटिग्रेशन के लिए आधार का काम करता है.videoplayerapp/MyActivity.java: इस गतिविधि से वीडियो प्लेयर बनता है और इसेContextऔरmedia3.ui.PlayerViewपास किया जाता है.
प्लेयर ऐप्लिकेशन में आईएमए डीएआई एसडीके जोड़ना
आपको IMA डीएआई एसडीके का रेफ़रंस भी शामिल करना होगा. Android Studio में, अपने ऐप्लिकेशन-लेवल की build.gradle फ़ाइल में यहां दिया गया कोड जोड़ें. यह फ़ाइल app/build.gradle में मौजूद होती है. IMA SDK के लिए, लाइब्रेरी डिसुगरिंग की सुविधा चालू होनी चाहिए. इसके लिए, आपको coreLibraryDesugaringEnabled true सेट करना होगा और build.gradle फ़ाइल में 'com.android.tools:desugar_jdk_libs' को डिपेंडेंसी के तौर पर जोड़ना होगा. ज़्यादा जानकारी के लिए, nio स्पेसिफ़िकेशन के साथ डिसुगरिंग के ज़रिए उपलब्ध Java 11+ API देखें.
आईएमए डीएआई एसडीके को इंटिग्रेट करना
videoplayerappपैकेज (app/java/com.google.ads.interactivemedia.v3.samples/videoplayerapp/में) मेंSampleAdsWrapperनाम की एक नई क्लास बनाएं, ताकि मौजूदाSampleVideoPlayerको रैप किया जा सके. साथ ही, IMA DAI को लागू करने वाला लॉजिक जोड़ा जा सके. इसके लिए, आपको सबसे पहले एकAdsLoaderबनाना होगा. इसका इस्तेमाल, डीएआई स्ट्रीम का अनुरोध करने के लिए किया जाता है.इस स्निपेट में, लाइव और वीओडी स्ट्रीम के लिए, HLS और DASH के सैंपल पैरामीटर शामिल हैं. यह सेट करने के लिए कि कौनसी स्ट्रीम चलाई जा रही है,
CONTENT_TYPEवैरिएबल को अपडेट करें.createSampleVideoPlayerCallback()हेल्पर मेथड बनाएं, ताकिSampleVideoPlayerCallbackइंटरफ़ेस का ऐसा इंस्टेंस बनाया जा सके जोVideoStreamPlayer.VideoStreamPlayerCallbackको बढ़ाता है.डीएआई के साथ काम करने के लिए, प्लेयर को IMA डीएआई एसडीके को आईडी3 इवेंट पास करने होंगे. नीचे दिए गए सैंपल कोड में,
callback.onUserTextReceived()तरीके का इस्तेमाल करके ऐसा किया गया है.SteamRequestबनाने के लिए,buildStreamRequest()जोड़ें. यह तरीका,CONTENT_TYPEवैरिएबल को सेट करने के तरीके के आधार पर, अलग-अलग स्ट्रीम के बीच स्विच करता है. इस गाइड में इस्तेमाल की गई डिफ़ॉल्ट स्ट्रीम, IMA की सैंपल वीओडी एचएलएस स्ट्रीम है.स्ट्रीम चलाने के लिए, आपको
VideoStreamPlayerकी भी ज़रूरत होगी. इसलिए,createVideoStreamPlayer()तरीका जोड़ें. यह एक ऐसी एनॉनिमस क्लास बनाता है जोVideoStreamPlayerको लागू करती है.ज़रूरी लिसनर लागू करें और गड़बड़ी की जानकारी देने की सुविधा जोड़ें.
AdErrorListenerको लागू करने के तरीके पर ध्यान दें, क्योंकि अगर विज्ञापन नहीं चलते हैं, तो यह फ़ॉलबैक यूआरएल को कॉल करता है. कॉन्टेंट और विज्ञापन एक ही स्ट्रीम में होते हैं. इसलिए, अगर डीएआई स्ट्रीम में कोई गड़बड़ी होती है, तो आपको फ़ॉलबैक स्ट्रीम को कॉल करने के लिए तैयार रहना होगा.लॉगिंग के लिए कोड जोड़ें.
SampleAdsWrapperको इंस्टैंशिएट और कॉल करने के लिए,videoplayerappमेंMyActivityमें बदलाव करें. इसके अलावा,ImaSdkSettingsइंस्टेंस बनाने के लिए, हेल्पर तरीके का इस्तेमाल करकेImaSdkFactory.initialize()को कॉल करें.ImaSdkSettingsइंस्टेंस बनाने के लिए,getImaSdkSettings()हेल्पर मेथड जोड़ें.लॉगिंग के लिए यूज़र इंटरफ़ेस (यूआई) एलिमेंट जोड़ने के लिए, गतिविधि की लेआउट फ़ाइल
activity_my.xmlमें बदलाव करें.
बधाई हो! अब आपके Android ऐप्लिकेशन में वीडियो विज्ञापनों का अनुरोध किया जा रहा है और उन्हें दिखाया जा रहा है. इसे बेहतर तरीके से लागू करने के लिए, बुकमार्क, स्नैपबैक, और एपीआई के दस्तावेज़ देखें.
समस्या का हल
अगर आपको वीडियो विज्ञापन चलाने में समस्या आ रही है, तो पूरा BasicExample डाउनलोड करके देखें. अगर यह BasicExample में ठीक से काम करता है, तो हो सकता है कि आपके ऐप्लिकेशन के IMA इंटिग्रेशन कोड में कोई समस्या हो.
अगर आपको अब भी समस्याएं आ रही हैं, तो IMA SDK फ़ोरम पर जाएं.