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

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

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

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

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

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

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

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

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

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

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

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

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

Android

iOS

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

सेटअप

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

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

मेन्यू

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

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

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

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

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

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

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

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

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

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

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

Android

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

iOS

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

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

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

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

Changelog में दिए गए डाउनलोड लिंक से और ZIP फ़ाइल से GoogleMobileAdsFyberMediation.unitypackage निकालें.

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

इसके बाद, ऐसेट > Play Services रिज़ॉल्वर > Android रिज़ॉल्वर > फ़ोर्स रिज़ॉल्व चुनें. Unity Play Services रिज़ॉल्वर लाइब्रेरी, डिपेंडेंसी रिज़ॉल्यूशन को नए सिरे से तैयार करेगी. साथ ही, तय की गई डिपेंडेंसी को आपके 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 मोबाइल विज्ञापन मीडिएशन प्लग इन ने 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 यूनिटी मीडिएशन प्लगिन में बदलाव का लॉग

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