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

प्लैटफ़ॉर्म चुनें: Android (बीटा)

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

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

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

इंटिग्रेशन
बिडिंग
वॉटरफ़ॉल
फ़ॉर्मैट
बैनर वाले विज्ञापन
इंटरस्टीशियल विज्ञापन
इनाम वाले विज्ञापन
नेटिव विज्ञापन

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

iOS डिप्लॉयमेंट का टारगेट 13.0 या इसके बाद का वर्शन होना चाहिए

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

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

अपने myTarget खाते में लॉग इन करें. हेडर में मौजूद ऐप्लिकेशन पर क्लिक करके, ऐप्लिकेशन पेज पर जाएं. ऐप्लिकेशन जोड़ें पर क्लिक करके, अपना ऐप्लिकेशन जोड़ें.

इसके बाद, अपने ऐप्लिकेशन के लिए iTunes यूआरएल दें.

ऐप्लिकेशन जोड़ते समय, myTarget को विज्ञापन यूनिट बनाने की ज़रूरत होती है. इसके बाद ही, प्रोसेस पूरी की जा सकती है.

उपलब्ध विज्ञापन फ़ॉर्मैट में से BANNER चुनें. इसके बाद, विज्ञापन यूनिट जोड़ें बटन पर क्लिक करें.

मध्यवर्ती

उपलब्ध विज्ञापन फ़ॉर्मैट में से, इंटरस्टीशियल चुनें. इसके बाद, विज्ञापन यूनिट जोड़ें बटन पर क्लिक करें.

इनाम दिया गया

उपलब्ध विज्ञापन फ़ॉर्मैट में से, इनाम वाला वीडियो चुनें. इसके बाद, विज्ञापन यूनिट जोड़ें बटन पर क्लिक करें.

मूल भाषा वाला

उपलब्ध विज्ञापन फ़ॉर्मैट में से नेटिव चुनें. इसके बाद, विज्ञापन यूनिट जोड़ें पर क्लिक करें.

अपनी विज्ञापन यूनिट के 'जानकारी' पेज पर, अपने स्लॉट आईडी को नोट करें. यह विज्ञापन यूनिट की सेटिंग में, slot_id के तौर पर मौजूद होता है. इस स्लॉट आईडी का इस्तेमाल, अगले सेक्शन में Ad Manager विज्ञापन यूनिट को सेट अप करने के लिए किया जाएगा.

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

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

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

myTarget के लिए app-ads.txt लागू करने का तरीका जानने के लिए, फ़ाइल बनाने और पब्लिश करने का तरीका लेख पढ़ें.

टेस्ट मोड को चालू करना

myTarget के यूज़र इंटरफ़ेस (यूआई) में टेस्ट डिवाइस जोड़ने और उसे कॉन्फ़िगर करने के लिए, myTarget के दस्तावेज़ में दिए गए निर्देशों का पालन करें.

दूसरा चरण: Ad Manager के यूज़र इंटरफ़ेस में myTarget की डिमांड सेट अप करना

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

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

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

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

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

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

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

अपने-आप होने वाला डेटा कलेक्शन चालू करें. इसके बाद, पिछले सेक्शन में मिला परमानेंट ऐक्सेस टोकन डालें.

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

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

Mail.ru को जीडीपीआर और अमेरिका के राज्यों में लागू कानूनों के तहत विज्ञापन पार्टनरों की सूची में जोड़ना

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

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

Swift Package Manager का इस्तेमाल करना

जारी रखने से पहले, आपके पास कम से कम 5.36.0.0 वर्शन का अडैप्टर होना चाहिए.

अपने प्रोजेक्ट में पैकेज डिपेंडेंसी जोड़ने के लिए, यह तरीका अपनाएं:

Xcode में, File > Add Package Dependencies... पर जाएं.
दिखने वाले प्रॉम्प्ट में, इस पैकेज यूआरएल को खोजें:
```
https://github.com/googleads/googleads-mobile-ios-mediation-mytarget.git
```
डिपेंडेंसी का नियम में जाकर, ब्रांच चुनें.
टेक्स्ट फ़ील्ड में, main डालें.

CocoaPods का इस्तेमाल करना

अपने प्रोजेक्ट की Podfile में यह लाइन जोड़ें:
```
pod 'GoogleMobileAdsMediationMyTarget'
```
कमांड लाइन से यह निर्देश चलाएं:
```
pod install --repo-update
```

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

myTarget SDK का नया वर्शन डाउनलोड करें.
बदलाव की जानकारी में दिए गए डाउनलोड लिंक से, myTarget अडैप्टर का नया वर्शन डाउनलोड करें. इसके बाद, MyTargetAdapter.framework को अपने प्रोजेक्ट में लिंक करें.
अपने प्रोजेक्ट में ये फ़्रेमवर्क जोड़ें:
- CoreLocation
- CoreTelephony
- CoreMedia
- SystemConfiguration
- StoreKit
- AdSupport
- SafariServices
- AVFoundation

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

ईयू उपयोगकर्ता की सहमति से जुड़ी नीति और जीडीपीआर

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

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

Swift

import MyTargetSDK
// ...

MTRGPrivacy.setUserConsent(true)

Objective-C

#import <MyTargetSDK/MyTargetSDK.h>
// ...

[MTRGPrivacy setUserConsent:YES];

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

Swift

import MyTargetSDK
// ...

MTRGPrivacy.setUserAgeRestricted(true)

Objective-C

#import <MyTargetSDK/MyTargetSDK.h>
// ...

[MTRGPrivacy setUserAgeRestricted:YES];

ज़्यादा जानकारी के लिए, myTarget की निजता और जीडीपीआर गाइड देखें. साथ ही, यह भी जानें कि इस तरीके में कौनसी वैल्यू दी जा सकती हैं.

अमेरिका के राज्यों के निजता कानून

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

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

Swift

import MyTargetSDK
// ...

MTRGPrivacy.setCcpaUserConsent(true)

Objective-C

#import <MyTargetSDK/MyTargetSDK.h>
// ...

[MTRGPrivacy setCcpaUserConsent:YES];

ज़्यादा जानकारी के लिए, myTarget की सहायता टीम से संपर्क करें. साथ ही, यह भी जानें कि इस तरीके में कौनसी वैल्यू दी जा सकती हैं.

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

SKAdNetwork इंटिग्रेशन

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

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

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

पक्का करें कि आपने Ad Manager के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो. साथ ही, myTarget यूज़र इंटरफ़ेस (यूआई) में टेस्ट मोड चालू किया हो.

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

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

वैकल्पिक चरण

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

myTarget अडैप्टर, isDebugMode का इस्तेमाल करता है. यह एक वैकल्पिक सुविधा है, जिसका इस्तेमाल लॉगिंग को चालू करने के लिए किया जाता है. इसकी डिफ़ॉल्ट वैल्यू YES होती है. इस पैरामीटर को अडैप्टर को पास किया जा सकता है. इसके लिए, GADMAdapterMyTargetExtras क्लास का इस्तेमाल करें. साथ ही, इसे हर विज्ञापन अनुरोध पर सेट करना होगा. इसे सेट करने का तरीका यहां बताया गया है:

Swift

let request = GAMRequest()
let extras = GADMAdapterMyTargetExtras()
extras.isDebugMode = false
adRequest.register(extras)

Objective-C

GAMRequest *request = [GAMRequest request];
GADMAdapterMyTargetExtras * extras = [[GADMAdapterMyTargetExtras alloc] init];
extras.isDebugMode = NO;
[request registerAdNetworkExtras:extras];

नेटिव विज्ञापनों का इस्तेमाल करना

विज्ञापन रेंडरिंग

myTarget अडैप्टर, अपने नेटिव विज्ञापनों को GADNativeAd ऑब्जेक्ट के तौर पर दिखाता है. यह GADNativeAd के लिए, इन फ़ील्ड की वैल्यू भरता है.

फ़ील्ड	myTarget अडैप्टर से भरा गया
हेडलाइन	हमेशा
इमेज	हमेशा
मुख्य भाग	हमेशा
ऐप्लिकेशन का आइकॉन	हमेशा
कॉल-टू-ऐक्शन	हमेशा
स्टार रेटिंग	कोई गारंटी नहीं है
स्टोर	कोई गारंटी नहीं है
कीमत	कोई गारंटी नहीं है
लोगो	कोई गारंटी नहीं है
विज्ञापन देने वाला	हमेशा

इंप्रेशन और क्लिक ट्रैकिंग

Google Mobile Ads SDK, इंप्रेशन और क्लिक को ट्रैक करने के लिए myTarget SDK के कॉल बैक का इस्तेमाल करता है. इसलिए, दोनों सोर्स की रिपोर्ट में कुछ अंतर हो सकता है या कोई अंतर नहीं हो सकता.

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

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

GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded

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

गड़बड़ी का कोड	कारण
100	myTarget SDK के पास अब तक कोई विज्ञापन उपलब्ध नहीं है.
101	Ad Manager के यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए myTarget सर्वर पैरामीटर मौजूद नहीं हैं या मान्य नहीं हैं.
102	myTarget अडैप्टर, अनुरोध किए गए विज्ञापन फ़ॉर्मैट के साथ काम नहीं करता.
103	myTarget का ऐसा विज्ञापन दिखाने की कोशिश की गई है जो लोड नहीं हुआ है.
104	विज्ञापन का अनुरोध किया गया साइज़, myTarget के साथ काम करने वाले बैनर के साइज़ से मेल नहीं खाता.
105	नेटिव विज्ञापन की ज़रूरी ऐसेट मौजूद नहीं हैं.

myTarget iOS Mediation Adapter के बदलावों की जानकारी