इस गाइड में, मीडिएशन का इस्तेमाल करके, DT Exchange से विज्ञापन लोड करने और दिखाने के लिए, Google Mobile Ads SDK टूल का इस्तेमाल करने का तरीका बताया गया है. इसमें वॉटरफ़ॉल इंटिग्रेशन के बारे में भी बताया गया है. इसमें, विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में DT Exchange को जोड़ने का तरीका बताया गया है. साथ ही, DT Exchange SDK टूल और अडैप्टर को Flutter ऐप्लिकेशन में इंटिग्रेट करने का तरीका भी बताया गया है.
इस्तेमाल किए जा सकने वाले इंटिग्रेशन और विज्ञापन फ़ॉर्मैट
DT Exchange के लिए AdMob मीडिएशन अडैप्टर में ये काम किए जा सकते हैं:
| इंटिग्रेशन | |
|---|---|
| बिडिंग | |
| झरना | |
| फ़ॉर्मैट | |
| बैनर | |
| मध्यवर्ती | |
| इनाम दिया गया | |
ज़रूरी शर्तें
- Google Mobile Ads SDK का नया वर्शन
- Flutter 3.7.0 या इसके बाद का वर्शन
- Android पर डिप्लॉय करने के लिए
- Android का एपीआई लेवल 21 या उसके बाद का वर्शन
- iOS पर डिप्लॉय करने के लिए
- iOS 12.0 या इसके बाद का डिप्लॉयमेंट टारगेट
- Google Mobile Ads SDK के साथ कॉन्फ़िगर किया गया, काम करने वाला Flutter प्रोजेक्ट. ज़्यादा जानकारी के लिए, शुरू करें देखें.
- मीडिएशन की प्रोसेस पूरी करें शुरुआती निर्देश
पहला चरण: DT Exchange के यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगरेशन सेट अप करना
नया ऐप्लिकेशन और विज्ञापन प्लेसमेंट जोड़ना
DT Exchange कंसोल में साइन अप करें या लॉग इन करें.
अपना ऐप्लिकेशन जोड़ने के लिए, ऐप्लिकेशन जोड़ें बटन पर क्लिक करें.
अपना प्लैटफ़ॉर्म चुनें, बाकी फ़ॉर्म भरें, और प्लेसमेंट जोड़ें पर क्लिक करें.
Android
iOS
अपने प्लेसमेंट को नाम दें लेबल वाले फ़ील्ड में, अपने नए प्लेसमेंट का नाम डालें. इसके बाद, ड्रॉपडाउन मेन्यू से अपनी पसंद का प्लेसमेंट टाइप चुनें. आखिर में, प्लेसमेंट सेव करें पर क्लिक करें.
ऐप्लिकेशन आईडी और प्लेसमेंट आईडी
बाईं ओर मौजूद नेविगेशन बार को खोलने के लिए, माउस को उस पर घुमाएं. इसके बाद, बाईं ओर मौजूद मेन्यू में ऐप्लिकेशन पर क्लिक करें.
ऐप्लिकेशन मैनेजमेंट पेज पर, अपने ऐप्लिकेशन के बगल में मौजूद ऐप्लिकेशन आईडी नोट करें.
अपना ऐप्लिकेशन चुनें, प्लेसमेंट टैब पर जाएं, और प्लेसमेंट का नाम के बगल में मौजूद, कॉपी आइकॉन पर क्लिक करें. प्लेसमेंट आईडी का ध्यान रखें.
पब्लिशर आईडी, उपभोक्ता कुंजी, और उपभोक्ता सीक्रेट
बाईं ओर मौजूद मेन्यू में, अपने उपयोगकर्ता नाम पर क्लिक करें. इसके बाद, उपयोगकर्ता की प्रोफ़ाइल चुनें.
पब्लिशर आईडी, कंज्यूमर पासकोड, और कंज्यूमर सीक्रेट को नोट करें, क्योंकि अगले चरण में इनकी ज़रूरत पड़ेगी.
दूसरा चरण: AdMob यूज़र इंटरफ़ेस (यूआई) में DT Exchange की मांग सेट अप करना
अपनी विज्ञापन यूनिट के लिए मीडिएशन सेटिंग कॉन्फ़िगर करना
Android
निर्देशों के लिए, Android की गाइड में दूसरा चरण देखें.
iOS
निर्देशों के लिए, iOS की गाइड में दूसरा चरण देखें.
जीडीपीआर और अमेरिका के कानूनों के तहत विज्ञापन पार्टनर की सूची में Fyber जोड़ें
AdMob यूज़र इंटरफ़ेस (यूआई) में जीडीपीआर और अमेरिका के कानूनों के हिसाब से विज्ञापन पार्टनर की सूची में DT Exchange (Fyber से कमाई करने) को जोड़ने के लिए, जीडीपीआर सेटिंग और अमेरिका के कानूनों की सेटिंग में दिया गया तरीका अपनाएं.
तीसरा चरण: DT Exchange SDK टूल और अडैप्टर इंपोर्ट करना
pub.dev की मदद से इंटिग्रेशन
अपने पैकेज की pubspec.yaml फ़ाइल में,DT Exchange SDK टूल और अडैप्टर के नए वर्शन के साथ यह डिपेंडेंसी जोड़ें:
dependencies:
gma_mediation_dtexchange: ^1.0.0
मैन्युअल इंटिग्रेशन
इसके लिए Google मोबाइल विज्ञापन मीडिएशन प्लग-इन का सबसे नया वर्शन डाउनलोड करें
DT Exchange,
डाउनलोड की गई फ़ाइल को एक्सट्रैक्ट करें और एक्सट्रैक्ट किए गए प्लगिन फ़ोल्डर को जोड़ें
(और इसकी सामग्री) को आपके Flutter प्रोजेक्ट में शामिल करना होगा. फिर, अपने
pubspec.yaml फ़ाइल में यह डिपेंडेंसी जोड़कर:
dependencies:
gma_mediation_dtexchange:
path: path/to/local/package
चौथा चरण: DT Exchange SDK टूल पर निजता सेटिंग लागू करना
ईयू (यूरोपीय संघ) की सहमति और जीडीपीआर
Google की ईयू उपयोगकर्ता की सहमति से जुड़ी नीति के तहत, आपको यह पक्का करना होगा कि डिवाइस आइडेंटिफ़ायर और निजी डेटा के इस्तेमाल के बारे में, यूरोपियन इकनॉमिक एरिया (ईईए) में रहने वाले उपयोगकर्ताओं को कुछ जानकारी दी गई हो और उनसे सहमति ली गई हो. इस नीति में, ईयू के ई-निजता निर्देश और जनरल डेटा प्रोटेक्शन रेगुलेशन (जीडीपीआर) की ज़रूरी शर्तों के बारे में बताया गया है. सहमति लेते समय, आपको अपनी मीडिएशन चेन में हर उस विज्ञापन नेटवर्क की पहचान करनी होगी जो निजी डेटा को इकट्ठा, हासिल या इस्तेमाल कर सकता है. साथ ही, आपको हर नेटवर्क के इस्तेमाल के बारे में जानकारी देनी होगी. फ़िलहाल, Google ऐसे नेटवर्क के लिए उपयोगकर्ता की सहमति के विकल्प को अपने-आप पास नहीं कर सकता.
DT Exchange के लिए Google मोबाइल विज्ञापन मीडिएशन प्लग इन, DT Exchange SDK को सहमति की जानकारी भेजने के लिए काम नहीं करता.
अमेरिका के निजता कानून
अमेरिका के निजता कानून लोगों को यह अधिकार देना ज़रूरी है कि वे अपनी "निजी जानकारी" (जैसा कि कानून में बताया गया है) को "बिक्री" से ऑप्ट आउट करने का विकल्प दें. साथ ही, "बिक्री" करने वाली पार्टी के होम पेज पर मौजूद, "मेरी निजी जानकारी न बेचें" लिंक से ऑप्ट-आउट करें. अमेरिका के निजता कानूनों के पालन से जुड़ी गाइड, Google विज्ञापन दिखाने के लिए सीमित डेटा प्रोसेसिंग को चालू करने की सुविधा देती है. हालांकि, Google आपकी मीडिएशन चेन के हर विज्ञापन नेटवर्क पर इस सेटिंग को लागू नहीं कर सकता. इसलिए, आपको अपनी मीडिएशन चेन में मौजूद हर उस विज्ञापन नेटवर्क की पहचान करनी होगी जो निजी जानकारी की बिक्री में हिस्सा ले सकता है. साथ ही, नीति का पालन करने के लिए, उन सभी नेटवर्क के दिशा-निर्देशों का पालन करना होगा.
DT Exchange के लिए Google मोबाइल विज्ञापन मीडिएशन प्लग इन, DT Exchange SDK को सहमति की जानकारी भेजने के लिए काम नहीं करता.
पांचवां चरण: ज़रूरी कोड जोड़ना
Android
DT Exchange इंटिग्रेशन के लिए, किसी और कोड की ज़रूरत नहीं होती.
iOS
SKAdNetwork इंटिग्रेशन
अपने प्रोजेक्ट की Info.plist फ़ाइल में SKAdNetwork आइडेंटिफ़ायर जोड़ने के लिए, DT Exchange के दस्तावेज़ देखें.
छठा चरण: लागू करने की जांच करना
टेस्ट विज्ञापनों को चालू करें
पक्का करें कि आपने AdMob.
टेस्ट विज्ञापनों की पुष्टि करें
यह पुष्टि करने के लिए कि DT Exchangeसे आपको टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन जांचने वाले टूल में विज्ञापन के एक सोर्स को टेस्ट करने की सुविधा चालू करें. इसके लिए, DT Exchange (Waterfall) विज्ञापन सोर्स का इस्तेमाल करें.
गड़बड़ी के कोड
अगर अडैप्टर को DT Exchange से विज्ञापन नहीं मिलता है, तो प्रकाशक ResponseInfo का इस्तेमाल करके विज्ञापन रिस्पॉन्स में उस गड़बड़ी की जांच कर सकते हैं जो नीचे दी गई क्लास के तहत है:
Android
com.google.ads.mediation.fyber.FyberMediationAdapter
iOS
GADMediationAdapterFyber
यहां किसी विज्ञापन के लोड न होने पर DT Exchange अडैप्टर से भेजे जाने वाले कोड और उनके साथ दिखाई जाने वाले मैसेज दिए गए हैं:
Android
| गड़बड़ी का कोड | कारण |
|---|---|
| 101 | AdMob यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए DT Exchange सर्वर पैरामीटर मौजूद नहीं हैं या अमान्य हैं. |
| 103 | विज्ञापन का अनुरोध किया गया साइज़, DT Exchange में काम करने वाले बैनर के साइज़ से मेल नहीं खाता. |
| 105 | DT Exchange SDK ने एक विज्ञापन लोड किया, लेकिन अनचाहा कंट्रोलर दिखाया. |
| 106 | विज्ञापन दिखाने के लिए तैयार नहीं है. |
| 200-399 | DT Exchange SDK टूल में कोई गड़बड़ी मिली. ज़्यादा जानकारी के लिए, कोड देखें. |
iOS
| गड़बड़ी का कोड | कारण |
|---|---|
| 0-10 | DT Exchange SDK टूल में कोई गड़बड़ी मिली. ज़्यादा जानकारी के लिए, दस्तावेज़ देखें. |
| 101 | AdMob यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगर किए गए DT Exchange सर्वर पैरामीटर मौजूद नहीं हैं या अमान्य हैं. |
| 102 | विज्ञापन का अनुरोध किया गया साइज़, DT Exchange में काम करने वाले बैनर के साइज़ से मेल नहीं खाता. |
| 103 | विज्ञापन नहीं दिखाया जा सका, क्योंकि विज्ञापन ऑब्जेक्ट का पहले ही इस्तेमाल किया जा चुका है. |
| 104 | विज्ञापन तैयार न होने की वजह से, DT Exchange के विज्ञापन नहीं दिखाए जा सके. |
| 105 | DT Exchange SDK टूल को शुरू करने में गड़बड़ी हुई. |
DT Exchange Flutter मीडिएशन अडैप्टर में हुए बदलावों का लॉग
अगला वर्शन
- इसे Google Mobile Ads Flutter प्लगिन वर्शन 5.2.0 की मदद से बनाया और टेस्ट किया गया है.
1.1.0
- DT Exchange के Android अडैप्टर के 8.3.0.0 वर्शन के साथ काम करने की पुष्टि की गई है.
- इस बात की पुष्टि की गई कि यह DT Exchange iOS अडैप्टर के 8.3.1.0 वर्शन के साथ काम करता है या नहीं.
- Google Mobile Ads Flutter प्लग इन के 5.1.0 वर्शन के साथ बनाया और टेस्ट किया गया.
1.0.0
- शुरुआती रिलीज़.
- DT Exchange के Android अडैप्टर के 8.2.7.0 वर्शन के साथ काम करने की पुष्टि की गई है.
- DT Exchange iOS अडैप्टर के वर्शन 8.2.8.0 के साथ काम करने की पुष्टि की गई है.
- Google Mobile Ads Flutter प्लग इन के 5.1.0 वर्शन के साथ बनाया और टेस्ट किया गया.