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 चुनें. इसके बाद, BANNER बटन पर क्लिक करें.

मध्यवर्ती

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

इनाम दिया गया

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

नेटिव लेआउट

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

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

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

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

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

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

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

Android

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

iOS

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

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

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

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

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

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

इसके बाद, ऐसेट > Play Services रिज़ॉल्वर > Android रिज़ॉल्वर > फ़ोर्स रिज़ॉल्व चुनें. Unity Play Services रिज़ॉल्वर लाइब्रेरी, डिपेंडेंसी रिज़ॉल्यूशन को नए सिरे से तैयार करेगी. साथ ही, तय की गई डिपेंडेंसी को आपके 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 मोबाइल विज्ञापन मीडिएशन प्लगिन में 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.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

  • IsConsent() तरीके का नाम बदलकर, MyTarget क्लास से 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 के साथ काम करता है.