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

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

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

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

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

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

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

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

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

Android

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

iOS

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

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

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

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

मध्यवर्ती

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

इनाम दिया गया

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

मूल भाषा वाला

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

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

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

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

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

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

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

Android

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

iOS

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

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

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

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

OpenUPM-CLI

अगर आपने OpenUPM-CLI इंस्टॉल किया है, तो अपने प्रोजेक्ट की रूट डायरेक्ट्री से यह कमांड चलाकर, Unity के लिए Google Mobile Ads myTarget मीडिएशन प्लग इन को अपने प्रोजेक्ट में इंस्टॉल किया जा सकता है:

openupm add com.google.ads.mobile.mediation.mytarget

OpenUPM

Unity पैकेज मैनेजर की सेटिंग खोलने के लिए, अपने Unity प्रोजेक्ट एडिटर में बदलाव करें > प्रोजेक्ट सेटिंग > पैकेज मैनेजर चुनें.

दायरे वाली रजिस्ट्री टैब में, OpenUPM को इस जानकारी के साथ स्कोप वाली रजिस्ट्री के तौर पर जोड़ें:

  • नाम: OpenUPM
  • URL: https://package.openupm.com
  • दायरा: com.google

OpenUPM की जानकारी

इसके बाद, Unity Package Manager खोलने के लिए, विंडो > पैकेज मैनेजर पर जाएं. इसके बाद, ड्रॉप-डाउन मेन्यू से मेरी रजिस्ट्री चुनें.

Unity रजिस्ट्री

Google Mobile Ads myTarget मीडिएशन पैकेज चुनें और इंस्टॉल करें पर क्लिक करें.

OpenUPM से इंस्टॉल करना

Unity पैकेज

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

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

Unity से इंपोर्ट करें

इसके बाद, ऐसेट > बाहरी डिपेंडेंसी मैनेजर > Android रिज़ॉल्वर > बाध्य करके रिज़ॉल्व करें चुनें. External Dependency Manager लाइब्रेरी, डिपेंडेंसी को फिर से शुरू से हल करेगी और बताई गई डिपेंडेंसी को आपके 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 मोबाइल विज्ञापन मीडिएशन प्लगिन में SetCCPAUserConsent(bool) तरीका शामिल है. नीचे दिया गया सैंपल कोड, मेरे टारगेट SDK टूल में उपयोगकर्ता की सहमति की जानकारी पास करने का तरीका बताता है. अगर आपको यह तरीका आज़माना है, तो हमारा सुझाव है कि आप Google Mobile Ads SDK की मदद से विज्ञापनों का अनुरोध करने से पहले ऐसा करें.

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

MyTarget.SetCCPAUserConsent(true);

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

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

Android

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

iOS

SKAdNetwork इंटिग्रेशन

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

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

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

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

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

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

गड़बड़ी कोड

अगर अडैप्टर को 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.18.2

3.18.1 वर्शन

3.18.0 वर्शन

वर्शन 3.17.1

3.17.0 वर्शन

3.16.2 वर्शन

3.16.1 वर्शन

3.16.0 वर्शन

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 वर्शन

  • MyTarget क्लास के IsConsent() तरीके का नाम बदलकर GetUserConsent() कर दिया गया.
  • MyTarget क्लास में ये तरीके जोड़े गए:
    • SetCCPAUserConsent(bool)
    • GetCCPAUserConsent()
  • myTarget Android अडैप्टर वर्शन 5.15.3.0 पर काम करता है.
  • myTarget iOS अडैप्टर के 5.15.2.0 वर्शन के साथ काम करता है.
  • Google Mobile Ads Unity प्लगिन के वर्शन 7.2.0 की मदद से, इसे बनाया और टेस्ट किया गया है.

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 के साथ काम करता है.