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

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

इस गाइड में, मीडिएशन का इस्तेमाल करके, 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 में साइन अप करें या लॉग इन करें.

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

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

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

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

सेटअप

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

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

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

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

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

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

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

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

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

दूसरा चरण: Ad Manager के यूज़र इंटरफ़ेस में, DT Exchange की मांग सेट अप करना

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

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

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

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

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

अगर आपके पास पहले से ही डीटी एक्सचेंज के लिए नतीजे देने वाला पार्टनर है, तो उसे चुना जा सकता है. इसके अलावा, नया यील्ड पार्टनर बनाएं को चुनें.

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

डेटा अपने-आप इकट्ठा होने की सुविधा चालू करें. इसके बाद, पिछले सेक्शन में मिले पब्लिशर आईडी, कंज्यूमर सीक्रेट, और कंज्यूमर पासकोड डालें.

यील्ड पार्टनर चुनने के बाद, इंटिग्रेशन टाइप के तौर पर Mobile SDK मीडिएशन, प्लैटफ़ॉर्म के तौर पर iOS, और स्टेटस के तौर पर चालू है चुनें. पिछले सेक्शन में मिला ऐप्लिकेशन आईडी और प्लेसमेंट आईडी डालें. इसके बाद, डिफ़ॉल्ट सीपीएम वैल्यू डालें.

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

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

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

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

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

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

pod 'GoogleMobileAdsMediationFyber'

कमांड लाइन से चलाएं:

pod install --repo-update

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

iOS के लिए DT Exchange SDK टूल का नया वर्शन डाउनलोड करें और अपने प्रोजेक्ट में ये फ़्रेमवर्क लिंक करें:
- IASDKCore.framework
- IASDKMRAID.framework
- IASDKVideo.framework
बदलावों की जानकारी में दिए गए डाउनलोड लिंक से, DT Exchange अडैप्टर का नया वर्शन डाउनलोड करें और अपने प्रोजेक्ट में FyberAdapter.framework को लिंक करें.
अपने प्रोजेक्ट में ये फ़्रेमवर्क जोड़ें:
- libxml2.2.tbd

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

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

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

DT Exchange में एक एपीआई होता है, जिसकी मदद से उपयोगकर्ता की सहमति को उनके SDK टूल पर भेजा जा सकता है. यहां दिए गए सैंपल कोड में, 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 के जीडीपीआर संसाधन पेज और जीडीपीआर लागू करने की गाइड पर जाएं.

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

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

Swift

import IASDKCore
// ...

IASDKCore.sharedInstance().ccpaString = "myCCPAConsentString"

Objective-C

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

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

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

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

SKAdNetwork इंटिग्रेशन

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

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

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

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

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

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

वैकल्पिक चरण

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

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

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

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

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