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 में साइन अप करें या लॉग इन करें.

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

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

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

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

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

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

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

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

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

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

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

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

जीडीपीआर और अमेरिका के कानूनों के तहत विज्ञापन पार्टनर की सूची में 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 का CCPA Open Source लेख पढ़ें.

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

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

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

पक्का करें कि आपने 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 वर्शन के साथ काम करता है.