Moloco को मीडिएशन के साथ इंटिग्रेट करना

प्लैटफ़ॉर्म चुनें: Android (बीटा)

इस गाइड में बताया गया है कि Google Mobile Ads SDK का इस्तेमाल करके, AdMob मीडिएशन के ज़रिए Moloco से विज्ञापन लोड करने और दिखाने का तरीका क्या है. इसमें बिडिंग इंटिग्रेशन भी शामिल है. इसमें विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में Moloco जोड़ने और Android ऐप्लिकेशन में Moloco SDK और अडैप्टर को इंटिग्रेट करने का तरीका बताया गया है.

इस्तेमाल किए जा सकने वाले इंटिग्रेशन और विज्ञापन फ़ॉर्मैट

Moloco के लिए मीडिएशन अडैप्टर में ये सुविधाएं उपलब्ध हैं:

इंटिग्रेशन
बिडिंग
वॉटरफ़ॉल
फ़ॉर्मैट
ऐप का खुलना
बैनर
इंटरस्टीशियल विज्ञापन
इनाम दिया गया
इनाम वाला इंटरस्टीशियल
नेटिव विज्ञापन

ज़रूरी शर्तें

Android का एपीआई लेवल 23 या इसके बाद का वर्शन
Moloco अडैप्टर 3.8.0.0 या इसके बाद का वर्शन

Google Mobile Ads SDK पर अपलोड हुआ नया वीडियो
मीडिएशन की प्रोसेस पूरी करने के शुरुआती निर्देश देखें.

पहला चरण: Moloco के यूआई में कॉन्फ़िगरेशन सेट अप करना

Moloco Publisher Portal में Log in करें.

खास जानकारी > ऐप्लिकेशन टैब पर जाएं. इसके बाद, नया ऐप्लिकेशन बनाने के लिए, ऐप्लिकेशन जोड़ें बटन पर क्लिक करें.

अपने ऐप्लिकेशन के लिए ओएस और निजता सेटिंग चुनें. इसके बाद, फ़ॉर्म में बाकी जानकारी भरें और बनाएं पर क्लिक करें.

ऐप्लिकेशन बन जाने के बाद, ऐप्लिकेशन टैब में जाकर उसे चुनें. इसके बाद, उसकी जानकारी देखें और ऐप्लिकेशन का पासकोड नोट करें.

खास जानकारी > विज्ञापन यूनिट टैब पर जाएं. इसके बाद, ड्रॉप-डाउन मेन्यू से ऐप्लिकेशन चुनें और नई विज्ञापन यूनिट पर क्लिक करें.

नीलामी का तरीका के तौर पर इन-ऐप्लिकेशन बिडिंग को चुनें और बाकी फ़ॉर्म भरें. इसके बाद, बनाएं पर क्लिक करें.

विज्ञापन यूनिट की जानकारी देखने के लिए, विज्ञापन यूनिट टैब में जाकर, नई विज्ञापन यूनिट पर जाएं. विज्ञापन यूनिट आईडी को नोट करें.

दूसरा चरण: AdMob के यूआई में Moloco की डिमांड सेट अप करना

अपनी विज्ञापन यूनिट के लिए मीडिएशन की सेटिंग कॉन्फ़िगर करना

आपको अपनी विज्ञापन यूनिट के लिए, मीडिएशन कॉन्फ़िगरेशन में Moloco Ads SDK जोड़ना होगा.

सबसे पहले, अपने AdMob खाते में साइन इन करें. इसके बाद, मीडिएशन टैब पर जाएं. अगर आपको किसी मौजूदा मीडिएशन ग्रुप में बदलाव करना है, तो उस मीडिएशन ग्रुप के नाम पर क्लिक करके उसमें बदलाव करें. इसके बाद, Moloco Ads SDK को विज्ञापन सोर्स के तौर पर जोड़ें पर जाएं.

नया मीडिएशन ग्रुप बनाने के लिए, मीडिएशन ग्रुप बनाएं को चुनें.

विज्ञापन फ़ॉर्मैट और प्लैटफ़ॉर्म की जानकारी डालें. इसके बाद, जारी रखें पर क्लिक करें.

अपने मीडिएशन ग्रुप को कोई नाम दें और टारगेट करने के लिए जगहें चुनें. इसके बाद, मीडिएशन ग्रुप की स्थिति को चालू है पर सेट करें. फिर, विज्ञापन यूनिट जोड़ें पर क्लिक करें.

इस मीडिएशन ग्रुप को अपनी मौजूदा AdMob विज्ञापन यूनिट में से एक या इससे ज़्यादा विज्ञापन यूनिट से जोड़ें. इसके बाद, हो गया पर क्लिक करें.

अब आपको विज्ञापन यूनिट का कार्ड दिखेगा. इसमें आपको वे विज्ञापन यूनिट दिखेंगी जिन्हें आपने चुना था:

Moloco Ads SDK को विज्ञापन सोर्स के तौर पर जोड़ना

विज्ञापन सोर्स सेक्शन में मौजूद बिडिंग कार्ड में जाकर, विज्ञापन सोर्स जोड़ें को चुनें. इसके बाद, Moloco Ads SDK को चुनें.

पार्टनरशिप के कानूनी समझौते पर हस्ताक्षर करने का तरीका पर क्लिक करें और Moloco Ads SDK के साथ बिडिंग पार्टनरशिप सेट अप करें.

स्वीकार करें और सहमति दें पर क्लिक करें. इसके बाद, जारी रखें पर क्लिक करें.

अगर आपने Moloco Ads SDK को पहले से विज्ञापन सोर्स के तौर पर जोड़ा हुआ है, तो उसे चुना जा सकता है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें पर क्लिक करें.

इसके बाद, पिछले सेक्शन में मिली ऐप्लिकेशन की कुंजी और विज्ञापन यूनिट आईडी डालें. इसके बाद, हो गया पर क्लिक करें.

Moloco Ads को यूरोप और अमेरिका के राज्यों में लागू कानूनों के तहत विज्ञापन पार्टनरों की सूची में जोड़ना

AdMob के यूज़र इंटरफ़ेस (यूआई) में, यूरोप और अमेरिका के राज्यों के कानूनों के तहत विज्ञापन पार्टनर की सूची में Moloco Ads को जोड़ने के लिए, यहां दिया गया तरीका अपनाएं: यूरोपीय कानूनों की सेटिंग और अमेरिका के राज्यों के कानूनों की सेटिंग

तीसरा चरण: Moloco SDK और अडैप्टर को इंपोर्ट करना

Android Studio इंटिग्रेशन (सुझाया गया)

अपने ऐप्लिकेशन-लेवल की build.gradle.kts फ़ाइल में, ये डिपेंडेंसी और कॉन्फ़िगरेशन जोड़ें. Moloco SDK टूल और अडैप्टर के नए वर्शन का इस्तेमाल करें:

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.9.0")
    implementation("com.google.ads.mediation:moloco:4.5.0.0")
}

चौथा चरण: Moloco SDK पर निजता सेटिंग लागू करना

ईयू उपयोगकर्ता की सहमति से जुड़ी नीति और जीडीपीआर

Google की ईयू उपयोगकर्ता की सहमति से जुड़ी नीति का पालन करने के लिए, आपको यूरोपियन इकनॉमिक एरिया (ईईए), यूके, और स्विट्ज़रलैंड में मौजूद उपयोगकर्ताओं को कुछ जानकारी देनी होगी. साथ ही, आपको कानूनी तौर पर ज़रूरी होने पर, कुकी या अन्य लोकल स्टोरेज का इस्तेमाल करने के लिए उनकी सहमति लेनी होगी. इसके अलावा, आपको विज्ञापन को ज़्यादा काम का बनाने के लिए, निजी डेटा को इकट्ठा करने, शेयर करने, और इस्तेमाल करने के लिए भी उनकी सहमति लेनी होगी. इस नीति में, ईयू के ई-निजता निर्देश और जनरल डेटा प्रोटेक्शन रेगुलेशन (जीडीपीआर) की ज़रूरी शर्तों के बारे में बताया गया है. यह आपकी ज़िम्मेदारी है कि सहमति की जानकारी, आपकी मीडिएशन चेन में मौजूद हर विज्ञापन सोर्स को भेजी जाए. Google, उपयोगकर्ता की सहमति के विकल्प को ऐसे नेटवर्क पर अपने-आप नहीं भेज सकता.

Moloco SDK में, Moloco SDK को सहमति की जानकारी देने के लिए isUserConsent फ़्लैग शामिल होता है.

यहां दिए गए सैंपल कोड में, Moloco SDK को सहमति की जानकारी देने का तरीका बताया गया है. अगर आपको इन फ़्लैग को सेट करना है, तो हमारा सुझाव है कि आप Google Mobile Ads SDK के ज़रिए विज्ञापनों का अनुरोध करने से पहले ऐसा करें.

Kotlin

import com.moloco.sdk.publisher.privacy.MolocoPrivacy
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings
// ...

val privacySettings = PrivacySettings(isUserConsent = true)
MolocoPrivacy.setPrivacy(privacySettings)

Java

import com.moloco.sdk.publisher.privacy.MolocoPrivacy;
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings;
// ...

// Moloco does not support setting one flag at a time in Java.
PrivacySettings privacySettings = new PrivacySettings(
    /* isUserConsent */         true,
    /* isAgeRestrictedUser */   false,
    /* isDoNotSell */           false);
MolocoPrivacy.setPrivacy(privacySettings);

ज़्यादा जानकारी के लिए, Moloco SDK Android का दस्तावेज़ देखें.

अमेरिका के राज्यों के निजता कानून

अमेरिका के राज्यों के निजता कानूनों के मुताबिक, उपयोगकर्ताओं को अपनी "निजी जानकारी" (जैसा कि कानून में परिभाषित है) की "बिक्री" से ऑप्ट आउट करने का अधिकार मिलना चाहिए. ऑप्ट आउट का विकल्प देने के लिए, "बिक्री करने वाले" पक्ष को अपने होम पेज पर "मेरी निजी जानकारी न बेचें" का लिंक प्रमुखता से दिखाना होगा. अमेरिका के राज्यों के निजता कानूनों का पालन करने से जुड़ी गाइड में, Google के विज्ञापन दिखाने के लिए सीमित डेटा प्रोसेसिंग मोड को चालू करने की सुविधा मिलती है. हालांकि, Google आपकी मीडिएशन चेन में मौजूद हर विज्ञापन नेटवर्क पर इस सेटिंग को लागू नहीं कर सकता. इसलिए, आपको मीडिएशन चेन में मौजूद हर उस विज्ञापन नेटवर्क कंपनी की पहचान करनी होगी जो निजी जानकारी की बिक्री में हिस्सा ले सकती है. साथ ही, आपको यह पक्का करने के लिए कि निजता कानून का पालन किया जा रहा है, उन सभी नेटवर्क से मिले दिशा-निर्देशों का पालन करना होगा.

Moloco SDK में isDoNotSell फ़्लैग शामिल होता है. इसका इस्तेमाल, Moloco SDK को सहमति की जानकारी देने के लिए किया जाता है.

Kotlin

import com.moloco.sdk.publisher.privacy.MolocoPrivacy
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings
// ...

val privacySettings = PrivacySettings(isDoNotSell = true)
MolocoPrivacy.setPrivacy(privacySettings)

Java

import com.moloco.sdk.publisher.privacy.MolocoPrivacy;
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings;
// ...

// Moloco does not support setting one flag at a time in Java.
PrivacySettings privacySettings = new PrivacySettings(
    /* isUserConsent */         false,
    /* isAgeRestrictedUser */   false,
    /* isDoNotSell */           true);
MolocoPrivacy.setPrivacy(privacySettings);

ज़्यादा जानकारी के लिए, Moloco SDK Android का दस्तावेज़ देखें.

पांचवां चरण: लागू किए गए बदलावों की जांच करना

टेस्ट विज्ञापनों को चालू करना

पक्का करें कि आपने AdMob के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो.

टेस्ट विज्ञापनों की पुष्टि करना

यह पुष्टि करने के लिए कि आपको Moloco Ads SDK से टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन जांचने वाले टूल में Moloco (बिडिंग) विज्ञापन सोर्स का इस्तेमाल करके, विज्ञापन के किसी एक सोर्स को टेस्ट करना चालू करें.

गड़बड़ी के कोड

अगर अडैप्टर को Moloco से विज्ञापन नहीं मिलता है, तो विज्ञापन के जवाब में हुई गड़बड़ी की जानकारी देखने के लिए, इनमें से किसी क्लास के हिसाब से ResponseInfo.getAdapterResponses() का इस्तेमाल करें:

com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter

विज्ञापन लोड न होने पर, Moloco अडैप्टर से मिलने वाले कोड और उनसे जुड़े मैसेज यहां दिए गए हैं:

गड़बड़ी का कोड	डोमेन	वजह
101	com.google.ads.mediation.moloco	Moloco ऐप्लिकेशन की कुंजी मौजूद नहीं है या अमान्य है.
102	com.google.ads.mediation.moloco	Moloco विज्ञापन यूनिट का आईडी मौजूद नहीं है या अमान्य है.
103	com.google.ads.mediation.moloco	Moloco ने जो विज्ञापन ऑब्जेक्ट दिखाया वह शून्य था.
-1 से 5000	com.moloco.sdk	Moloco SDK टूल से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, Moloco का दस्तावेज़ देखें.

इनाम वाले विज्ञापन के लिए सर्वर-साइड पर की गई पुष्टि

अगर आपने सर्वर साइड से की जाने वाली पुष्टि (एसएसवी) वाले कॉलबैक की पुष्टि की है, तो Moloco के लिए विज्ञापन सोर्स आइडेंटिफ़ायर 8267622065755668722 है.