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