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

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

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

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

myTarget के लिए Ad Manager मीडिएशन अडैप्टर में ये क्षमताएं हैं:

इंटिग्रेशन
बिडिंग
वॉटरफ़ॉल
फ़ॉर्मैट
बैनर
मध्यवर्ती
इनाम दिया गया
नेटिव लेआउट

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

Android API का लेवल 19 या उसके बाद वाला वर्शन

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

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

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

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

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

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

मध्यवर्ती

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

इनाम दिया गया

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

नेटिव लेआउट

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

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

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

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

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

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

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

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

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

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

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

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

विज्ञापन नेटवर्क के तौर पर myTarget चुनें और यूनीक नाम डालें. साथ ही, मीडिएशन की सुविधा चालू करें.

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

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

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

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

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

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

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

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.0")
    implementation("com.google.ads.mediation:mytarget:5.20.0.0")
}

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

myTarget SDK को शामिल करने के लिए, myTarget Android SDK दस्तावेज़ देखें.
Google की मेवन रिपॉज़िटरी में myTarget अडैप्टर आर्टफ़ैक्ट पर जाएं. सबसे नया वर्शन चुनें, myTarget अडैप्टर की .aar फ़ाइल डाउनलोड करें, और उसे अपने प्रोजेक्ट में जोड़ें.

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

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

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

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

Java

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setUserConsent(true);

Kotlin

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setUserConsent(true)

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

Java

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setUserAgeRestricted(true);

Kotlin

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setUserAgeRestricted(true)

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

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

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

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

Java

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setCcpaUserConsent(true);

Kotlin

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setCcpaUserConsent(true)

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

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

myTarget इंटिग्रेशन के लिए किसी और कोड की ज़रूरत नहीं है.

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

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

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

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

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

वैकल्पिक चरण

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

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

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

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

myTarget SDK हमेशा mediaView की चौड़ाई और ऊंचाई के लिए 0 दिखाता है, इसलिए myTarget अडैप्टर हमेशा getAspectRatio() के लिए 0 दिखाता है. myTarget SDK इस समस्या को आने वाले रिलीज़ में ठीक करेगा.

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

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

गड़बड़ी कोड

अगर अडैप्टर को myTarget से विज्ञापन नहीं मिलता है, तो विज्ञापन के रिस्पॉन्स में होने वाली गड़बड़ी की जांच की जा सकती है. इसके लिए, ResponseInfo.getAdapterResponse() पर जाकर, यहां दिए गए क्लास में जाएं:

com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter

जब कोई विज्ञापन लोड नहीं हो पाता है, तब myTarget अडैप्टर से जो कोड और उसके साथ भेजे जाने वाले मैसेज अपलोड किए जाते हैं:

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