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

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

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

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

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

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

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

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

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

Android

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

iOS

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

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

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

मध्यवर्ती

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

इनाम दिया गया

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

मूल भाषा वाला

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

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

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

app-ads.txt फ़ाइल अपडेट करना

Authorized Sellers for Apps app-ads.txt, IAB Tech Lab की एक पहल है. इसकी मदद से, यह पक्का किया जा सकता है कि आपके ऐप्लिकेशन की विज्ञापन इन्वेंट्री सिर्फ़ वे ही चैनल बेचते हैं जिन्हें आपने अनुमति दी है. विज्ञापन से मिलने वाले रेवेन्यू में ज़्यादा नुकसान न हो, इसके लिए आपको app-ads.txt फ़ाइल लागू करनी होगी. अगर आपने अब तक ऐसा नहीं किया है, तो Ad Manager के लिए app-ads.txt फ़ाइल बनाएं.

myTarget के लिए app-ads.txt लागू करने का तरीका जानने के लिए, फ़ाइल बनाने और पब्लिश करने का तरीका लेख पढ़ें.

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

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

दूसरा चरण: Ad Manager के यूज़र इंटरफ़ेस में myTarget की मांग सेट अप करना

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

Android

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

iOS

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

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

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

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

OpenUPM-CLI

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

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

OpenUPM

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

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

  • नाम: OpenUPM
  • URL: https://package.openupm.com
  • स्कोप: com.google

OpenUPM की जानकारी

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

Unity की रजिस्ट्री

Google Mobile Ads MyTarget Mediation पैकेज चुनें और Install पर क्लिक करें.

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

Unity पैकेज

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

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

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

इसके बाद, ऐसेट > External Dependency Manager > Android Resolver > Force Resolve चुनें. External Dependency Manager लाइब्रेरी, डिपेंडेंसी को शुरू से हल करेगी. साथ ही, एलान की गई डिपेंडेंसी को आपके Unity ऐप्लिकेशन की Assets/Plugins/Android डायरेक्ट्री में कॉपी करेगी.

ज़बरदस्ती हल करें

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

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

myTarget के लिए Google Mobile Ads mediation plugin के वर्शन 2.1.0 में, 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 mediation प्लगिन में, 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 का दस्तावेज़ पढ़ें.

छठा चरण: लागू किए गए बदलावों की जांच करना

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

पक्का करें कि आपने Ad Manager के लिए अपने टेस्ट डिवाइस को रजिस्टर किया हो और 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 Mediation Plugin के बदलावों का लॉग

वर्शन 3.28.0

वर्शन 3.27.1

वर्शन 3.27.0

वर्शन 3.26.0

वर्शन 3.25.0

वर्शन 3.24.0

वर्शन 3.23.0

वर्शन 3.22.0

वर्शन 3.21.1

वर्शन 3.21.0

वर्शन 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 Plugin के वर्शन 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 वर्शन के साथ काम करता है.