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

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

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

DT Exchange के लिए Ad Manager मीडिएशन अडैप्टर में ये काम किए जा सकते हैं:

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

• Google Mobile Ads SDK का नया वर्शन
• Flutter 3.7.0 या इसके बाद का वर्शन
• Android पर डिप्लॉय करने के लिए
  • Android का एपीआई लेवल 21 या उसके बाद का वर्शन
• iOS पर डिप्लॉय करने के लिए
  • iOS 12.0 या इसके बाद का डिप्लॉयमेंट टारगेट
• Google के मोबाइल विज्ञापन SDK टूल के साथ कॉन्फ़िगर किया गया Flutter एक काम कर रहा प्रोजेक्ट. ज़्यादा जानकारी के लिए, शुरू करें देखें.
• मीडिएशन की प्रोसेस पूरी करें शुरुआती निर्देश

पहला चरण: DT Exchange यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगरेशन सेट अप करना

नया ऐप्लिकेशन और विज्ञापन प्लेसमेंट जोड़ें

DT Exchange Console में साइन अप करें या लॉग इन करें.

अपना ऐप्लिकेशन जोड़ने के लिए, ऐप्लिकेशन जोड़ें बटन पर क्लिक करें.

अपना प्लैटफ़ॉर्म चुनें, बाकी फ़ॉर्म भरें, और प्लेसमेंट जोड़ें पर क्लिक करें.

अपने प्लेसमेंट को नाम दें लेबल वाले फ़ील्ड में नए प्लेसमेंट का नाम डालें और ड्रॉपडाउन सूची से अपनी पसंद का प्लेसमेंट टाइप चुनें. आखिर में, प्लेसमेंट सेव करें पर क्लिक करें.

ऐप्लिकेशन आईडी और प्लेसमेंट आईडी

बाईं ओर मौजूद नेविगेशन बार पर कर्सर घुमाकर, उसे खोलें. इसके बाद, बाईं ओर दिए मेन्यू में ऐप्लिकेशन पर क्लिक करें.

ऐप्लिकेशन मैनेजमेंट पेज पर, अपने ऐप्लिकेशन के आगे मौजूद ऐप्लिकेशन आईडी पर ध्यान दें.

अपना ऐप्लिकेशन चुनें, प्लेसमेंट टैब पर जाएं और प्लेसमेंट का नाम के बगल में मौजूद कॉपी आइकॉन पर क्लिक करें. प्लेसमेंट आईडी को ध्यान में रखें.

पब्लिशर आईडी, उपभोक्ता कुंजी, और उपभोक्ता की निजता

बाईं ओर मौजूद मेन्यू में, अपने उपयोगकर्ता नाम पर क्लिक करें और उपयोगकर्ता की प्रोफ़ाइल चुनें.

पब्लिशर आईडी, उपभोक्ता कुंजी, और उपभोक्ता सीक्रेट को ध्यान में रखें, क्योंकि अगले चरण में इनकी ज़रूरत होगी.

दूसरा चरण: Ad Manager यूज़र इंटरफ़ेस (यूआई) में DT Exchange की मांग सेट अप करना

अपनी विज्ञापन यूनिट के लिए मीडिएशन सेटिंग कॉन्फ़िगर करना

जीडीपीआर और अमेरिका के कानूनों के तहत आने वाले विज्ञापन पार्टनर की सूची में Fyber जोड़ें

जीडीपीआर सेटिंग और अमेरिका के कानूनों के बारे में सेटिंग में दिया गया तरीका अपनाएं, ताकि Fyber को जीडीपीआर और अमेरिका के कानूनों के बारे में बताने वाली विज्ञापन पार्टनर सूची में Ad Manager यूज़र इंटरफ़ेस (यूआई) जोड़ा जा सके.

तीसरा चरण: DT Exchange SDK टूल और अडैप्टर इंपोर्ट करना

pub.dev के ज़रिए इंटिग्रेशन

अपनी पैकेज की pubspec.yaml फ़ाइल मेंDT Exchange SDK और अडैप्टर के नए वर्शन के साथ, इन डिपेंडेंसी जोड़ें:

dependencies:
  gma_mediation_dtexchange: ^1.0.0

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

DT Exchange के लिए Google मोबाइल विज्ञापन मीडिएशन प्लग इन का सबसे नया वर्शन डाउनलोड करें, डाउनलोड की गई फ़ाइल निकालें और अपने 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 को सहमति की जानकारी भेजने के लिए काम नहीं करता.

पांचवां चरण: ज़रूरी कोड जोड़ना

छठा चरण: लागू होने की जांच करना

टेस्ट विज्ञापनों को चालू करें

पक्का करें कि आपने Ad Manager.

टेस्ट विज्ञापनों की पुष्टि करें

यह पुष्टि करने के लिए कि DT Exchangeसे आपको टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन जांचने वाले टूल में विज्ञापन के एक सोर्स को टेस्ट करने की सुविधा चालू करें. इसके लिए, DT Exchange (Waterfall) विज्ञापन सोर्स का इस्तेमाल करें.

गड़बड़ी कोड

अगर अडैप्टर को DT Exchange से विज्ञापन नहीं मिलता है, तो प्रकाशक ResponseInfo का इस्तेमाल करके नीचे दिए गए क्लास के तहत विज्ञापन रिस्पॉन्स में उस गड़बड़ी की जांच कर सकते हैं:

com.google.ads.mediation.fyber.FyberMediationAdapter

GADMediationAdapterFyber

यहां किसी विज्ञापन के लोड न होने पर DT Exchange अडैप्टर से भेजे जाने वाले कोड और उनके साथ दिखाई जाने वाले मैसेज दिए गए हैं:

DT Exchange Flutter मीडिएशन अडैप्टर बदलाव लॉग

1.0.0

• शुरुआती रिलीज़.
• इस बात की पुष्टि की गई कि यह DT Exchange Android अडैप्टर के 8.2.7.0 वर्शन के साथ काम करता है या नहीं.
• इस बात की पुष्टि की गई कि यह DT Exchange iOS अडैप्टर के 8.2.8.0 वर्शन के साथ काम करता है या नहीं.
• इसे Google Mobile Ads Flutter प्लगिन वर्शन 5.1.0 की मदद से बनाया और टेस्ट किया गया है.