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