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 Permanent Access Token देखने के लिए, टोकन बनाएं या टोकन दिखाएं पर क्लिक करें.

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

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

दूसरा चरण: Ad Manager यूज़र इंटरफ़ेस (यूआई) में 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 मोबाइल विज्ञापन मीडिएशन प्लगिन में 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 Ad Manager यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगर किए गए myTarget सर्वर पैरामीटर मौजूद नहीं हैं/अमान्य हैं.
102 अनुरोध किया गया विज्ञापन साइज़, myTarget के साथ काम करने वाले बैनर साइज़ से मेल नहीं खाता.
103 विज्ञापन अनुरोध, यूनिफ़ाइड नेटिव विज्ञापन अनुरोध नहीं है.
104 myTarget से लोड किया गया नेटिव विज्ञापन, अनुरोध किए गए नेटिव विज्ञापन से अलग है.
105 myTarget के लोड किए गए नेटिव विज्ञापन में कुछ ज़रूरी एसेट (जैसे कि इमेज या आइकॉन) मौजूद नहीं हैं.

iOS

गड़बड़ी का कोड कारण
100 myTarget SDK टूल में अभी तक कोई विज्ञापन उपलब्ध नहीं है.
101 Ad Manager यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए 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.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 के साथ काम करता है.