इस गाइड में बताया गया है कि Google Mobile Ads SDK for React Native का इस्तेमाल करके, मीडिएशन की मदद से Moloco Ads SDK से विज्ञापन लोड करने और दिखाने का तरीका क्या है. इसमें बिडिंग इंटिग्रेशन शामिल हैं. इसमें बताया गया है कि किसी विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में Moloco Ads SDK को कैसे जोड़ा जाता है. साथ ही, किसी React Native ऐप्लिकेशन में Moloco Ads SDK और अडैप्टर को कैसे इंटिग्रेट किया जाता है.
इस्तेमाल किए जा सकने वाले इंटिग्रेशन और विज्ञापन फ़ॉर्मैट
Moloco Ads SDK के लिए AdMob मीडिएशन अडैप्टर में ये सुविधाएं उपलब्ध हैं:
| इंटिग्रेशन | |
|---|---|
| बिडिंग | |
| वॉटरफ़ॉल | |
| फ़ॉर्मैट | |
| ऐप का खुलना | |
| बैनर | |
| इंटरस्टीशियल विज्ञापन | |
| इनाम वाले विज्ञापन | |
| इनाम वाला इंटरस्टीशियल विज्ञापन | |
ज़रूरी शर्तें
जारी रखने से पहले, इनकी पुष्टि करें:
- Google Mobile Ads SDK for React Native का नया वर्शन.
- React Native फ़्रेमवर्क का वर्शन 0.85.0 या इसके बाद का वर्शन.
- Android पर डिप्लॉय करने के लिए
- Android एपीआई लेवल 24 या इसके बाद का वर्शन.
- iOS पर डिप्लॉय करने के लिए
- iOS डिप्लॉयमेंट का टारगेट 13.0 या इसके बाद का वर्शन होना चाहिए.
- Google Mobile Ads SDK for React Native के साथ कॉन्फ़िगर किया गया ऐसा React Native प्रोजेक्ट जिस पर काम किया जा सकता हो. ज़्यादा जानकारी के लिए, Google Mobile Ads SDK for React Native सेट अप करना लेख पढ़ें.
- पक्का करें कि आपने
gma-sdk-react-nativeफ़ोल्डर सेadaptersफ़ोल्डर को डाउनलोड और एक्सट्रैक्ट कर लिया हो. अगर आपके पासadaptersफ़ोल्डर नहीं है, तो Google Mobile Ads SDK for React Native इंस्टॉल करें में जाकर, पहला, दूसरा, और तीसरा चरण अपनाएं.
- पक्का करें कि आपने
- AdMob मीडिएशन सेट अप करें.
पहला चरण: Moloco Ads SDK के यूआई में कॉन्फ़िगरेशन सेट अप करना
Moloco Publisher Portal में लॉग इन करें.
खास जानकारी > ऐप्लिकेशन टैब पर जाएं. इसके बाद, नया ऐप्लिकेशन बनाने के लिए, ऐप्लिकेशन जोड़ें बटन पर क्लिक करें.
अपने ऐप्लिकेशन के लिए, ओएस और निजता सेटिंग चुनें. इसके बाद, फ़ॉर्म में बाकी जानकारी भरें और फिर बनाएं पर क्लिक करें.
Android
iOS
ऐप्लिकेशन बन जाने के बाद, जानकारी देखने के लिए उसे Apps टैब से चुनें. साथ ही, App Key को नोट करें.
Android
iOS
खास जानकारी > विज्ञापन यूनिट टैब पर जाएं. इसके बाद, ड्रॉप-डाउन मेन्यू से ऐप्लिकेशन चुनें और नई विज्ञापन यूनिट पर क्लिक करें.
नीलामी के तरीके के तौर पर, इन-ऐप्लिकेशन बिडिंग चुनें और बाकी फ़ॉर्म भरें. इसके बाद, बनाएं पर क्लिक करें.
विज्ञापन यूनिट टैब में जाकर, नई बनाई गई विज्ञापन यूनिट पर जाएं और उसकी जानकारी देखें. विज्ञापन यूनिट का आईडी नोट करें.
दूसरा चरण: AdMob के यूआई में Moloco Ads SDK की डिमांड सेट अप करना
अपनी विज्ञापन यूनिट के लिए मीडिएशन सेटिंग कॉन्फ़िगर करना
Android
निर्देशों के लिए, Android के लिए दी गई गाइड में दूसरा चरण देखें.
iOS
निर्देशों के लिए, iOS की गाइड में दूसरा चरण देखें.
Moloco Ads को जीडीपीआर और अमेरिका के राज्यों में लागू कानूनों के तहत विज्ञापन पार्टनरों की सूची में जोड़ना
AdMob के यूज़र इंटरफ़ेस (यूआई) में, यूरोप और अमेरिका के राज्यों के कानूनों के तहत विज्ञापन पार्टनर की सूची में Moloco Ads को जोड़ने के लिए, यहां दिया गया तरीका अपनाएं: यूरोपीय कानूनों की सेटिंग और अमेरिका के राज्यों के कानूनों की सेटिंग
तीसरा चरण: Moloco Ads SDK और अडैप्टर को इंपोर्ट करना
अपने प्रोजेक्ट की रूट डायरेक्ट्री में, Google Mobile Ads SDK for React Native Moloco Ads SDK के लिए मीडिएशन अडैप्टर इंस्टॉल करें. नीचे दिए गए कदमों को पूरा करें:
Google Mobile Ads SDK for React Native अडैप्टर की tar फ़ाइल को
gma-sdk-react-native/adapters/moloco/डायरेक्ट्री से अपने प्रोजेक्ट कीlocal_packages/डायरेक्ट्री में कॉपी करें. अगर आपके पासadaptersफ़ोल्डर नहीं है, तो ज़रूरी शर्तें देखें.mkdir -p local_packages cp EXTRACT_DIR/gma-sdk-react-native/adapters/moloco/gma-mediation-moloco-0.1.0.tgz local_packages/EXTRACT_DIR को उस डायरेक्ट्री के पाथ से बदलें जहां आपने संग्रह को एक्सट्रैक्ट किया है.
अपने पसंदीदा पैकेज मैनेजर का इस्तेमाल करके, अडैप्टर पैकेज इंस्टॉल करें:
npm
npm install ./local_packages/gma-mediation-moloco-0.1.0.tgzऊन
yarn add ./local_packages/gma-mediation-moloco-0.1.0.tgz
चौथा चरण: Moloco SDK पर निजता सेटिंग लागू करना
ईयू उपयोगकर्ता की सहमति से जुड़ी नीति और जीडीपीआर
ईयू उपयोगकर्ता की सहमति से जुड़ी Google की नीति का पालन करने के लिए, आपको यूरोपियन इकनॉमिक एरिया (ईईए), यूके, और स्विट्ज़रलैंड में अपने उपयोगकर्ताओं को कुछ ज़रूरी जानकारी साफ़ तौर पर देनी होगी. साथ ही, कानूनी रूप से ज़रूरी होने पर, कुकी या दूसरे लोकल स्टोरेज में इकट्ठा किए गए डेटा के इस्तेमाल के लिए भी उनकी सहमति लेनी होगी. इसके अलावा, लोगों के हिसाब से विज्ञापन दिखाने के मकसद से निजी डेटा इकट्ठा करने, शेयर करने, और इस्तेमाल करने के लिए भी उपयोगकर्ताओं की सहमति लेनी होगी. इस नीति में, ईयू के ई-निजता निर्देश और जनरल डेटा प्रोटेक्शन रेगुलेशन (जीडीपीआर) की ज़रूरी शर्तों के बारे में बताया गया है. यह आपकी ज़िम्मेदारी है कि सहमति की जानकारी, आपकी मीडिएशन चेन में मौजूद हर विज्ञापन सोर्स को भेजी जाए.
Moloco Ads SDK के React Native अडैप्टर का वर्शन 0.1.0 और इसके बाद के वर्शन, जीडीपीआर के तहत सहमति के सिग्नल पास करने की सुविधा के साथ काम करते हैं. ये सिग्नल, IAB के Transparency and Consent Framework (टीसीएफ़) के साथ इंटिग्रेट किए गए कंसेंट मैनेजमेंट प्लैटफ़ॉर्म से Moloco Ads SDK को पास किए जाते हैं.
ज़्यादा जानकारी के लिए, Android के लिए MolocoPrivacy दस्तावेज़ और iOS के लिए टीसीएफ़ सहमति स्ट्रिंग देखें.
अमेरिका के राज्यों के निजता कानून
अमेरिका के राज्यों के निजता कानूनों के मुताबिक, उपयोगकर्ताओं को अपनी "निजी जानकारी" (जैसा कि कानून में परिभाषित है) की "बिक्री" से ऑप्ट आउट करने का अधिकार मिलना चाहिए. ऑप्ट आउट का विकल्प देने के लिए, "बिक्री करने वाले" पक्ष को अपने होम पेज पर "मेरी निजी जानकारी न बेचें" का लिंक प्रमुखता से दिखाना होगा. अमेरिका के राज्यों के निजता कानूनों का पालन करने से जुड़ी गाइड में, Google के विज्ञापन दिखाने के लिए सीमित डेटा प्रोसेसिंग मोड को चालू करने की सुविधा मिलती है. हालांकि, Google आपकी मीडिएशन चेन में मौजूद हर विज्ञापन नेटवर्क पर इस सेटिंग को लागू नहीं कर सकता. इसलिए, आपको मीडिएशन चेन में मौजूद हर उस विज्ञापन नेटवर्क कंपनी की पहचान करनी होगी जो निजी जानकारी की बिक्री में हिस्सा ले सकती है. साथ ही, आपको यह पक्का करने के लिए कि निजता कानून का पालन किया जा रहा है, उन सभी नेटवर्क से मिले दिशा-निर्देशों का पालन करना होगा.
Moloco Ads SDK के लिए Google Mobile Ads Unity मीडिएशन प्लग इन में, Moloco.SetDoNotSell(bool) तरीका शामिल है. इससे Moloco Ads SDK को सहमति की जानकारी भेजी जाती है. यहां दिए गए सैंपल कोड में, सहमति की इस जानकारी को Moloco Ads SDK में भेजने का तरीका बताया गया है. अगर आपको ये फ़्लैग सेट करने हैं, तो हमारा सुझाव है कि आप Google Mobile Ads SDK for React Native के ज़रिए विज्ञापनों का अनुरोध करने से पहले ऐसा करें.
import { MolocoMediation } from '@google/gma-mediation-moloco';
// ...
MolocoMediation.setDoNotSell(true);
ज़्यादा जानकारी के लिए, Android और iOS के लिए, Moloco Ads SDK के सुझाए गए इंटिग्रेशन के निर्देश देखें.
पांचवां चरण: ज़रूरी कोड जोड़ना
Moloco Ads SDK को इंटिग्रेट करने के लिए, किसी और कोड की ज़रूरत नहीं होती.
छठा चरण: लागू किए गए बदलावों की जांच करना
टेस्ट विज्ञापनों को चालू करना
पक्का करें कि आपने AdMob के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो.
टेस्ट विज्ञापनों की पुष्टि करना
यह पुष्टि करने के लिए कि आपको 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 से मिला विज्ञापन ऑब्जेक्ट शून्य था. |
| 104 | com.google.ads.mediation.moloco | Moloco SDK टूल को शुरू नहीं किया जा सका. |
| -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 का दस्तावेज़ देखें. |
वर्शन 0.1.0
- शुरुआती रिलीज़.
- Moloco Android अडैप्टर के वर्शन 4.12.0.1 के साथ काम करता है.
- Moloco iOS अडैप्टर के 4.10.0.0 वर्शन के साथ काम करता है.
- इसे Google Mobile Ads React Native प्लगिन के 0.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है.