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

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

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

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

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

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

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

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

  • 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

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

    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.8.0

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

    Moloco Ads SDK के लिए, Google Mobile Ads मीडिएशन प्लग इन का नया वर्शन डाउनलोड करें. इसके बाद, डाउनलोड की गई फ़ाइल को एक्सट्रैक्ट करें और एक्सट्रैक्ट किए गए प्लग इन फ़ोल्डर (और उसके कॉन्टेंट) को अपने 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 से 5,000 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 से 5,000 Moloco SDK से भेजा गया Moloco SDK से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, Moloco का दस्तावेज़ देखें.

    Moloco Flutter मीडिएशन अडैप्टर के बदलावों का लॉग

    वर्शन 3.8.0

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