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

प्लैटफ़ॉर्म चुनें: Android iOS Unity Flutter Android (लेगसी)

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

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

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

इंटिग्रेशन
बिडिंग
वॉटरफ़ॉल
फ़ॉर्मैट
बैनर वाले विज्ञापन
इंटरस्टीशियल विज्ञापन
इनाम वाले विज्ञापन
मूल भाषा वाला

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

जारी रखने से पहले, इनकी पुष्टि करें:

  • Google Mobile Ads Unity Plugin का नया वर्शन.
  • Unity Editor का वर्शन 4 या इसके बाद का वर्शन.
  • [बिडिंग के लिए]: बिडिंग में काम करने वाले सभी विज्ञापन फ़ॉर्मैट को इंटिग्रेट करने के लिए, DT Exchange के 3.3.12 या इसके बाद के वर्शन के लिए Google Mobile Ads मीडिएशन प्लगिन का इस्तेमाल करें. हालांकि, हमारा सुझाव है कि आप नए वर्शन का इस्तेमाल करें.
  • Android पर डिप्लॉय करने के लिए
    • Android का एपीआई लेवल 24 या इसके बाद का वर्शन.
  • iOS पर डिप्लॉय करने के लिए
    • iOS डिप्लॉयमेंट का टारगेट 15.0 या इसके बाद का वर्शन होना चाहिए.
  • Google Mobile Ads Unity Plugin के साथ कॉन्फ़िगर किया गया ऐसा Unity प्रोजेक्ट जिस पर काम किया जा सकता हो. ज़्यादा जानकारी के लिए, Google Mobile Ads Unity Plugin सेट अप करना लेख पढ़ें.
  • मीडिएशन सेट अप करें.

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

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

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

    ऐप्लिकेशन जोड़ें पर क्लिक करें.

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

    अपना प्लैटफ़ॉर्म और प्लेसमेंट चुनें. इसके बाद, फ़ॉर्म में बाकी जानकारी भरें और ऐप्लिकेशन बनाएं पर क्लिक करें.

    Android

    iOS

    अपने प्लेसमेंट के नाम डालें और उनके टाइप चुनें. इसके बाद, प्लेसमेंट सेव करें पर क्लिक करें.

    सेटअप

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

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

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

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

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

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

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

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

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

    app-ads.txt फ़ाइल अपडेट करना

    ऐप्लिकेशन के लिए, अनुमति वाले सेलर (app-ads.txt), IAB Tech Lab की एक पहल है. इसकी मदद से यह पक्का किया जा सकता है कि आपके ऐप्लिकेशन की विज्ञापन इन्वेंट्री सिर्फ़ वे चैनल बेचें जिन्हें आपने अनुमति दी है. विज्ञापन से मिलने वाले रेवेन्यू में ज़्यादा नुकसान न हो, इसके लिए आपको app-ads.txt फ़ाइल लागू करनी होगी. अगर आपने अब तक ऐसा नहीं किया है, तो Ad Manager के लिए app-ads.txt फ़ाइल बनाएं.

    DT Exchange के लिए app-ads.txt लागू करने के लिए, DT को अपनी app-ads.txt फ़ाइल में जोड़ें.

    दूसरा चरण: Ad Manager के यूआई में DT Exchange की डिमांड सेट अप करना

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

    Android

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

    iOS

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

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

    Ad Manager के यूज़र इंटरफ़ेस (यूआई) में, यूरोप और अमेरिका के राज्यों के कानूनों के तहत विज्ञापन पार्टनर की सूची में 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 प्रोजेक्ट एडिटर में, Edit > Project Settings > Package Manager को चुनें. इससे Unity Package Manager Settings खुल जाएंगी.

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

    • नाम: OpenUPM
    • URL: https://package.openupm.com
    • स्कोप: com.google

    OpenUPM की जानकारी

    इसके बाद, Window > Package Manager पर जाकर, Unity Package Manager खोलें. इसके बाद, ड्रॉप-डाउन मेन्यू से My Registries को चुनें.

    Unity Registries

    Google Mobile Ads DTExchange Mediation पैकेज चुनें और Install पर क्लिक करें.

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

    Unity पैकेज

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

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

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

    इसके बाद, ऐसेट > External Dependency Manager > Android Resolver > Force Resolve को चुनें. External Dependency Manager लाइब्रेरी, डिपेंडेंसी को शुरू से हल करेगी. साथ ही, एलान की गई डिपेंडेंसी को आपके Unity ऐप्लिकेशन की Assets/Plugins/Android डायरेक्ट्री में कॉपी करेगी.

    समस्या को ज़बरदस्ती हल करना

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

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

    DT Exchange Unity अडैप्टर का वर्शन 3.3.0 और इसके बाद के वर्शन, जीडीपीआर के तहत सहमति के सिग्नल पास करने की सुविधा देते हैं. ये सिग्नल, सहमति मैनेजमेंट प्लैटफ़ॉर्म से DT Exchange SDK टूल को पास किए जाते हैं. ये प्लैटफ़ॉर्म, IAB के पारदर्शिता और सहमति फ़्रेमवर्क (टीसीएफ़) के साथ इंटिग्रेट होते हैं. ज़्यादा जानकारी के लिए, Android और iOS के लिए जीडीपीआर से जुड़े दस्तावेज़ देखें.

    अमेरिका के राज्यों के निजता कानून

    अमेरिका के राज्यों के निजता कानूनों के मुताबिक, उपयोगकर्ताओं को अपनी "निजी जानकारी" (जैसा कि कानून में परिभाषित है) की "बिक्री" से ऑप्ट आउट करने का अधिकार मिलना चाहिए. ऑप्ट आउट का विकल्प देने के लिए, "बिक्री करने वाले" पक्ष को अपने होम पेज पर "मेरी निजी जानकारी न बेचें" का लिंक प्रमुखता से दिखाना होगा. अमेरिका के राज्यों के निजता कानूनों का पालन करने से जुड़ी गाइड में, 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 के दस्तावेज़ पढ़ें.

    छठा चरण: लागू किए गए बदलावों की जांच करना

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

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

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

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

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

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

    Android

    com.google.ads.mediation.fyber.FyberMediationAdapter

    iOS

    GADMediationAdapterFyber

    विज्ञापन लोड न होने पर, DT Exchange अडैप्टर से मिलने वाले कोड और उनसे जुड़े मैसेज यहां दिए गए हैं:

    Android

    गड़बड़ी का कोड वजह
    101 Ad Manager के यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए DT Exchange सर्वर पैरामीटर मौजूद नहीं हैं या मान्य नहीं हैं.
    103 जिस विज्ञापन साइज़ का अनुरोध किया गया है वह DT Exchange के साथ काम करने वाले बैनर के साइज़ से मेल नहीं खाता है.
    105 DT SDK ने एक विज्ञापन लोड किया, लेकिन उसे एक अनचाहा कंट्रोलर मिला.
    106 विज्ञापन दिखाने के लिए तैयार नहीं है.
    107 कॉन्टेक्स्ट, गतिविधि का इंस्टेंस नहीं है.
    108 विज्ञापन नहीं दिखाया जा सका.
    200-399 DT SDK से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, कोड देखें.

    iOS

    गड़बड़ी का कोड कारण
    0-10 DT SDK से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, दस्तावेज़ देखें.
    101 Ad Manager के यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए DT Exchange सर्वर पैरामीटर मौजूद नहीं हैं या मान्य नहीं हैं.
    102 जिस विज्ञापन साइज़ का अनुरोध किया गया है वह DT Exchange के साथ काम करने वाले बैनर के साइज़ से मेल नहीं खाता है.
    103 विज्ञापन नहीं दिखाया जा सका, क्योंकि विज्ञापन ऑब्जेक्ट का इस्तेमाल पहले ही किया जा चुका है.
    104 विज्ञापन तैयार न होने की वजह से, DT Exchange के विज्ञापन नहीं दिखाए जा सके.
    105 शुरू करने के दौरान, DT SDK टूल से गड़बड़ी का मैसेज मिला.

    DT Exchange Unity Mediation Plugin के बदलावों का लॉग

    वर्शन 3.6.0 (डेवलपमेंट में है)

    वर्शन 3.5.13

    वर्शन 3.5.12

    वर्शन 3.5.11

    वर्शन 3.5.10

    वर्शन 3.5.9

    वर्शन 3.5.8

    वर्शन 3.5.7

    वर्शन 3.5.6

    वर्शन 3.5.5

    वर्शन 3.5.4

    वर्शन 3.5.3

    वर्शन 3.5.2

    वर्शन 3.5.1

    वर्शन 3.5.0

    वर्शन 3.4.0

    वर्शन 3.3.12

    वर्शन 3.3.11

    वर्शन 3.3.10

    वर्शन 3.3.9

    वर्शन 3.3.8

    वर्शन 3.3.7

    वर्शन 3.3.6

    वर्शन 3.3.5

    वर्शन 3.3.4

    वर्शन 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 mediation प्लगिन का नाम बदलकर "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

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

    वर्शन 1.0.0