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

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

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

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

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

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

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

आगे बढ़ने से पहले, यह पुष्टि करें कि:

  • सबसे नया Google Mobile Ads Flutter Plugin वर्शन.
  • Flutter फ़्रेमवर्क का वर्शन 3.7.0 या इसके बाद का वर्शन इंस्टॉल हो.
  • Android पर डिप्लॉय करने के लिए
    • Android का एपीआई लेवल 24 या इसके बाद का वर्शन इंस्टॉल हो.
  • iOS पर डिप्लॉय करने के लिए
    • iOS डिप्लॉयमेंट का टारगेट 15.0 या इसके बाद का वर्शन हो.
  • Google Mobile Ads Flutter प्लगिन Google Mobile Ads Flutter Plugin के साथ कॉन्फ़िगर किया गया ऐसा Flutter प्रोजेक्ट जिस पर काम किया जा सकता हो. ज़्यादा जानकारी के लिए, सेट अप Google Mobile Ads Flutter 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 और अडैप्टर को इंपोर्ट करना

    pub.dev के ज़रिए इंटिग्रेशन

    अपने पैकेज की pubspec.yaml फ़ाइल में, DT Exchange SDK और अडैप्टर के सबसे नए वर्शन के साथ यह डिपेंडेंसी जोड़ें:

    dependencies:
  gma_mediation_dtexchange: ^1.3.7

    मैन्युअल इंटिग्रेशन

    DT Exchange के लिए, Google Mobile Ads मीडिएशन प्लगिन का सबसे नया वर्शन डाउनलोड करें. इसके बाद, डाउनलोड की गई फ़ाइल को एक्सट्रैक्ट करें. अब एक्सट्रैक्ट किए गए प्लगिन फ़ोल्डर (और उसके कॉन्टेंट) को अपने Flutter प्रोजेक्ट में जोड़ें. इसके बाद, अपनी pubspec.yaml फ़ाइल में प्लगिन का रेफ़रंस दें. इसके लिए, यह डिपेंडेंसी जोड़ें:

    dependencies:
  gma_mediation_dtexchange:
    path: path/to/local/package

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

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

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

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

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

    DT Exchange के लिए, Google Mobile Ads मीडिएशन प्लगिन, DT Exchange SDK को सहमति की जानकारी पास नहीं करता है.

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

    Android

    DT Exchange के इंटिग्रेशन के लिए, किसी अन्य कोड की ज़रूरत नहीं है.

    iOS

    SKAdNetwork इंटिग्रेशन

    अपने प्रोजेक्ट की Info.plist फ़ाइल में SKAdNetwork आइडेंटिफ़ायर जोड़ने के लिए, DT Exchange's documentation पढ़ें.

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

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

    पक्का करें कि आपने 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 Flutter मीडिएशन अडैप्टर के बदलावों की जानकारी

    वर्शन 1.3.7

    वर्शन 1.3.6

    वर्शन 1.3.5

    वर्शन 1.3.4

    • Flutter के ज़रूरी वर्शन को 3.38.1 पर अपडेट किया गया है
    • Google Mobile Ads Flutter प्लगिन के वर्शन 8.0.0 के साथ काम करने के लिए अपडेट किया गया है

    वर्शन 1.3.3

    वर्शन 1.3.2

    वर्शन 1.3.1

    वर्शन 1.2.0

    वर्शन 1.1.5

    वर्शन 1.1.4

    वर्शन 1.1.3

    वर्शन 1.1.2

    वर्शन 1.1.1

    वर्शन 1.1.0

    वर्शन 1.0.0