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

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

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

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

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

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

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

Android एपीआई लेवल 21 या उसके बाद का वर्शन

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

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

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

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

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

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

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

मध्यवर्ती

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

इनाम दिया गया

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

मूल भाषा वाला

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

myTarget SDK टूल को शामिल करने के लिए, myTarget Android SDK टूल के दस्तावेज़ देखें.
Google के Maven Repository पर, 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 ने उपयोगकर्ता की सहमति लेने के लिए API जोड़ा है. इससे निजता से जुड़ी ज़रूरी शर्तों को पूरा करने में मदद मिलती है. यहां दिए गए सैंपल कोड में, सहमति की इस जानकारी को 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 इंटिग्रेशन के लिए, किसी अन्य कोड की ज़रूरत नहीं है.

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

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

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

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

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

वैकल्पिक चरण

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

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

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

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

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

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

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

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

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

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 से लोड किए गए नेटिव विज्ञापन में कुछ ज़रूरी एसेट (जैसे, इमेज या आइकॉन) मौजूद नहीं हैं.