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

प्लैटफ़ॉर्म चुनें: Android iOS Unity Flutter Android (लेगसी)

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

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

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

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

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

जारी रखने से पहले, इनकी पुष्टि करें:

  • Google Mobile Ads Unity Plugin का नया वर्शन.
  • Unity Editor का 5.6 या इसके बाद का वर्शन.
  • Moloco Unity Plugin 1.2.0 या इसके बाद का वर्शन.
  • Android पर डिप्लॉय करने के लिए
    • Android एपीआई लेवल 24 या इसके बाद का वर्शन.
  • iOS पर डिप्लॉय करने के लिए
    • iOS डिप्लॉयमेंट का टारगेट 13.0 या इसके बाद का वर्शन होना चाहिए.
  • Google Mobile Ads Unity Plugin के साथ कॉन्फ़िगर किया गया ऐसा Unity प्रोजेक्ट जिस पर काम किया जा सकता हो. ज़्यादा जानकारी के लिए, Google Mobile Ads Unity Plugin सेट अप करना लेख पढ़ें.
  • मीडिएशन सेट अप करें.

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

    Moloco Publisher Portal में लॉग इन करें.

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

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

    Android

    iOS

    ऐप्लिकेशन बन जाने के बाद, जानकारी देखने के लिए उसे Apps टैब से चुनें. इसके बाद, App Key को नोट करें.

    Android

    iOS

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

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

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

    दूसरा चरण: Ad Manager के यूज़र इंटरफ़ेस (यूआई) में, Moloco Ads SDK की मांग सेट अप करना

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

    Android

    निर्देशों के लिए, Android के लिए गाइड में दिया गया दूसरा चरण देखें.

    iOS

    निर्देशों के लिए, iOS के लिए गाइड में दिया गया दूसरा चरण देखें.

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

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

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

    OpenUPM-CLI

    अगर आपके पास OpenUPM-CLI इंस्टॉल है, तो अपने प्रोजेक्ट की रूट डायरेक्ट्री से यह कमांड चलाकर, Unity के लिए Google Mobile Ads Moloco Ads SDK Mediation Plugin को अपने प्रोजेक्ट में इंस्टॉल किया जा सकता है:

    openupm add com.google.ads.mobile.mediation.moloco

    OpenUPM

    अपने Unity प्रोजेक्ट एडिटर में, Edit > Project Settings > Package Manager को चुनें. इससे Unity Package Manager Settings खुल जाएंगी.

    Scoped Registries टैब में जाकर, OpenUPM को ऐसी रजिस्ट्री के तौर पर जोड़ें जो उसके स्कोप में हो. इसके लिए, यह जानकारी डालें:

    • नाम: OpenUPM
    • URL: https://package.openupm.com
    • स्कोप: com.google

    OpenUPM की जानकारी

    इसके बाद, Window > Package Manager पर जाकर, Unity Package Manager खोलें. इसके बाद, ड्रॉप-डाउन मेन्यू से My Registries को चुनें.

    Unity Registries

    Google Mobile Ads Moloco Mediation पैकेज को चुनें और Install पर क्लिक करें.

    OpenUPM से इंस्टॉल करना

    Unity पैकेज

    बदलाव की जानकारी में दिए गए डाउनलोड लिंक से, Moloco Ads SDK के लिए Google Mobile Ads मीडिएशन प्लग इन का नया वर्शन डाउनलोड करें. इसके बाद, zip फ़ाइल से GoogleMobileAdsMolocoMediation.unitypackage को एक्सट्रैक्ट करें.

    अपने Unity प्रोजेक्ट एडिटर में, Assets > Import Package > Custom Package को चुनें. इसके बाद, डाउनलोड की गई GoogleMobileAdsMolocoMediation.unitypackage फ़ाइल को ढूंढें. पक्का करें कि सभी फ़ाइलें चुनी गई हों. इसके बाद, इंपोर्ट करें पर क्लिक करें.

    Unity से इंपोर्ट करना

    इसके बाद, ऐसेट > External Dependency Manager > Android Resolver > Force Resolve को चुनें. External Dependency Manager लाइब्रेरी, डिपेंडेंसी को शुरू से हल करेगी. साथ ही, एलान की गई डिपेंडेंसी को आपके Unity ऐप्लिकेशन की Assets/Plugins/Android डायरेक्ट्री में कॉपी करेगी.

    समस्या को ज़बरदस्ती हल करना

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

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

    Moloco Ads SDK के Unity अडैप्टर का वर्शन 1.0.0 और इसके बाद के वर्शन, जीडीपीआर के तहत सहमति के सिग्नल Moloco Ads SDK को पास कर सकते हैं. ये सिग्नल, IAB के Transparency and Consent Framework (टीसीएफ़) के साथ इंटिग्रेट किए गए सहमति मैनेजमेंट प्लैटफ़ॉर्म से पास किए जाते हैं. ज़्यादा जानकारी के लिए, Android के लिए MolocoPrivacy दस्तावेज़ और iOS के लिए टीसीएफ़ सहमति स्ट्रिंग देखें.

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

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

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

    using GoogleMobileAds.Api.Mediation.Moloco;
// ...

Moloco.SetDoNotSell(true);

    ज़्यादा जानकारी के लिए, Android और iOS के लिए, Moloco Ads SDK को लागू करने के बारे में सुझाए गए निर्देश देखें.

    पांचवां चरण: ज़रूरी कोड जोड़ना

    Moloco Ads SDK को इंटिग्रेट करने के लिए, किसी अन्य कोड की ज़रूरत नहीं है.

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

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

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

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

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

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

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

    Android

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

    iOS

    MolocoSDK.MolocoError
GADMediationAdapterMoloco

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

    Android

    गड़बड़ी का कोड डोमेन वजह
    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 का दस्तावेज़ देखें.

    iOS

    गड़बड़ी का कोड डोमेन वजह
    101 com.google.ads.mediation.moloco Moloco SDK, iOS 12 और इससे पहले के वर्शन पर विज्ञापन नहीं दिखाता.
    102 com.google.ads.mediation.moloco Moloco ऐप्लिकेशन पासकोड मौजूद नहीं है या अमान्य है.
    103 com.google.ads.mediation.moloco Moloco विज्ञापन यूनिट का आईडी मौजूद नहीं है या अमान्य है.
    104 com.google.ads.mediation.moloco विज्ञापन दिखाने के लिए तैयार नहीं है.
    105 com.google.ads.mediation.moloco विज्ञापन नहीं दिखाया जा सका.
    106 com.google.ads.mediation.moloco विज्ञापन को रेंडर करने के लिए, रेंडरिंग डेटा उपलब्ध नहीं है.
    -1 से 5000 Moloco SDK से भेजा गया Moloco SDK टूल से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, Moloco का दस्तावेज़ देखें.

    Moloco Unity मीडिएशन प्लग इन के बदलावों का लॉग

    वर्शन 3.11.0 (डेवलेपमेंट में है)

    वर्शन 3.10.1

    वर्शन 3.10.0

    वर्शन 3.9.1

    वर्शन 3.9.0

    वर्शन 3.8.1

    वर्शन 3.8.0

    वर्शन 3.7.0

    वर्शन 3.6.1

    वर्शन 3.6.0

    वर्शन 3.5.1

    वर्शन 3.5.0

    वर्शन 3.4.1

    वर्शन 3.4.0

    वर्शन 3.3.1

    वर्शन 3.3.0

    वर्शन 3.2.0

    वर्शन 3.1.0

    वर्शन 3.0.0

    वर्शन 2.2.1

    वर्शन 2.2.0

    वर्शन 2.1.0

    वर्शन 2.0.0

    वर्शन 1.6.1

    वर्शन 1.6.0

    वर्शन 1.5.0

    वर्शन 1.4.0

    वर्शन 1.3.1

    वर्शन 1.3.0

    वर्शन 1.2.1

    वर्शन 1.2.0

    वर्शन 1.1.0

    वर्शन 1.0.0