हमारे प्रॉडक्ट के बारे में चर्चा करने और सुझाव/राय देने के लिए, Google विज्ञापन और मेज़रमेंट कम्यूनिटी सर्वर में Ad Manager के आधिकारिक Discord चैनल से जुड़ें.

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

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

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

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

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

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

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

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

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

iOS डिप्लॉयमेंट का टारगेट 12.0 या इसके बाद का होना चाहिए
[बिडिंग के लिए]: बिडिंग में काम करने वाले सभी विज्ञापन फ़ॉर्मैट को इंटिग्रेट करने के लिए, 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 फ़ाइल लागू करनी होगी. अगर आपने अब तक ऐसा नहीं किया है, तो Ad Manager के लिए app-ads.txt फ़ाइल बनाएं.

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

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

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

'कंपनियां' सेक्शन में DT Exchange जोड़ना

बिडिंग

बिडिंग इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.

झरना

एडमिन > कंपनियां पर जाएं. इसके बाद, सभी कंपनियां टैब में मौजूद, नई कंपनी बटन पर क्लिक करें. विज्ञापन नेटवर्क चुनें.

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

आपको उपयोगकर्ता नाम या पासवर्ड डालने की ज़रूरत नहीं है. बदलाव पूरा होने पर, सेव करें पर क्लिक करें.

सुरक्षित सिग्नल शेयरिंग की सुविधा चालू करना

बिडिंग

एडमिन > ग्लोबल सेटिंग पर जाएं. Ad Exchange खाते की सेटिंग टैब पर जाएं. इसके बाद, सुरक्षित तरीके से सिग्नल शेयर करने की सुविधा की समीक्षा करें और इसे टॉगल करके चालू करें. सेव करें पर क्लिक करें.

झरना

वॉटरफ़ॉल इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.

बिड अनुरोधों पर सुरक्षित सिग्नल शेयर करें

बिडिंग

इन्वेंट्री > सुरक्षित सिग्नल पर जाएं. सुरक्षित सिग्नल में जाकर, DT Exchange (Fyber Monetization) खोजें. इसके बाद, ऐप्लिकेशन इंटिग्रेशन चालू करें को टॉगल करके चालू करें.

सेव करें पर क्लिक करें.

झरना

वॉटरफ़ॉल इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.

एसडीके बिडिंग के लिए, सुरक्षित सिग्नल शेयरिंग की सुविधा को अनुमति देना

बिडिंग

डिलीवरी > डिमांड चैनल की सेटिंग पर जाएं. डिफ़ॉल्ट सेटिंग टैब में, एसडीके बिडिंग के लिए, सुरक्षित सिग्नल शेयर करने की अनुमति दें को टॉगल करके चालू करें.

सेव करें पर क्लिक करें.

झरना

वॉटरफ़ॉल इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.

DT Exchange की बिडिंग को कॉन्फ़िगर करना

बिडिंग

विज्ञापन डिलीवरी > बिड करने वाले पर जाएं. इसके बाद, SDK Bidding पर जाएं पर क्लिक करें.

नया बिडर पर क्लिक करें.

बिडर के तौर पर DT Exchange चुनें.

बिड करने वाले इस व्यक्ति के लिए SDK Bidding की सुविधा चालू करने के लिए, जारी रखें पर क्लिक करें.

हो गया पर क्लिक करें.

झरना

वॉटरफ़ॉल इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.

विज्ञापन यूनिट को मैप करने की सुविधा कॉन्फ़िगर करना

बिडिंग

DT Exchange के लिए कंपनी चुनें.

विज्ञापन यूनिट की मैपिंग टैब पर जाएं. इसके बाद, विज्ञापन यूनिट की नई मैपिंग पर क्लिक करें.

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

झरना

डिलीवरी > यील्ड ग्रुप पर जाएं. इसके बाद, नया यील्ड ग्रुप बटन पर क्लिक करें. अपना मोबाइल ऐप्लिकेशन चुनें.

नीचे की ओर स्क्रोल करें और यील्ड पार्टनर जोड़ें पर क्लिक करें.

पिछले सेक्शन में, DT Exchange के लिए बनाई गई कंपनी चुनें. इंटिग्रेशन टाइप के तौर पर मोबाइल एसडीके मीडिएशन, प्लैटफ़ॉर्म के तौर पर iOS, और स्टेटस के तौर पर चालू है चुनें.

पिछले सेक्शन में मिले ऐप्लिकेशन आईडी और प्लेसमेंट आईडी डालें. साथ ही, डिफ़ॉल्ट सीपीएम की वैल्यू डालें. सेव करें पर क्लिक करें.

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

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

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

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

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

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

pod 'GoogleMobileAdsMediationFyber'

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

pod install --repo-update

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

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

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

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

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

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

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

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

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

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

यह पुष्टि करने के लिए कि आपको DT Exchange से टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन जांचने वाले टूल में 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 = GAMRequest()
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";
}];

GAMRequest *request = [GAMRequest 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 SDK टूल से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, दस्तावेज़ देखें.
101	Ad Manager के यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए DT Exchange सर्वर पैरामीटर मौजूद नहीं हैं या अमान्य हैं.
102	विज्ञापन के लिए अनुरोध किया गया साइज़, DT Exchange के साथ काम करने वाले बैनर के साइज़ से मेल नहीं खाता.
103	विज्ञापन नहीं दिखाया जा सका, क्योंकि विज्ञापन ऑब्जेक्ट का इस्तेमाल पहले ही किया जा चुका है.
104	विज्ञापन तैयार न होने की वजह से, DT Exchange के विज्ञापन नहीं दिखाए जा सके.
105	DT SDK टूल से, शुरू करने के दौरान गड़बड़ी का मैसेज मिला.