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

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

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

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

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

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

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

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

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

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

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

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

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

Android

iOS

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

सेटअप

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

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

मेन्यू

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

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

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

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

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

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

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

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

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

दूसरा चरण: AdMob यूज़र इंटरफ़ेस (यूआई) में, डीटी एक्सचेंज की मांग सेट अप करना

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

Android

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

iOS

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

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

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

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

OpenUPM-CLI

अगर आपने OpenUPM-CLI इंस्टॉल किया है, तो अपने प्रोजेक्ट की रूट डायरेक्ट्री से यह कमांड चलाकर, Unity के लिए Google Mobile Ads DT Exchange मीडिएशन प्लग इन को अपने प्रोजेक्ट में इंस्टॉल किया जा सकता है:

openupm add com.google.ads.mobile.mediation.dtexchange

OpenUPM

Unity पैकेज मैनेजर की सेटिंग खोलने के लिए, अपने Unity प्रोजेक्ट एडिटर में बदलाव करें > प्रोजेक्ट सेटिंग > पैकेज मैनेजर चुनें.

स्कोप वाली रजिस्ट्री टैब में, OpenUPM को स्कोप वाली रजिस्ट्री के तौर पर जोड़ें. इसके लिए, यह जानकारी दें:

  • नाम: OpenUPM
  • URL: https://package.openupm.com
  • दायरा: com.google

OpenUPM की जानकारी

इसके बाद, Unity Package Manager खोलने के लिए, विंडो > पैकेज मैनेजर पर जाएं. इसके बाद, ड्रॉप-डाउन मेन्यू से मेरी रजिस्ट्री चुनें.

Unity रजिस्ट्री

Google Mobile Ads DT Exchange Mediation पैकेज चुनें और इंस्टॉल करें पर क्लिक करें.

OpenUPM से इंस्टॉल करें

Unity पैकेज

बदलावों की जानकारी में दिए गए डाउनलोड लिंक से, DT Exchange के लिए Google Mobile Ads मीडिएशन प्लग इन का नया वर्शन डाउनलोड करें. इसके बाद, ज़िप फ़ाइल से GoogleMobileAdsDTExchangeMediation.unitypackage को निकालें.

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

Unity से इंपोर्ट करना

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

ज़बरदस्ती ठीक करें

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

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

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

DT Exchange के वर्शन 1.1.0 के लिए, Google मोबाइल विज्ञापन मीडिएशन प्लगिन ने 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 का CCPA Open Source लेख पढ़ें.

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

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 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 Mediation प्लग इन में हुए बदलावों का लॉग

वर्शन 3.3.3

3.3.2 वर्शन

3.3.1 वर्शन

3.3.0 वर्शन

3.2.1 वर्शन

3.2.0 वर्शन

3.1.12 वर्शन

3.1.11 वर्शन

3.1.10 वर्शन

वर्शन 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

  • Unity मीडिएशन प्लग इन का नाम बदलकर "DT Exchange" कर दिया गया.
  • GoogleMobileAds.Api.Mediation.Fyber.Fyber क्लास का नाम बदलकर GoogleMobileAds.Api.Mediation.DTExchange.DTExchange किया गया.
  • DT Exchange Android अडैप्टर वर्शन 8.2.1.0 पर काम करता है.
  • DT Exchange iOS अडैप्टर के 8.1.7.0 वर्शन के साथ काम करता है.
  • इसे Google Mobile Ads Unity प्लग इन के 7.3.1 वर्शन के साथ बनाया और टेस्ट किया गया है.

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