इस गाइड में बताया गया है कि Google Mobile Ads SDK for React Native का इस्तेमाल करके, मीडिएशन की मदद से DT Exchange से विज्ञापन लोड करने और दिखाने का तरीका क्या है. इसमें वॉटरफ़ॉल इंटिग्रेशन शामिल हैं. इसमें बताया गया है कि किसी विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में DT Exchange को कैसे जोड़ा जाता है. साथ ही, किसी React Native ऐप्लिकेशन में DT Exchange SDK और अडैप्टर को कैसे इंटिग्रेट किया जाता है.
इस्तेमाल किए जा सकने वाले इंटिग्रेशन और विज्ञापन फ़ॉर्मैट
DT Exchange के लिए React Native मीडिएशन अडैप्टर में ये सुविधाएं उपलब्ध हैं:
| इंटिग्रेशन | |
|---|---|
| बिडिंग | |
| वॉटरफ़ॉल | |
| फ़ॉर्मैट | |
| ऐप का खुलना | |
| बैनर | |
| इंटरस्टीशियल विज्ञापन | |
| इनाम वाले विज्ञापन | |
| इनाम वाला इंटरस्टीशियल विज्ञापन | |
| मूल भाषा वाला | |
ज़रूरी शर्तें
जारी रखने से पहले, इनकी पुष्टि करें:
- Google Mobile Ads SDK for React Native का नया वर्शन.
- React Native फ़्रेमवर्क का वर्शन 0.85.0 या इसके बाद का वर्शन.
- Android पर डिप्लॉय करने के लिए
- Android एपीआई लेवल 24 या इसके बाद का वर्शन.
- iOS पर डिप्लॉय करने के लिए
- iOS डिप्लॉयमेंट का टारगेट 15.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 मीडिएशन सेट अप करें.
पहला चरण: DT Exchange के यूआई में कॉन्फ़िगरेशन सेट अप करना
नया ऐप्लिकेशन और विज्ञापन प्लेसमेंट जोड़ना
DT Exchange Console में साइन अप या लॉग इन करें.
ऐप्लिकेशन जोड़ें पर क्लिक करें.
अपना प्लैटफ़ॉर्म और प्लेसमेंट चुनें. इसके बाद, फ़ॉर्म में बाकी जानकारी भरें और ऐप्लिकेशन बनाएं पर क्लिक करें.
Android
iOS
अपने प्लेसमेंट के नाम डालें और उनके टाइप चुनें. इसके बाद, प्लेसमेंट सेव करें पर क्लिक करें.
ऐप्लिकेशन आईडी और प्लेसमेंट आईडी
बाईं ओर मौजूद नेविगेशन बार को खोलने के लिए, उस पर कर्सर घुमाएं. इसके बाद, ऐप्लिकेशन मैनेजमेंट पर क्लिक करें.
ऐप्लिकेशन मैनेजमेंट पेज पर, अपने ऐप्लिकेशन के बगल में मौजूद ऐप्लिकेशन आईडी को नोट करें.
अपना ऐप्लिकेशन चुनें और प्लेसमेंट टैब पर जाएं. जगह का आईडी को नोट करें..
पब्लिशर आईडी, उपभोक्ता कुंजी, और उपभोक्ता सीक्रेट
बाएं मेन्यू में जाकर, अपने उपयोगकर्ता नाम पर क्लिक करें और उपयोगकर्ता की प्रोफ़ाइल को चुनें.
पब्लिशर आईडी, उपयोगकर्ता कुंजी, और उपयोगकर्ता सीक्रेट को नोट करें, क्योंकि अगले चरण में इनकी ज़रूरत पड़ेगी.
app-ads.txt फ़ाइल अपडेट करना
ऐप्लिकेशन के लिए, अनुमति वाले सेलर (app-ads.txt), IAB Tech Lab की एक पहल है. इसकी मदद से यह पक्का किया जा सकता है कि आपके ऐप्लिकेशन की विज्ञापन इन्वेंट्री सिर्फ़ वे चैनल बेचें जिन्हें आपने अनुमति दी है. विज्ञापन से मिलने वाले रेवेन्यू में ज़्यादा नुकसान न हो, इसके लिए आपको app-ads.txt फ़ाइल लागू करनी होगी.
अगर आपने अब तक ऐसा नहीं किया है, तो
अपने ऐप्लिकेशन के लिए app-ads.txt फ़ाइल सेट अप करें.
DT Exchange के लिए app-ads.txt लागू करने के लिए, DT को अपनी app-ads.txt फ़ाइल में जोड़ें.
दूसरा चरण: AdMob के यूआई में DT Exchange की डिमांड सेट अप करना
अपनी विज्ञापन यूनिट के लिए मीडिएशन सेटिंग कॉन्फ़िगर करना
Android
निर्देशों के लिए, Android के लिए दी गई गाइड में दूसरा चरण देखें.
iOS
निर्देशों के लिए, iOS की गाइड में दूसरा चरण देखें.
DT Exchange को जीडीपीआर और अमेरिका के राज्यों में लागू कानूनों के तहत विज्ञापन पार्टनरों की सूची में जोड़ना
AdMob के यूज़र इंटरफ़ेस (यूआई) में, यूरोप और अमेरिका के राज्यों के कानूनों के तहत विज्ञापन पार्टनर की सूची में DT Exchange (Fyber Monetization) को जोड़ने के लिए, यहां दिया गया तरीका अपनाएं: यूरोपीय कानूनों की सेटिंग और अमेरिका के राज्यों के कानूनों की सेटिंग
तीसरा चरण: DT Exchange SDK और अडैप्टर को इंपोर्ट करना
अपने प्रोजेक्ट की रूट डायरेक्ट्री में, DT Exchange के लिए Google Mobile Ads SDK for React Native मीडिएशन अडैप्टर इंस्टॉल करें. नीचे दिए गए कदमों को पूरा करें:
Google Mobile Ads SDK for React Native अडैप्टर की tar फ़ाइल को
gma-sdk-react-native/adapters/dt-exchange/डायरेक्ट्री से अपने प्रोजेक्ट कीlocal_packages/डायरेक्ट्री में कॉपी करें. अगर आपके पासadaptersफ़ोल्डर नहीं है, तो ज़रूरी शर्तें देखें.mkdir -p local_packages cp EXTRACT_DIR/gma-sdk-react-native/adapters/dt-exchange/gma-mediation-dtexchange-0.1.0.tgz local_packages/EXTRACT_DIR को उस डायरेक्ट्री के पाथ से बदलें जहां आपने संग्रह को एक्सट्रैक्ट किया है.
अपने पसंदीदा पैकेज मैनेजर का इस्तेमाल करके, अडैप्टर पैकेज इंस्टॉल करें:
npm
npm install ./local_packages/gma-mediation-dtexchange-0.1.0.tgzऊन
yarn add ./local_packages/gma-mediation-dtexchange-0.1.0.tgz
चौथा चरण: DT Exchange SDK पर निजता सेटिंग लागू करना
ईयू उपयोगकर्ता की सहमति से जुड़ी नीति और जीडीपीआर
ईयू उपयोगकर्ता की सहमति से जुड़ी Google की नीति का पालन करने के लिए, आपको यूरोपियन इकनॉमिक एरिया (ईईए), यूके, और स्विट्ज़रलैंड में अपने उपयोगकर्ताओं को कुछ ज़रूरी जानकारी साफ़ तौर पर देनी होगी. साथ ही, कानूनी रूप से ज़रूरी होने पर, कुकी या दूसरे लोकल स्टोरेज में इकट्ठा किए गए डेटा के इस्तेमाल के लिए भी उनकी सहमति लेनी होगी. इसके अलावा, लोगों के हिसाब से विज्ञापन दिखाने के मकसद से निजी डेटा इकट्ठा करने, शेयर करने, और इस्तेमाल करने के लिए भी उपयोगकर्ताओं की सहमति लेनी होगी. इस नीति में, ईयू के ई-निजता निर्देश और जनरल डेटा प्रोटेक्शन रेगुलेशन (जीडीपीआर) की ज़रूरी शर्तों के बारे में बताया गया है. यह आपकी ज़िम्मेदारी है कि सहमति की जानकारी, आपकी मीडिएशन चेन में मौजूद हर विज्ञापन सोर्स को भेजी जाए.
DT Exchange React Native अडैप्टर का वर्शन 0.1.0 और इसके बाद के वर्शन, जीडीपीआर के तहत सहमति के सिग्नल को DT Exchange SDK टूल को पास करने की सुविधा देते हैं. ये सिग्नल, सहमति मैनेज करने वाले उन प्लैटफ़ॉर्म से पास किए जाते हैं जो IAB के पारदर्शिता और सहमति फ़्रेमवर्क (टीसीएफ़) के साथ इंटिग्रेट होते हैं. ज़्यादा जानकारी के लिए, Android और iOS के लिए जीडीपीआर से जुड़े दस्तावेज़ देखें.
अमेरिका के राज्यों के निजता कानून
अमेरिका के राज्यों के निजता कानूनों के मुताबिक, उपयोगकर्ताओं को अपनी "निजी जानकारी" (जैसा कि कानून में परिभाषित है) की "बिक्री" से ऑप्ट आउट करने का अधिकार मिलना चाहिए. ऑप्ट आउट का विकल्प देने के लिए, "बिक्री करने वाले" पक्ष को अपने होम पेज पर "मेरी निजी जानकारी न बेचें" का लिंक प्रमुखता से दिखाना होगा. अमेरिका के राज्यों के निजता कानूनों का पालन करने से जुड़ी गाइड में, Google के विज्ञापन दिखाने के लिए सीमित डेटा प्रोसेसिंग मोड को चालू करने की सुविधा मिलती है. हालांकि, Google आपकी मीडिएशन चेन में मौजूद हर विज्ञापन नेटवर्क पर इस सेटिंग को लागू नहीं कर सकता. इसलिए, आपको मीडिएशन चेन में मौजूद हर उस विज्ञापन नेटवर्क कंपनी की पहचान करनी होगी जो निजी जानकारी की बिक्री में हिस्सा ले सकती है. साथ ही, आपको यह पक्का करने के लिए कि निजता कानून का पालन किया जा रहा है, उन सभी नेटवर्क से मिले दिशा-निर्देशों का पालन करना होगा.
यहां दिए गए सैंपल कोड में, DT Exchange अडैप्टर को सहमति की जानकारी मैन्युअल तरीके से भेजने का तरीका बताया गया है:
import { DTExchangeMediation } from '@google/gma-mediation-dtexchange';
// ...
DTExchangeMediation.setUSPrivacyString('myUSPrivacyString');
// You can also clear CCPA consent information using the following method:
DTExchangeMediation.clearUSPrivacyString();
ज़्यादा जानकारी के लिए, DT Exchange का सीसीपीए ओपन सोर्स लेख पढ़ें. साथ ही, यह भी जानें कि इस तरीके में कौनसी वैल्यू दी जा सकती हैं.
पांचवां चरण: ज़रूरी कोड जोड़ना
Android
DT Exchange इंटिग्रेशन के लिए, किसी और कोड की ज़रूरत नहीं है.
iOS
SKAdNetwork इंटिग्रेशन
अपने प्रोजेक्ट की Info.plist फ़ाइल में SKAdNetwork आइडेंटिफ़ायर जोड़ने के लिए, DT Exchange के दस्तावेज़ पढ़ें.
छठा चरण: लागू किए गए बदलावों की जांच करना
टेस्ट विज्ञापनों को चालू करना
पक्का करें कि आपने AdMob के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो.
टेस्ट विज्ञापनों की पुष्टि करना
यह पुष्टि करने के लिए कि आपको DT Exchange से टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन जांचने वाले टूल में DT Exchange (बिडिंग) और DT Exchange (वॉटरफ़ॉल) विज्ञापन सोर्स का इस्तेमाल करके, विज्ञापन के किसी एक सोर्स को टेस्ट करना चालू करें.
गड़बड़ी के कोड
अगर अडैप्टर को DT Exchange से विज्ञापन नहीं मिलता है, तो पब्लिशर विज्ञापन के जवाब में हुई गड़बड़ी की जानकारी देखने के लिए, इनमें से किसी क्लास के हिसाब से ResponseInfo का इस्तेमाल कर सकते हैं:
Android
com.google.ads.mediation.fyber.FyberMediationAdapter
iOS
GADMediationAdapterFyber
विज्ञापन लोड न होने पर, DT Exchange अडैप्टर से मिलने वाले कोड और उनसे जुड़े मैसेज यहां दिए गए हैं:
Android
| गड़बड़ी का कोड | वजह |
|---|---|
| 101 | AdMob के यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए DT Exchange सर्वर पैरामीटर मौजूद नहीं हैं या मान्य नहीं हैं. |
| 103 | जिस विज्ञापन साइज़ का अनुरोध किया गया है वह DT Exchange के साथ काम करने वाले बैनर के साइज़ से मेल नहीं खाता है. |
| 105 | DT SDK ने एक विज्ञापन लोड किया, लेकिन उसे अनचाहा कंट्रोलर मिला. |
| 106 | विज्ञापन दिखाने के लिए तैयार नहीं है. |
| 107 | कॉन्टेक्स्ट, गतिविधि का इंस्टेंस नहीं है. |
| 108 | विज्ञापन नहीं दिखाया जा सका. |
| 200-399 | DT SDK से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, कोड देखें. |
iOS
| गड़बड़ी का कोड | कारण |
|---|---|
| 0-10 | DT SDK से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, दस्तावेज़ देखें. |
| 101 | AdMob के यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए DT Exchange सर्वर पैरामीटर मौजूद नहीं हैं या मान्य नहीं हैं. |
| 102 | जिस विज्ञापन साइज़ का अनुरोध किया गया है वह DT Exchange के साथ काम करने वाले बैनर के साइज़ से मेल नहीं खाता है. |
| 103 | विज्ञापन नहीं दिखाया जा सका, क्योंकि विज्ञापन ऑब्जेक्ट का इस्तेमाल पहले ही किया जा चुका है. |
| 104 | विज्ञापन तैयार न होने की वजह से, DT Exchange के विज्ञापन नहीं दिखाए जा सके. |
| 105 | शुरू करने के दौरान, DT SDK टूल से गड़बड़ी का मैसेज मिला. |
वर्शन 0.1.0
- शुरुआती रिलीज़.
- DT Exchange Android अडैप्टर के वर्शन 8.4.7.1 के साथ काम करता है.
- इसमें DT Exchange iOS अडैप्टर के 8.4.10.0 वर्शन के साथ काम करने की सुविधा जोड़ी गई.
- इसे Google Mobile Ads React Native प्लगिन के 0.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है.