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

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

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

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

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

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

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

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

  • 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

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

Android

iOS

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

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

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

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

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

Android

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

iOS

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

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

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

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

OpenUPM-CLI

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

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

OpenUPM

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

स्कोप की गई रजिस्ट्रियां टैब में जाकर, 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 mediation प्लगिन का नया वर्शन डाउनलोड करें. इसके बाद, ज़िप फ़ाइल से GoogleMobileAdsMolocoMediation.unitypackage को निकालें.

अपने Unity प्रोजेक्ट एडिटर में, ऐसेट > पैकेज इंपोर्ट करें > कस्टम पैकेज को चुनें. इसके बाद, डाउनलोड की गई 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 mediation प्लगिन में, 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 Mediation Plugin के बदलावों की जानकारी

वर्शन 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