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

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

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

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

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

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

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

• नया GMA Next-Gen SDK.

• मीडिएशन की प्रोसेस पूरी करने के शुरुआती निर्देश Get started guide.

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

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

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

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

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

AdMob विज्ञापन यूनिट आईडी सेट अप करने के लिए, आपको slot_id के अलावा, myTarget के Permanent Access Token की भी ज़रूरत होगी. प्रोफ़ाइल टैब पर जाएं और ऐक्सेस टोकन चुनें. 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 मीडिएशन , प्लैटफ़ॉर्म के तौर पर Android और स्टेटस के तौर पर चालू चुनें. पिछले सेक्शन में मिला स्लॉट आईडी डालें. इसके बाद, डिफ़ॉल्ट सीपीएम वैल्यू डालें.

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

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

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

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

Android Studio इंटिग्रेशन (इसका सुझाव दिया जाता है)

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:mytarget:5.45.3.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:mytarget:5.45.3.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

• myTarget SDK को शामिल करने के लिए, myTarget Android SDK दस्तावेज़ देखें.

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

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

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

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

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

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

MyTargetPrivacy.setUserConsent(true);

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

MyTargetPrivacy.setUserConsent(true)

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

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

MyTargetPrivacy.setUserAgeRestricted(true);

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

MyTargetPrivacy.setUserAgeRestricted(true)

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

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

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

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

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

MyTargetPrivacy.setCcpaUserConsent(true);

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

MyTargetPrivacy.setCcpaUserConsent(true)

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

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

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

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

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

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

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

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

वैकल्पिक चरण

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

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

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

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

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

GMA Next-Gen SDK इंप्रेशन और क्लिक ट्रैकिंग के लिए, myTarget SDK के कॉलबैक का इस्तेमाल करता है. इसलिए, दोनों सोर्स से मिलने वाली रिपोर्ट में कुछ ही अंतर होना चाहिए या कोई अंतर नहीं होना चाहिए.

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

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

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

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