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

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

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

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

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

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

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

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

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

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

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

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

ऐप्लिकेशन जोड़ते समय, 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 को चुनें. इसके बाद, कोई यूनीक नाम डालें और मीडिएशन चालू करें.

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

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

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

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

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

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

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

ऐप्लिकेशन-लेवल की gradle फ़ाइल में, लागू करने से जुड़ी ये डिपेंडेंसी जोड़ें:

Kotlin

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

ग्रूवी

dependencies {
    implementation 'com.google.android.gms:play-services-ads:24.9.0'
    implementation 'com.google.ads.mediation:mytarget:5.27.4.0'
}

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

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

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

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

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

myTarget ने एसडीके टूल के 5.1.0 वर्शन में, उपयोगकर्ता की सहमति लेने वाला एपीआई जोड़ा है, ताकि निजता से जुड़ी ज़रूरी शर्तों का पालन किया जा सके. यहां दिए गए सैंपल कोड में, सहमति की यह जानकारी 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 इंटिग्रेशन के लिए, किसी और कोड की ज़रूरत नहीं होती.

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

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

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