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

ध्यान दें: Fyber Marketplace का नाम अब DT Exchange हो गया है.

इस गाइड में बताया गया है कि वॉटरफ़ॉल इंटिग्रेशन को कवर करने वाले मीडिएशन का इस्तेमाल करके, 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 API (एपीआई) लेवल 21 या उसके बाद का वर्शन
• iOS पर डिप्लॉय करने के लिए
  • iOS डिप्लॉयमेंट टारगेट, 12.0 या इसके बाद का होना चाहिए
• Google मोबाइल विज्ञापन SDK की मदद से कॉन्फ़िगर किया गया Flutter एक चालू प्रोजेक्ट. ज़्यादा जानकारी के लिए, शुरू करें देखें.
• मीडिएशन को पूरा करें शुरुआती निर्देश

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

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

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

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

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

Android

iOS

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

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

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

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

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

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

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

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

दूसरा चरण: AdMob यूज़र इंटरफ़ेस (यूआई) में DT Exchange डिमांड सेट अप करना

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

Android

निर्देशों के लिए, Android की गाइड में दूसरा चरण देखें.

iOS

निर्देशों के लिए, iOS की गाइड में दूसरा चरण देखें.

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

अहम जानकारी: पुष्टि करें कि आपके पास खाता मैनेजमेंट की अनुमति है, ताकि ईयू (यूरोपीय संघ) की सहमति के साथ-साथ जीडीपीआर, सीपीआरए, और उपयोगकर्ता मैसेज सेवा प्लैटफ़ॉर्म का कॉन्फ़िगरेशन पूरा किया जा सके. ज़्यादा जानकारी के लिए, अपने खाते के लिए उपयोगकर्ता का ऐक्सेस मैनेज करना देखें.

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

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

ध्यान दें: साथ काम करने वाले DT Exchange और Google Mobile Ads 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.

अहम जानकारी: ऐप्लिकेशन रिलीज़ करने से पहले, AdMob और DT Exchange अपने ऐप्लिकेशन के लिए टेस्ट मोड बंद करें.

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

यह पुष्टि करने के लिए कि 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 टूल में शुरू करने में कोई गड़बड़ी मिली.

1.0.0

• शुरुआती रिलीज़.
• DT Exchange Android अडैप्टर के 8.2.6.1 वर्शन के साथ पुष्टि की गई
• DT Exchange iOS अडैप्टर के 8.2.7.0 वर्शन के साथ पुष्टि की गई