हमारे प्रॉडक्ट के बारे में चर्चा करने और सुझाव/राय देने के लिए, Google Advertising and Measurement Community सर्वर में AdMob के आधिकारिक Discord चैनल से जुड़ें.

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

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

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

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

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

इंटिग्रेशन
बिडिंग	¹
झरना
फ़ॉर्मैट
बैनर
इंटरस्टीशियल विज्ञापन
इनाम दिया गया	²
मूल भाषा वाला

¹ बिडिंग इंटिग्रेशन, क्लोज़्ड बीटा वर्शन में उपलब्ध है. इसका ऐक्सेस पाने के लिए, अपने खाता मैनेजर से संपर्क करें.

² इनाम वाले विज्ञापन, सिर्फ़ वॉटरफ़ॉल मीडिएशन में काम करते हैं.

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

Android का एपीआई लेवल 23 या इसके बाद का वर्शन
[बिडिंग के लिए]: बिडिंग में काम करने वाले सभी विज्ञापन फ़ॉर्मैट को इंटिग्रेट करने के लिए, DT Exchange adapter 8.3.8.0 या इसके बाद के वर्शन का इस्तेमाल करें (नया वर्शन इस्तेमाल करने का सुझाव दिया जाता है).

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

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

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

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

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

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

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

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

सेटअप

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

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

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

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

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

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

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

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

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

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

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

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

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

आपको अपनी विज्ञापन यूनिट के लिए, मीडिएशन कॉन्फ़िगरेशन में DT Exchange को जोड़ना होगा.

सबसे पहले, अपने AdMob खाते में साइन इन करें. इसके बाद, मीडिएशन टैब पर जाएं. अगर आपको किसी मौजूदा मीडिएशन ग्रुप में बदलाव करना है, तो उस मीडिएशन ग्रुप के नाम पर क्लिक करके उसमें बदलाव करें. इसके बाद, DT Exchange को विज्ञापन सोर्स के तौर पर जोड़ें पर जाएं.

नया मीडिएशन ग्रुप बनाने के लिए, मीडिएशन ग्रुप बनाएं को चुनें.

विज्ञापन का फ़ॉर्मैट और प्लैटफ़ॉर्म डालें. इसके बाद, जारी रखें पर क्लिक करें.

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

इस मीडिएशन ग्रुप को अपनी मौजूदा AdMob विज्ञापन यूनिट में से एक या उससे ज़्यादा से जोड़ें. इसके बाद, हो गया पर क्लिक करें.

अब आपको विज्ञापन यूनिट का कार्ड दिखेगा. इसमें आपकी चुनी गई विज्ञापन यूनिट दिखेंगी:

DT Exchange को विज्ञापन सोर्स के तौर पर जोड़ना

बिडिंग

विज्ञापन सोर्स सेक्शन में मौजूद बिडिंग कार्ड में जाकर, विज्ञापन सोर्स जोड़ें को चुनें. इसके बाद, DT Exchange चुनें .

DT Exchange के साथ पार्टनरशिप के कानूनी समझौते पर हस्ताक्षर करने का तरीका जानने के लिए, यहां क्लिक करें. साथ ही, बिडिंग पार्टनरशिप सेट अप करें.

स्वीकार करें और सहमत हों पर क्लिक करें. इसके बाद, जारी रखें पर क्लिक करें.

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

इसके बाद, पिछले सेक्शन में मिला ऐप्लिकेशन आईडी और प्लेसमेंट आईडी डालें. इसके बाद, हो गया पर क्लिक करें.

झरना

विज्ञापन सोर्स सेक्शन में मौजूद, वॉटरफ़ॉल कार्ड में जाकर, विज्ञापन सोर्स जोड़ें को चुनें.

DT Exchange को चुनें और ऑप्टिमाइज़ करें स्विच को चालू करें. DT Exchange के लिए विज्ञापन सोर्स ऑप्टिमाइज़ेशन सेट अप करने के लिए, पिछले सेक्शन में मिले पब्लिशर आईडी, उपयोगकर्ता सीक्रेट, और उपयोगकर्ता कुंजी डालें. इसके बाद, DT Exchange के लिए ईसीपीएम वैल्यू डालें और जारी रखें पर क्लिक करें.

ध्यान दें: विज्ञापन सोर्स ऑप्टिमाइज़ेशन को, मीडिएशन नेटवर्क के लिए eCPM का सटीक हिसाब लगाने के लिए ज़रूरी डेटा इकट्ठा करने में कुछ दिन लगते हैं. इस बीच, विज्ञापन सोर्स के ऑप्टिमाइज़ेशन की स्थिति PENDING है. इसलिए, आपको नेटवर्क के लिए मैन्युअल तरीके से ईसीपीएम वैल्यू सेट करनी होगी. ईसीपीएम का हिसाब लगाने के बाद, विज्ञापन सोर्स आपकी ओर से ईसीपीएम को अपने-आप अपडेट करना शुरू कर देता है.

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

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

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

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

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

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

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

Android के लिए DT SDK का नया वर्शन डाउनलोड करें और अपने प्रोजेक्ट में fyber-marketplace-x.y.z.aar जोड़ें.
Google की मेवन रिपॉज़िटरी पर, DT Exchange adapter artifacts पर जाएं. नया वर्शन चुनें. इसके बाद, DT Exchange अडैप्टर की .aar फ़ाइल डाउनलोड करें और उसे अपने प्रोजेक्ट में जोड़ें.

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

ईयू में रहने वाले उपयोगकर्ताओं की सहमति और जीडीपीआर

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

DT Exchange में एक ऐसा एपीआई होता है जिसकी मदद से, उपयोगकर्ता की सहमति को उनके एसडीके पर फ़ॉरवर्ड किया जा सकता है. यहां दिए गए सैंपल कोड में, सहमति की जानकारी को DT SDK में मैन्युअल तरीके से पास करने का तरीका बताया गया है. अगर आपको सहमति की जानकारी को DT 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 की GDPR लागू करने की गाइड देखें.

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

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

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

गतिविधि के संदर्भ के साथ विज्ञापन लोड करना

पेज पर अचानक दिखने वाले विज्ञापन फ़ॉर्मैट लोड करते समय, Activity कॉन्टेक्स्ट पास करें. गतिविधि के कॉन्टेक्स्ट के बिना, विज्ञापन लोड नहीं होगा.

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

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

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

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

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

वैकल्पिक चरण

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

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

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

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

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)

val request = AdRequest.Builder()
   .addNetworkExtrasBundle(FyberMediationAdapter::class.java, extras)
   .build()

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

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

com.google.ads.mediation.fyber.FyberMediationAdapter

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

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