इस पेज का अनुवाद Cloud Translation API से किया गया है.

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

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

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

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

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

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

Android API का लेवल 19 या उसके बाद वाला वर्शन

नया Google Mobile Ads SDK
मीडिएशन को पूरा करें शुरुआती निर्देश

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

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

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

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

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

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

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

सेटअप

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

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

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

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

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

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

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

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

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

दूसरा चरण: Ad Manager यूज़र इंटरफ़ेस (यूआई) में DT Exchange डिमांड सेट अप करना

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

अपने Ad Manager खाते में साइन इन करें.

डिलीवरी > यील्ड ग्रुप पर जाएं और नया यील्ड ग्रुप बटन पर क्लिक करें.

अपने ईल्ड ग्रुप के लिए यूनीक नाम डालें, स्थिति को चालू है पर सेट करें, विज्ञापन फ़ॉर्मैट चुनें, और इन्वेंट्री टाइप को मोबाइल ऐप्लिकेशन पर सेट करें. टारगेटिंग > इन्वेंट्री सेक्शन में, इन्वेंट्री और मोबाइल ऐप्लिकेशन में विज्ञापन यूनिट चुनें, जिसमें आपको मीडिएशन जोड़ना है.

इसके बाद, ईल्ड पार्टनर जोड़ें बटन पर क्लिक करें.

अगर आपके पासDT Exchangeके लिए पहले से कोई यील्ड पार्टनर है, तो उसे चुनें. अगर ऐसा नहीं है, तो नया ईल्ड पार्टनर बनाएं चुनें.

विज्ञापन नेटवर्क के तौर पर DT Exchange चुनें और यूनीक नाम डालें. साथ ही, मीडिएशन की सुविधा चालू करें.

अपने-आप डेटा इकट्ठा होने की सुविधा को चालू करें और पिछले सेक्शन में मौजूद Publisher ID, Consumer Secret and Consumer Key को डालें.

यील्ड पार्टनर चुनने के बाद, इंटिग्रेशन टाइप के तौर पर मोबाइल SDK टूल मीडिएशन, प्लैटफ़ॉर्म के तौर पर Android, और स्टेटस के तौर पर ऐक्टिव चुनें. पिछले सेक्शन में दिए गए Application ID and Placement ID कोड को डालें. इसके बाद, डिफ़ॉल्ट सीपीएम वैल्यू डालें.

इसके बाद, पेज पर सबसे नीचे सेव करें पर क्लिक करें.

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

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

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

Android Studio इंटिग्रेशन (सुझाया गया)

अपने ऐप्लिकेशन-लेवल की build.gradle.kts फ़ाइल में, लागू करने की ये डिपेंडेंसी और कॉन्फ़िगरेशन जोड़ें. DT Exchange SDK और अडैप्टर के सबसे नए वर्शन का इस्तेमाल करें:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.0")
    implementation("com.google.ads.mediation:fyber:8.2.6.0")
}

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

Android के लिए DT Exchange SDK टूल का सबसे नया वर्शन डाउनलोड करें और अपने प्रोजेक्ट में ये फ़ाइलें जोड़ें:
- ia-mraid-kit-release-x.y.z.aar
- ia-sdk-core-release-x.y.z.aar
- ia-video-kit-release-x.y.z.aar
Google की Maven रिपॉज़िटरी में DT Exchange अडैप्टर आर्टफ़ैक्ट पर जाएं. सबसे नया वर्शन चुनें, DT एक्सचेंज के अडैप्टर की .aar फ़ाइल डाउनलोड करें, और उसे अपने प्रोजेक्ट में जोड़ें.

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

ईयू (यूरोपीय संघ) की सहमति और जीडीपीआर

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

DT Exchange में एक एपीआई होता है. इसकी मदद से, उपयोगकर्ता की सहमति को उसके SDK टूल पर भेजा जा सकता है. यहां दिए गए सैंपल कोड में, DT Exchange SDK को मैन्युअल तरीके से सहमति की जानकारी भेजने का तरीका बताया गया है. अगर आपको मैन्युअल तरीके से DT Exchange SDK को सहमति की जानकारी भेजने का विकल्प मिलता है, तो हमारा सुझाव है कि Google Mobile Ads SDK से विज्ञापनों का अनुरोध करने से पहले, इस कोड को कॉल करें.

Java

import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...

InneractiveAdManager.setGdprConsent(true);
InneractiveAdManager.setGdprConsentString("myGdprConsentString");

Kotlin

import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...

InneractiveAdManager.setGdprConsent(true)
InneractiveAdManager.setGdprConsentString("myGdprConsentString")

ज़्यादा जानकारी और इस तरीके में दी जा सकने वाली वैल्यू के लिए, DT Exchange के जीडीपीआर रिसॉर्स पेज और उनकी जीडीपीआर लागू करने की गाइड पर जाएं.

अमेरिका के निजता कानून

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

Java

import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString");

Kotlin

import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString")

ज़्यादा जानकारी और इस तरीके में दी जा सकने वाली वैल्यू के लिए, DT Exchange के सीसीपीए संसाधन पेज और उनकी सीसीपीए को लागू करने की गाइड पर जाएं.

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

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

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

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

पक्का करें कि आपने Ad Manager.

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

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

वैकल्पिक चरण

नेटवर्क के हिसाब से पैरामीटर

DT Exchange अडैप्टर दूसरे अनुरोध पैरामीटर के साथ काम करता है, जिन्हें अडैप्टर को Android बंडल के रूप में भेजा जा सकता है. अडैप्टर, बंडल में नीचे दी गई कुंजियों की जांच करता है:

पैरामीटर और वैल्यू का अनुरोध करें
`InneractiveMediationDefs.KEY_AGE`	पूरी संख्या. उपयोगकर्ता की उम्र
`FyberMediationAdapter.KEY_MUTE_VIDEO`	बूलियन. वीडियो को म्यूट या अनम्यूट करें

यहां विज्ञापन अनुरोध के इन पैरामीटर को सेट करने के तरीके का एक उदाहरण दिया गया है:

Java

Bundle extras = new Bundle();
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10);
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false);

AdRequest request = new AdRequest.Builder()
       .addNetworkExtrasBundle(FyberMediationAdapter.class, extras)
       .build();

Kotlin

var extras = Bundle()
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10)
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false)

var adrequest = AdRequest.Builder()
       .addNetworkExtrasBundle(FyberMediationAdapter::class.java, extras)
       .build()

गड़बड़ी कोड

अगर अडैप्टर को DT Exchange से कोई विज्ञापन नहीं मिलता, तो आप इस क्लास में ResponseInfo.getAdapterResponses() का इस्तेमाल करके, विज्ञापन रिस्पॉन्स में होने वाली गड़बड़ी देख सकते हैं:

com.google.ads.mediation.fyber.FyberMediationAdapter

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

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