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

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

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

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

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

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

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

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

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

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

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

Android

iOS

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

Android

iOS

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

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

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

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

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

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

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

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

pub.dev के ज़रिए इंटिग्रेशन

अपने पैकेज की pubspec.yaml फ़ाइल में, Moloco Ads SDK और अडैप्टर के नए वर्शन के साथ यह डिपेंडेंसी जोड़ें:

dependencies:
  gma_mediation_moloco: ^3.7.1

मैन्युअल इंटिग्रेशन

Moloco Ads SDK के लिए, Google Mobile Ads mediation plugin का नया वर्शन डाउनलोड करें. इसके बाद, डाउनलोड की गई फ़ाइल को एक्सट्रैक्ट करें. साथ ही, एक्सट्रैक्ट किए गए प्लगिन फ़ोल्डर और उसके कॉन्टेंट को अपने Flutter प्रोजेक्ट में जोड़ें. इसके बाद, अपनी pubspec.yaml फ़ाइल में प्लगिन का रेफ़रंस दें. इसके लिए, यह डिपेंडेंसी जोड़ें:

dependencies:
  gma_mediation_moloco:
    path: path/to/local/package

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

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

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

Moloco Ads SDK के Flutter अडैप्टर का 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 Flutter Plugin के ज़रिए विज्ञापनों का अनुरोध करने से पहले ऐसा करें.

import 'package:gma_mediation_moloco/gma_mediation_moloco.dart';
// ...

GmaMediationMoloco.setDoNotSell(true);

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

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

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

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

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

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

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

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

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

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

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

MolocoSDK.MolocoError
GADMediationAdapterMoloco

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

Moloco Flutter Mediation Adapter के बदलावों की जानकारी

वर्शन 3.7.1

• Moloco Android अडैप्टर के 4.12.0.1 वर्शन के साथ काम करता है.
• Moloco iOS अडैप्टर के 4.10.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter Plugin के 9.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 3.7.0

• Moloco Android अडैप्टर के 4.12.0.0 वर्शन के साथ काम करता है.
• Moloco iOS अडैप्टर के 4.10.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter Plugin के 9.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 3.6.1

• Google Mobile Ads Flutter प्लगिन के 9.1.0 वर्शन के साथ काम करने के लिए अपडेट किया गया.
• Swift Package Manager के लिए सहायता जोड़ी गई.
• Moloco Android अडैप्टर के 4.11.1.0 वर्शन के साथ काम करता है.
• Moloco iOS अडैप्टर के 4.9.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter Plugin के 9.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 3.6.0

• Moloco Android अडैप्टर के वर्शन 4.11.0.0 के साथ काम करता है.
• Moloco iOS अडैप्टर के 4.9.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 9.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 3.5.1

• Moloco Android अडैप्टर के 4.10.1.0 वर्शन के साथ काम करता है.
• Moloco iOS अडैप्टर के 4.8.1.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 9.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 3.5.0

• Moloco Android अडैप्टर के 4.10.0.0 वर्शन के साथ काम करता है.
• Moloco iOS अडैप्टर के 4.8.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 9.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 3.4.0

• Flutter के कम से कम वर्शन को 3.38.1 पर अपडेट किया गया
• Google Mobile Ads Flutter प्लगिन के 8.0.0 वर्शन के साथ काम करने के लिए अपडेट किया गया
• Moloco Android adapter version 4.7.0.0 के साथ काम करता है.
• Moloco iOS अडैप्टर के 4.5.1.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 8.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 3.3.0

• Moloco Android अडैप्टर के 4.5.0.0 वर्शन के साथ काम करता है.
• Moloco iOS अडैप्टर के वर्शन 4.3.0.2 के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 7.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 3.2.0

• Moloco Android adapter version 4.4.0.0 के साथ काम करता है.
• Moloco iOS अडैप्टर के 4.2.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 7.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 3.1.0

• Flutter के कम से कम वर्शन को 3.35.1 पर अपडेट किया गया
• Moloco Android adapter version 4.4.0.0 के साथ काम करता है.
• Moloco iOS अडैप्टर के 4.1.2.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 7.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 3.0.0

• Moloco Android adapter version 4.3.1.0 के साथ काम करता है.
• Moloco iOS अडैप्टर के 4.1.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया है.

वर्शन 2.1.0

• Moloco Android अडैप्टर के 4.2.0.0 वर्शन के साथ काम करता है.
• Moloco iOS अडैप्टर के 3.13.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया है.

वर्शन 2.0.0

• Moloco Android adapter version 4.0.0.0 के साथ काम करता है.
• Moloco iOS अडैप्टर के 3.13.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.6.0

• Moloco Android अडैप्टर वर्शन 3.12.0.0 के साथ काम करता है.
• Moloco iOS अडैप्टर के 3.12.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.5.0

• Moloco Android अडैप्टर के वर्शन 3.11.0.0 के साथ काम करता है.
• Moloco iOS अडैप्टर के 3.11.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.4.0

• Moloco Android अडैप्टर के 3.10.0.0 वर्शन के साथ काम करता है.
• Moloco iOS अडैप्टर के 3.10.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.3.1

• Moloco Android अडैप्टर के 3.9.0.0 वर्शन के साथ काम करता है.
• Moloco iOS अडैप्टर के 3.9.1.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.3.0

• Moloco Android अडैप्टर के 3.9.0.0 वर्शन के साथ काम करता है.
• Moloco iOS अडैप्टर के 3.9.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.2.0

• Moloco Android adapter version 3.8.0.1 के साथ काम करता है.
• Moloco iOS अडैप्टर के 3.8.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.1.0

• Moloco Android adapter version 3.7.0.0 के साथ काम करता है.
• Moloco iOS अडैप्टर के 3.6.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 5.3.1 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.0.0

• शुरुआती रिलीज़.
• Moloco Android adapter version 3.6.1.0 के साथ काम करता है.
• Moloco iOS अडैप्टर के 3.6.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 5.3.1 वर्शन के साथ बनाया और टेस्ट किया गया है.