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

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

इस गाइड में बताया गया है कि 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 की मांग सेट अप करना

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

    Android

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

    iOS

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

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

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

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

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

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

    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 मीडिएशन प्लग इन में 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 का इस्तेमाल करें:

    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 Flutter Mediation Adapter के बदलावों की जानकारी

    वर्शन 3.7.1

    वर्शन 3.7.0

    वर्शन 3.6.1

    वर्शन 3.6.0

    वर्शन 3.5.1

    वर्शन 3.5.0

    वर्शन 3.4.0

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

    वर्शन 3.3.0

    वर्शन 3.2.0

    वर्शन 3.1.0

    वर्शन 3.0.0

    वर्शन 2.1.0

    वर्शन 2.0.0

    वर्शन 1.6.0

    वर्शन 1.5.0

    वर्शन 1.4.0

    वर्शन 1.3.1

    वर्शन 1.3.0

    वर्शन 1.2.0

    वर्शन 1.1.0

    वर्शन 1.0.0