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

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

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

DT Exchange के लिए AdMob मीडिएशन अडैप्टर में ये सुविधाएं होती हैं:

इंटिग्रेशन
बिडिंग
वॉटरफ़ॉल
फ़ॉर्मैट
बैनर
मध्यवर्ती
इनाम दिया गया

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

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

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

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

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

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

ऐप्लिकेशन प्रबंधित करें

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

Android

iOS

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

सेटअप

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

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

मेन्यू

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

ऐप्लिकेशन आईडी

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

प्लेसमेंट आईडी

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

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

उपयोगकर्ता की प्रोफ़ाइल का मेन्यू

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

उपयोगकर्ता प्रोफ़ाइल

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

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

Android

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

iOS

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

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

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

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

Changelog में दिए डाउनलोड लिंक से DT Exchange के लिए Google Mobile Ads मीडिएशन प्लगिन का सबसे नया वर्शन डाउनलोड करें और ZIP फ़ाइल से GoogleMobileAdsFyberMediation.unitypackage एक्सट्रैक्ट करें.

अपने Unity प्रोजेक्ट के एडिटर में, ऐसेट > पैकेज इंपोर्ट करें > कस्टम पैकेज चुनें और डाउनलोड की गई GoogleMobileAdsFyberMediation.unitypackage फ़ाइल ढूंढें. पक्का करें कि सभी फ़ाइलें चुनी गई हों और इंपोर्ट करें पर क्लिक करें.

इसके बाद, एसेट > Play सेवाएं रिज़ॉल्वर > Android रिज़ॉल्वर > ज़बरदस्ती समाधान करें चुनें. Unity Play Services रिज़ॉल्वर लाइब्रेरी, शुरुआत से डिपेंडेंसी रिज़ॉल्यूशन लागू करेगी. साथ ही, तय की गई डिपेंडेंसी को आपके Unity ऐप्लिकेशन की Assets/Plugins/Android डायरेक्ट्री में कॉपी कर देगी.

चौथा चरण: DT Exchange SDK टूल पर निजता सेटिंग लागू करना

Google की ईयू उपयोगकर्ता की सहमति से जुड़ी नीति के तहत, आपको यह पक्का करना होगा कि डिवाइस आइडेंटिफ़ायर और निजी डेटा के इस्तेमाल के बारे में, यूरोपियन इकनॉमिक एरिया (ईईए) के उपयोगकर्ताओं को कुछ जानकारी दी गई है और उनसे सहमति ली गई है. इस नीति में ईयू के ई-निजता निर्देश और जनरल डेटा प्रोटेक्शन रेगुलेशन (जीडीपीआर) की ज़रूरी शर्तों के बारे में बताया गया है. सहमति लेते समय, आपको अपनी मीडिएशन चेन में हर उस विज्ञापन नेटवर्क की पहचान करनी होगी जो निजी डेटा इकट्ठा कर सकती है, पा सकती है या उसका इस्तेमाल कर सकती है. साथ ही, आपको हर नेटवर्क के इस्तेमाल के बारे में जानकारी देनी होगी. फ़िलहाल, Google ऐसे नेटवर्क के लिए उपयोगकर्ता की सहमति का विकल्प अपने-आप नहीं भेज सकता.

इस सेक्शन में, DT Exchange के लिए लोगों के हिसाब से विज्ञापन दिखाने की सुविधा को चालू या बंद करने का तरीका बताया गया है.

DT Exchange वर्शन 1.1.0 के लिए Google Mobile Ads मीडिएशन प्लगिन ने, SetGDPRRequired() और SetGDPRConsentString() तरीकों के साथ Fyber क्लास को जोड़ा. इससे, आपको मैन्युअल तरीके से DT Exchange को सहमति की जानकारी भेजने की सुविधा मिलती है. यहां दिए गए सैंपल कोड से पता चलता है कि इन पैरामीटर को DT Exchange अडैप्टर में कैसे पास किया जाता है:

using GoogleMobileAds.Api.Mediation.Fyber;
// ...

Fyber.SetGDPRConsent(true);
Fyber.SetGDPRConsentString("myGDPRConsentString");

ज़्यादा जानकारी और इस तरीके में दी जा सकने वाली वैल्यू के लिए, DT Exchange के जीडीपीआर लेख पर जाएं.

अमेरिका के निजता कानून

अमेरिका के निजता कानून उपयोगकर्ताओं को यह अधिकार देना ज़रूरी है कि वे अपनी "निजी जानकारी" को "बेचने" से ऑप्ट आउट कर सकें (जैसा कि कानून में उन शर्तों के बारे में बताया गया है). साथ ही, "बिक्री" पार्टी के होम पेज पर "मेरी निजी जानकारी न बेचें" लिंक से, "मेरी निजी जानकारी न बेचें" विकल्प से ऑप्ट-आउट करने का अधिकार देना ज़रूरी है. अमेरिका के निजता कानून के पालन से जुड़ी गाइड में, Google पर विज्ञापन दिखाने के लिए सीमित डेटा प्रोसेसिंग को चालू करने की सुविधा दी गई है. हालांकि, Google आपकी मीडिएशन चेन में हर विज्ञापन नेटवर्क पर यह सेटिंग लागू नहीं कर सकता. इसलिए, आपको अपनी मीडिएशन चेन में हर उस विज्ञापन नेटवर्क कंपनी की पहचान करनी होगी जो निजी जानकारी की बिक्री में हिस्सा ले सकती है. साथ ही, हर नेटवर्क के निर्देशों का पालन करना ज़रूरी है.

DT Exchange वर्शन 3.1.1 के लिए Google Mobile Ads मीडिएशन प्लगिन ने, SetCCPAString() तरीके के साथ Fyber क्लास को जोड़ा. इससे, DT Exchange को मैन्युअल तरीके से सहमति की जानकारी भेजी जा सकती है. नीचे दिए गए सैंपल कोड से पता चलता है कि इन पैरामीटर को DT Exchange अडैप्टर में कैसे पास किया जाता है:

using GoogleMobileAds.Api.Mediation.Fyber;
// ...

Fyber.SetCCPAString("myCCPAConsentString");

// You can also clear CCPA consent information using the following method:
Fyber.ClearCCPAString();

ज़्यादा जानकारी और इस तरीके में दी जा सकने वाली वैल्यू के लिए, DT Exchange के सीसीपीए ओपन सोर्स लेख पर जाएं.

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

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 Unity मीडिएशन का प्लगिन चेंजलॉग

वर्शन 3.1.8

वर्शन 3.1.7

वर्शन 3.1.6

वर्शन 3.1.5

  • अडैप्टर के कॉन्टेंट को GoogleMobileAds/Mediation/DTExchange/ में ले जाया गया.
  • GoogleMobileAds.Mediation.DTExchange का इस्तेमाल करने के लिए, रीफ़ैक्टर किया गया अडैप्टर नेमस्पेस.
  • DT Exchange Android अडैप्टर के 8.2.3.0 वर्शन पर काम करता है.
  • DT Exchange iOS अडैप्टर के 8.2.1.0 वर्शन के साथ काम करता है.
  • Google Mobile Ads Unity प्लगिन के वर्शन 8.1.0 से बनाया और टेस्ट किया गया.

वर्शन 3.1.4

वर्शन 3.1.3

वर्शन 3.1.2

वर्शन 3.1.1

वर्शन 3.1.0

वर्शन 3.0.2

वर्शन 3.0.1

वर्शन 3.0.0

वर्शन 2.0.0

वर्शन 1.6.1

वर्शन 1.6.0

वर्शन 1.5.2

वर्शन 1.5.1

वर्शन 1.5.0

वर्शन 1.4.0

वर्शन 1.3.0

वर्शन 1.2.3

वर्शन 1.2.2

वर्शन 1.2.1

वर्शन 1.2.0

वर्शन 1.1.0

वर्शन 1.0.0