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

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

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

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

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

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

इंटिग्रेशन
बिडिंग
झरना
फ़ॉर्मैट
बैनर
मध्यवर्ती
इनाम दिया गया
मूल भाषा वाला

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

iOS 12.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 के लिए कोई मैपिंग है, तो उसे चुना जा सकता है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें पर क्लिक करें.

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

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

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

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

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

CocoaPods का इस्तेमाल करना (सुझाया गया)

अपने प्रोजेक्ट की Podfile में यह लाइन जोड़ें:

pod 'GoogleMobileAdsMediationFyber'

कमांड लाइन से यह निर्देश चलाएं:

pod install --repo-update

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

iOS के लिए DT Exchange SDK का नया वर्शन डाउनलोड करें और IASDKCore.xcframework को लिंक करें.
बदलाव की जानकारी में दिए गए डाउनलोड लिंक से, DT Exchange अडैप्टर का नया वर्शन डाउनलोड करें. इसके बाद, इसे अपने प्रोजेक्ट में लिंक करें.DTExchangeAdapter.xcframework

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

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

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

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

Swift

import IASDKCore
// ...

IASDKCore.sharedInstance().gdprConsent = IAGDPRConsentType.given
IASDKCore.sharedInstance().gdprConsentString = "myGdprConsentString"

Objective-C

#import <IASDKCore/IASDKCore.h>
// ...

[IASDKCore.sharedInstance setGDPRConsent:YES];
[IASDKCore.sharedInstance setGDPRConsentString:@"myGdprConsentString"];

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

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

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

Swift

import IASDKCore
// ...

IASDKCore.sharedInstance().ccpaString = "myCCPAConsentString"

Objective-C

#import <IASDKCore/IASDKCore.h>
// ...

[IASDKCore.sharedInstance setCCPAString:@"myCCPAConsentString"];

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

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

SKAdNetwork इंटिग्रेशन

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

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

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

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

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

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

वैकल्पिक चरण

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

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

अनुरोध के पैरामीटर और वैल्यू
`setUserData` उपयोगकर्ता की उम्र, लिंग, और पिन कोड.	`IAUserData`
`setMuteAudio`	Boolean. वीडियो को म्यूट या अनम्यूट करना

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

Swift

let userData = IAUserData.build({ builder in
  builder.age = 23
  builder.gender = IAUserGenderType.male
  builder.zipCode = "1234"
}];

let request = GADRequest()
let extras = GADMAdapterFyberExtras()
extras.userData = userData
extras.muteAudio = true
request.register(extras)

Objective-C

IAUserData *userData = [IAUserData build:^(id<IAUserDataBuilder> _Nonnull builder) {
    builder.age = 23;
    builder.gender = IAUserGenderTypeMale;
    builder.zipCode = @"1234";
}];

GADRequest *request = [GADRequest request];
GADMAdapterFyberExtras *extras = [[GADMAdapterFyberExtras alloc] init];
extras.userData = userData;
extras.muteAudio = YES;
[request registerAdNetworkExtras:extras];

ज़्यादा जानकारी के लिए, DT Exchange इंटिग्रेशन गाइड देखें.

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

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

GADMediationAdapterFyber

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

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