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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

मध्यवर्ती

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

इनाम दिया गया

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

मूल भाषा वाला

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

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

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

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

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

दूसरा चरण: AdMob यूज़र इंटरफ़ेस (यूआई) में myTarget की मांग सेट अप करना

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

आपको अपनी विज्ञापन यूनिट के लिए, मध्यस्थता कॉन्फ़िगरेशन में myTarget जोड़ना होगा.

सबसे पहले, अपने AdMob खाते में साइन इन करें. इसके बाद, मीडिएशन टैब पर जाएं. अगर आपके पास कोई मौजूदा मीडिएशन ग्रुप है जिसमें आपको बदलाव करना है, तो उसमें बदलाव करने के लिए, मीडिएशन ग्रुप के नाम पर क्लिक करें. इसके बाद, myTarget को विज्ञापन स्रोत के तौर पर जोड़ें पर जाएं.

नया मीडिएशन ग्रुप बनाने के लिए, मीडिएशन ग्रुप बनाएं को चुनें.

विज्ञापन फ़ॉर्मैट और प्लैटफ़ॉर्म डालें. इसके बाद, जारी रखें पर क्लिक करें.

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

इस मीडिएशन ग्रुप को अपनी एक या उससे ज़्यादा मौजूदा AdMob विज्ञापन यूनिट से जोड़ें. इसके बाद, हो गया पर क्लिक करें.

अब आपको विज्ञापन यूनिट कार्ड दिखेगा, जिसमें आपने जो विज्ञापन यूनिट चुनी हैं वे दिखेंगी:

myTarget को विज्ञापन स्रोत के तौर पर जोड़ना

विज्ञापन स्रोत सेक्शन में, वॉटरफ़ॉल कार्ड में जाकर, विज्ञापन स्रोत जोड़ें को चुनें. इसके बाद, myTarget चुनें.

myTarget चुनें और ऑप्टिमाइज़ करें स्विच को चालू करें. myTarget के लिए विज्ञापन स्रोत का ऑप्टिमाइज़ेशन सेट अप करने के लिए, पिछले सेक्शन में मिला स्थायी ऐक्सेस टोकन डालें. इसके बाद, myTarget के लिए eCPM वैल्यू डालें और जारी रखें पर क्लिक करें.

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

इसके बाद, पिछले सेक्शन में मिला स्लॉट आईडी डालें. इसके बाद, हो गया पर क्लिक करें.

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

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

AdMob के यूज़र इंटरफ़ेस (यूआई) में, जीडीपीआर और अमेरिका के कानूनों के तहत विज्ञापन पार्टनर की सूची में 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 इंटिग्रेशन के लिए, किसी अन्य कोड की ज़रूरत नहीं है.

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

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

पक्का करें कि आपने AdMob के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो. साथ ही, 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	AdMob यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए myTarget सर्वर पैरामीटर मौजूद नहीं हैं या अमान्य हैं.
102	अनुरोध किया गया विज्ञापन साइज़, myTarget के साथ काम करने वाले बैनर साइज़ से मेल नहीं खाता.
103	विज्ञापन अनुरोध, यूनिफ़ाइड नेटिव विज्ञापन अनुरोध नहीं है.
104	myTarget से लोड किया गया नेटिव विज्ञापन, अनुरोध किए गए नेटिव विज्ञापन से अलग है.
105	myTarget से लोड किए गए नेटिव विज्ञापन में कुछ ज़रूरी एसेट (जैसे, इमेज या आइकॉन) मौजूद नहीं हैं.