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

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

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

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

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

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

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

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

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

Android

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

iOS

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

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

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

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

मध्यवर्ती

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

इनाम दिया गया

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

मूल भाषा वाला

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

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

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

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

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

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

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

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 Mobile Ads मीडिएशन प्लग इन में SetCCPAUserConsent(bool) तरीका शामिल है. यहां दिए गए सैंपल कोड में, उपयोगकर्ता की सहमति की जानकारी को myTarget 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.20.0 वर्शन

3.19.0 वर्शन

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

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.SetUserConsent() का इस्तेमाल करके, उपयोगकर्ता की सहमति की स्थिति को MyTarget SDK टूल पर भेजने का तरीका.
    • 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 के साथ काम करता है.