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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

चौथा चरण: 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 के सीसीपीए ओपन सोर्स लेख पर जाएं.

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

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

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

पक्का करें कि आपने AdMob के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो.

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

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

गड़बड़ी के कोड

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

com.google.ads.mediation.fyber.FyberMediationAdapter

GADMediationAdapterFyber

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

DT Exchange Unity Mediation प्लग इन में हुए बदलावों का लॉग

3.3.3 वर्शन

• DT Exchange Android अडैप्टर के 8.3.2.0 वर्शन के साथ काम करता है.
• DT Exchange iOS अडैप्टर वर्शन 8.3.2.1 पर काम करता है.
• Google Mobile Ads Unity प्लग इन के 9.3.0 वर्शन के साथ बनाया और टेस्ट किया गया.

3.3.2 वर्शन

• DT Exchange Android अडैप्टर के 8.3.1.0 वर्शन के साथ काम करता है.
• DT Exchange iOS अडैप्टर के 8.3.2.1 वर्शन के साथ काम करता है.
• Google Mobile Ads Unity प्लग इन के 9.3.0 वर्शन के साथ बनाया और टेस्ट किया गया.

वर्शन 3.3.1

• DT Exchange Android अडैप्टर के 8.3.1.0 वर्शन के साथ काम करता है.
• DT Exchange iOS अडैप्टर के 8.3.2.0 वर्शन के साथ काम करता है.
• Google Mobile Ads Unity प्लगिन के वर्शन 9.2.0 की मदद से, इसे बनाया और टेस्ट किया गया है.

3.3.0 वर्शन

• DummyClient का नाम बदलकर PlaceholderClient किया गया.
• DT Exchange Android अडैप्टर के 8.3.0.0 वर्शन के साथ काम करता है.
• DT Exchange iOS अडैप्टर के 8.3.1.0 वर्शन के साथ काम करता है.
• Google Mobile Ads Unity प्लगिन के वर्शन 9.2.0 की मदद से, इसे बनाया और टेस्ट किया गया है.

वर्शन 3.2.1

• DT Exchange Android अडैप्टर के 8.2.7.0 वर्शन के साथ काम करता है.
• DT Exchange iOS अडैप्टर के 8.3.1.0 वर्शन के साथ काम करता है.
• Google Mobile Ads Unity प्लगिन के वर्शन 9.1.1 की मदद से, इसे बनाया और टेस्ट किया गया है.

3.2.0 वर्शन

• DT Exchange Android अडैप्टर के 8.2.7.0 वर्शन के साथ काम करता है.
• DT Exchange iOS अडैप्टर के 8.3.0.0 वर्शन के साथ काम करता है.
• Google Mobile Ads Unity प्लग इन के 9.1.0 वर्शन के साथ बनाया और टेस्ट किया गया.

3.1.12 वर्शन

• DT Exchange Android अडैप्टर के 8.2.7.0 वर्शन के साथ काम करता है.
• DT Exchange iOS अडैप्टर के 8.2.8.0 वर्शन के साथ काम करता है.
• Google Mobile Ads Unity प्लग इन के 9.1.0 वर्शन के साथ बनाया और टेस्ट किया गया.

3.1.11 वर्शन

• DT Exchange Android अडैप्टर वर्शन 8.2.7.0 पर काम करता है.
• DT Exchange iOS अडैप्टर के 8.2.7.0 वर्शन के साथ काम करता है.
• Google Mobile Ads Unity प्लग इन के 9.1.0 वर्शन के साथ बनाया और टेस्ट किया गया.

3.1.10 वर्शन

• DT Exchange Android अडैप्टर वर्शन 8.2.6.1 पर काम करता है.
• DT Exchange iOS अडैप्टर वर्शन 8.2.7.0 पर काम करता है.
• Google Mobile Ads Unity प्लग इन के 9.0.0 वर्शन के साथ बनाया और टेस्ट किया गया.

वर्शन 3.1.8

• DT Exchange Android अडैप्टर के 8.2.5.0 वर्शन के साथ काम करता है.
• DT Exchange iOS अडैप्टर के 8.2.6.0 वर्शन के साथ काम करता है.
• Google Mobile Ads Unity प्लग इन के 8.6.0 वर्शन के साथ बनाया और टेस्ट किया गया.

वर्शन 3.1.7

• DT Exchange Android अडैप्टर के 8.2.4.0 वर्शन के साथ काम करता है.
• DT Exchange iOS अडैप्टर वर्शन 8.2.4.0 पर काम करता है.
• Google Mobile Ads Unity प्लग इन के 8.5.2 वर्शन के साथ बनाया और टेस्ट किया गया.

3.1.6 वर्शन

• DT Exchange Android अडैप्टर वर्शन 8.2.3.0 पर काम करता है.
• DT Exchange iOS अडैप्टर के 8.2.3.0 वर्शन के साथ काम करता है.
• Google Mobile Ads Unity प्लग इन के 8.4.1 वर्शन के साथ बनाया और टेस्ट किया गया.

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

• DT Exchange Android अडैप्टर वर्शन 8.2.2.0 पर काम करता है.
• DT Exchange iOS अडैप्टर के 8.1.9.1 वर्शन के साथ काम करता है.
• Google Mobile Ads Unity प्लगिन के वर्शन 7.4.1 की मदद से, इसे बनाया और टेस्ट किया गया है.

3.1.3 वर्शन

• DT Exchange Android अडैप्टर के 8.2.1.0 वर्शन के साथ काम करता है.
• DT Exchange iOS अडैप्टर के 8.1.9.0 वर्शन के साथ काम करता है.
• Google Mobile Ads Unity प्लगिन के वर्शन 7.4.0 की मदद से, इसे बनाया और टेस्ट किया गया है.

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

• Fyber क्लास में ये तरीके जोड़े गए:
  • SetCCPAString(string)
  • ClearCCPAString()
• Fyber Android अडैप्टर के 8.2.0.0 वर्शन के साथ काम करता है.
• Fyber iOS अडैप्टर के 8.1.6.0 वर्शन के साथ काम करता है.
• Google Mobile Ads Unity प्लग इन के 7.3.0 वर्शन के साथ बनाया और टेस्ट किया गया.

3.1.0 वर्शन

• Fyber Android अडैप्टर के 8.2.0.0 वर्शन के साथ काम करता है.
• Fyber iOS अडैप्टर के 8.1.5.0 वर्शन के साथ काम करता है.
• Google Mobile Ads Unity प्लगिन के वर्शन 7.2.0 की मदद से, इसे बनाया और टेस्ट किया गया है.

3.0.2 वर्शन

• Fyber Android अडैप्टर के 8.1.3.1 वर्शन के साथ काम करता है.
• Fyber iOS अडैप्टर के 8.1.5.0 वर्शन के साथ काम करता है.
• Google Mobile Ads Unity प्लग इन के 7.0.2 वर्शन के साथ बनाया और टेस्ट किया गया.

वर्शन 3.0.1

• Fyber Android अडैप्टर के 8.1.3.0 वर्शन के साथ काम करता है.
• Fyber iOS अडैप्टर के 8.1.4.0 वर्शन के साथ काम करता है.
• Google Mobile Ads Unity प्लगिन के वर्शन 7.0.0 की मदद से, इसे बनाया और टेस्ट किया गया है.

3.0.0 वर्शन

• Fyber Android अडैप्टर के 8.1.2.0 वर्शन के साथ काम करता है.
• Fyber iOS अडैप्टर के 8.1.2.0 वर्शन के साथ काम करता है.

वर्शन 2.0.0

• Fyber Android अडैप्टर के 7.8.4.1 वर्शन के साथ काम करता है.
• Fyber iOS अडैप्टर वर्शन 8.0.0.0 पर काम करता है.

वर्शन 1.6.1

• Fyber के Android अडैप्टर के 7.8.3.0 वर्शन के साथ काम करता है.
• Fyber iOS अडैप्टर वर्शन 7.8.6.0 पर काम करता है.

वर्शन 1.6.0

• Fyber Android अडैप्टर के 7.8.2.0 वर्शन के साथ काम करता है.
• Fyber iOS अडैप्टर के 7.8.5.0 वर्शन के साथ काम करता है.

1.5.2 वर्शन

• Fyber के Android अडैप्टर के 7.7.4.0 वर्शन के साथ काम करता है.
• Fyber iOS अडैप्टर के 7.7.3.0 वर्शन के साथ काम करता है.

वर्शन 1.5.1

• Fyber के Android अडैप्टर के 7.7.2.0 वर्शन के साथ काम करता है.
• Fyber iOS अडैप्टर वर्शन 7.7.2.0 पर काम करता है.

1.5.0 वर्शन

• Fyber Android अडैप्टर वर्शन 7.7.1.0 पर काम करता है.
• Fyber iOS अडैप्टर वर्शन 7.7.1.0 पर काम करता है.

वर्शन 1.4.0

• Fyber Android अडैप्टर के 7.7.0.0 वर्शन के साथ काम करता है.
• Fyber iOS अडैप्टर वर्शन 7.6.4.0 पर काम करता है.

1.3.0 वर्शन

• Fyber के Android अडैप्टर के 7.6.0.0 वर्शन के साथ काम करता है.
• Fyber iOS अडैप्टर वर्शन 7.6.0.0 पर काम करता है.

वर्शन 1.2.3

• Fyber Android अडैप्टर के वर्शन 7.5.4.0 पर काम करता है.
• Fyber iOS अडैप्टर के 7.5.6.0 वर्शन के साथ काम करता है.

वर्शन 1.2.2

• Fyber Android अडैप्टर वर्शन 7.5.3.0 पर काम करता है.
• Fyber iOS अडैप्टर के 7.5.4.0 वर्शन के साथ काम करता है.

वर्शन 1.2.1

• Fyber Android अडैप्टर वर्शन 7.5.2.0 पर काम करता है.
• Fyber iOS अडैप्टर के 7.5.3.0 वर्शन के साथ काम करता है.

वर्शन 1.2.0

• Fyber के Android अडैप्टर के 7.5.0.0 वर्शन के साथ काम करता है.
• Fyber iOS अडैप्टर के 7.5.1.0 वर्शन के साथ काम करता है.

वर्शन 1.1.0

• जीडीपीआर की ज़रूरी शर्तों को पूरा करने के लिए, Fyber क्लास में ये तरीके जोड़े गए हैं:
  • SetGDPRConsent()
  • SetGDPRConsentString()
  • ClearGDPRConsentData()
• Fyber के Android अडैप्टर के 7.3.4.0 वर्शन के साथ काम करता है.
• Fyber iOS अडैप्टर वर्शन 7.5.0.0 पर काम करता है.

वर्शन 1.0.0

• पहली रिलीज़!
• Fyber के Android अडैप्टर के 7.3.4.0 वर्शन के साथ काम करता है.
• Fyber iOS अडैप्टर के 7.4.0.0 वर्शन के साथ काम करता है.