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

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

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

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

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

  • Unity 4 या उसके बाद का वर्शन
  • नया Google Mobile Ads SDK
  • Android पर डिप्लॉय करने के लिए
    • Android API का लेवल 19 या उसके बाद वाला वर्शन
  • iOS पर डिप्लॉय करने के लिए
    • iOS डिप्लॉयमेंट टारगेट, 12.0 या इसके बाद का होना चाहिए
  • Google Mobile Ads SDK के साथ कॉन्फ़िगर किया गया Unity प्रोजेक्ट, जो काम करता है. ज़्यादा जानकारी के लिए, शुरू करें देखें.
  • मीडिएशन को पूरा करें शुरुआती निर्देश

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

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

अगर आपका ऐप्लिकेशन Android और iOS, दोनों प्लैटफ़ॉर्म पर काम करता है, तो आपको हर एक को अलग-अलग सेट अप करना होगा.

Android

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

iOS

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

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

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

मध्यवर्ती

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

इनाम दिया गया

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

नेटिव लेआउट

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

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

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

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

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

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

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

Android

निर्देशों के लिए, Android की गाइड में दूसरा चरण देखें.

iOS

निर्देशों के लिए, iOS की गाइड में दूसरा चरण देखें.

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

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

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

Changelog में मौजूद डाउनलोड लिंक से, myTarget के लिए Google मोबाइल विज्ञापन मीडिएशन प्लगिन का सबसे नया वर्शन डाउनलोड करें. इसके बाद, फ़ाइल से GoogleMobileAdsMyTargetMediation.unitypackage को एक्सट्रैक्ट करें.

अपने Unity प्रोजेक्ट के एडिटर में, ऐसेट > पैकेज इंपोर्ट करें > कस्टम पैकेज चुनें और डाउनलोड की गई GoogleMobileAdsMyTargetMediation.unitypackage फ़ाइल ढूंढें. पक्का करें कि सभी फ़ाइलें चुनी गई हों और इंपोर्ट करें पर क्लिक करें.

इसके बाद, एसेट > Play सेवाएं रिज़ॉल्वर > Android रिज़ॉल्वर > ज़बरदस्ती समाधान करें चुनें. Unity Play Services रिज़ॉल्वर लाइब्रेरी, शुरुआत से डिपेंडेंसी रिज़ॉल्यूशन लागू करेगी. साथ ही, तय की गई डिपेंडेंसी को आपके Unity ऐप्लिकेशन की Assets/Plugins/Android डायरेक्ट्री में कॉपी कर देगी.

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

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

myTarget वर्शन 2.1.0 के Google Mobile Ads मीडिएशन प्लगिन में SetUserConsent() और SetUserAgeRestricted() तरीके शामिल हैं. नीचे दिया गया सैंपल कोड बताता है कि कैसे myTarget SDK में उपयोगकर्ता की सहमति की जानकारी भेजी जा सकती है. अगर इस तरीके को कॉल करने का विकल्प चुना जाता है, तो हमारा सुझाव है कि Google Mobile Ads SDK से विज्ञापनों का अनुरोध करने से पहले ऐसा करें.

using GoogleMobileAds.Api.Mediation.MyTarget;
// ...

MyTarget.SetUserConsent(true);

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

MyTarget.SetUserAgeRestricted(true);

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

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

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

myTarget के वर्शन 3.13.3 के Google Mobile Ads मीडिएशन प्लगिन में SetCCPAUserConsent(bool) तरीका शामिल है. नीचे दिया गया सैंपल कोड बताता है कि कैसे myTarget SDK में उपयोगकर्ता की सहमति की जानकारी भेजी जा सकती है. अगर इस तरीके को कॉल करना है, तो हमारा सुझाव है कि Google मोबाइल विज्ञापन SDK से विज्ञापनों का अनुरोध करने से पहले ऐसा करें.

using GoogleMobileAds.Api.Mediation.MyTarget;
// ...

MyTarget.SetCCPAUserConsent(true);

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

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

Android

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

iOS

SKAdNetwork इंटिग्रेशन

अपने प्रोजेक्ट की Info.plist फ़ाइल में SKAdNetwork आइडेंटिफ़ायर जोड़ने के लिए, myTarget के दस्तावेज़ का पालन करें.

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

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

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

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

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

गड़बड़ी कोड

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

Android

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

iOS

GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded

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

Android

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

iOS

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

myTarget Unity मीडिएशन का प्लगिन चेंजलॉग

वर्शन 3.15.0

वर्शन 3.14.0

वर्शन 3.13.2

वर्शन 3.13.1

  • अडैप्टर के कॉन्टेंट को GoogleMobileAds/Mediation/MyTarget/ में ले जाया गया.
  • GoogleMobileAds.Mediation.MyTarget का इस्तेमाल करने के लिए, रीफ़ैक्टर किया गया अडैप्टर नेमस्पेस.
  • myTarget Android अडैप्टर वर्शन 5.16.4.1 पर काम करता है.
  • myTarget iOS अडैप्टर वर्शन 5.17.4.0 पर काम करता है.
  • Google Mobile Ads Unity प्लगिन के वर्शन 8.1.0 से बनाया और टेस्ट किया गया.

वर्शन 3.13.0

वर्शन 3.12.0

वर्शन 3.11.4

वर्शन 3.11.3

वर्शन 3.11.2

वर्शन 3.11.1

वर्शन 3.11.0

वर्शन 3.10.2

वर्शन 3.10.1

वर्शन 3.10.0

वर्शन 3.9.0

वर्शन 3.8.2

वर्शन 3.8.1

वर्शन 3.8.0

वर्शन 3.7.0

वर्शन 3.6.1

वर्शन 3.6.0

वर्शन 3.5.2

वर्शन 3.5.1

वर्शन 3.5.0

वर्शन 3.4.0

वर्शन 3.3.0

वर्शन 3.2.0

वर्शन 3.1.0

वर्शन 3.0.0

  • नए ओपन-बीटा Rewarded API के साथ काम करने के लिए प्लगिन को अपडेट किया गया.
  • myTarget Android अडैप्टर के 5.3.9.0 वर्शन के साथ काम करता है.
  • myTarget iOS अडैप्टर वर्शन 5.0.4.0 के साथ काम करता है.

वर्शन 2.3.2

  • myTarget Android अडैप्टर के 5.2.5.0 वर्शन के साथ काम करता है.
  • myTarget iOS अडैप्टर वर्शन 4.8.9.0 के साथ काम करता है.

वर्शन 2.3.1

  • myTarget Android अडैप्टर के 5.2.5.0 वर्शन के साथ काम करता है.
  • myTarget iOS अडैप्टर वर्शन 4.8.5.0 के साथ काम करता है.

वर्शन 2.3.0

  • myTarget Android अडैप्टर वर्शन 5.2.2.0 के साथ काम करता है.
  • myTarget iOS अडैप्टर वर्शन 4.8.0.0 के साथ काम करता है.

वर्शन 2.2.0

  • myTarget Android अडैप्टर के 5.1.4.0 वर्शन के साथ काम करता है.
  • myTarget iOS अडैप्टर वर्शन 4.8.0.0 के साथ काम करता है.

वर्शन 2.1.2

  • myTarget Android अडैप्टर वर्शन 5.1.3.0 के साथ काम करता है.
  • myTarget iOS अडैप्टर के 4.7.11.0 वर्शन के साथ काम करता है.

वर्शन 2.1.1

  • myTarget Android अडैप्टर के 5.1.1.0 वर्शन के साथ काम करता है.
  • myTarget iOS अडैप्टर वर्शन 4.7.10.0 के साथ काम करता है.

वर्शन 2.1.0

  • myTarget Android SDK के 5.1.0 वर्शन के साथ काम करता है.
  • myTarget iOS SDK वर्शन 4.7.9 पर काम करता है.
  • ये तरीके जोड़े गए:
    • उपयोगकर्ता की सहमति की स्थिति को MyTarget SDK पर भेजने का MyTarget.SetUserConsent() तरीका.
    • MyTarget.SetUserAgeRestricted का तरीका, जो यह बताने के लिए फ़्लैग सेट करता है कि उपयोगकर्ता, 16 साल से कम उम्र की पाबंदी वाली कैटगरी में आता है या नहीं.
    • उपयोगकर्ता की मौजूदा सहमति की स्थिति जानने के लिए, MyTarget.IsUserConsent() तरीका.
    • MyTarget.IsUserAgeRestricted() फ़्लैग पाने का तरीका जिससे पता चलता है कि उपयोगकर्ता, उम्र से जुड़ी पाबंदी की कैटगरी में आता है (यानी कि 16 साल से कम उम्र का व्यक्ति).

वर्शन 2.0.1

  • myTarget Android SDK वर्शन 5.0.2 के साथ काम करता है.
  • myTarget iOS SDK वर्शन 4.7.8 के साथ काम करता है.

वर्शन 2.0.0

  • myTarget Android SDK वर्शन 5.0.0 पर काम करता है.
  • myTarget iOS SDK वर्शन 4.7.7 के साथ काम करता है.

वर्शन 1.1.0

  • myTarget Android SDK वर्शन 4.7.2 के साथ काम करता है.
  • myTarget iOS SDK वर्शन 4.7.6 पर काम करता है.

वर्शन 1.0.0

  • पहली रिलीज़!
  • myTarget Android SDK वर्शन 4.6.27 पर काम करता है.
  • myTarget iOS SDK वर्शन 4.6.24 पर काम करता है.