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

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

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

Unity Ads के लिए AdMob मीडिएशन अडैप्टर में ये सुविधाएं हैं:

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

1 बिडिंग इंटिग्रेशन, ओपन बीटा वर्शन में है.

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

  • Google Mobile Ads SDK का सबसे नया वर्शन
  • Flutter 3.7.0 या इसके बाद का वर्शन
  • [बिडिंग के लिए]: बिडिंग में काम करने वाले सभी विज्ञापन फ़ॉर्मैट को इंटिग्रेट करने के लिए, Unity Ads 3.11.1 या इसके बाद के वर्शन के लिए, Google Mobile Ads मीडिएशन प्लगिन का इस्तेमाल करें (नया वर्शन इस्तेमाल करने का सुझाव दिया जाता है)
  • Android पर डिप्लॉय करने के लिए
    • Android एपीआई लेवल 21 या उसके बाद का वर्शन
  • iOS पर डिप्लॉय करने के लिए
    • iOS डिप्लॉयमेंट टारगेट 12.0 या उसके बाद का होना चाहिए
  • Google Mobile Ads SDK के साथ कॉन्फ़िगर किया गया, काम करने वाला Flutter प्रोजेक्ट. ज़्यादा जानकारी के लिए, शुरू करें लेख पढ़ें.
  • मीडिएशन की प्रोसेस पूरी करें शुरुआती निर्देशों की गाइड

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

Unity Ads में साइन अप करें या लॉग इन करें.

प्रोजेक्ट बनाना

Unity Ads डैशबोर्ड पर, प्रोजेक्ट पर जाएं और नया पर क्लिक करें.

अपना प्रोजेक्ट जोड़ने के लिए, फ़ॉर्म भरें और बनाएं पर क्लिक करें.

Unity Ads से कमाई करना पर जाएं. इसके बाद, शुरू करें पर क्लिक करें.

नया प्रोजेक्ट मॉडल में, मीडिएशन पार्टनर के लिए मैं मीडिएशन का इस्तेमाल करूंगा और Google AdMob को चुनें. इसके बाद, आगे बढ़ें पर क्लिक करें.

विज्ञापन सेटिंग का विकल्प चुनें. इसके बाद, आगे बढ़ें पर क्लिक करें.

प्लेसमेंट सेटअप चुनें. इसके बाद, आगे बढ़ें पर क्लिक करें.

बिडिंगझरना

फ़ॉर्म भरें. इसके बाद, प्रोजेक्ट जोड़ें पर क्लिक करें.

गेम आईडी को नोट करें.

विज्ञापन यूनिट और प्लेसमेंट बनाना

Unity Ads से कमाई करना > प्लेसमेंट पर जाएं. इसके बाद, अपना प्रोजेक्ट चुनें और विज्ञापन यूनिट जोड़ें पर क्लिक करें.

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

AndroidiOS
बिडिंगझरना

सेटअप के लिए, बिडिंग चुनें. प्लेसमेंट में जाकर, प्लेसमेंट का नाम डालें.

प्लेसमेंट आईडी को नोट करें.

सेटअप के लिए, वॉटरफ़ॉल चुनें. प्लेसमेंट में जाकर, प्लेसमेंट का नाम, जियो टैगिंग, और टारगेट डालें.

प्लेसमेंट आईडी को नोट करें.

आखिर में, अपनी विज्ञापन यूनिट और प्लेसमेंट को सेव करने के लिए, विज्ञापन यूनिट जोड़ें पर क्लिक करें.

Unity Ads Reporting API पासकोड ढूंढना

बिडिंगझरना

बिडिंग इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.

Unity Ads से कमाई करना > एपीआई मैनेजमेंट पर जाएं. इसके बाद, कमाई करने से जुड़े आंकड़े देखने के लिए एपीआई का ऐक्सेस में जाकर, एपीआई पासकोड को नोट करें.

इसके बाद, Unity Ads से कमाई करना > संगठन की सेटिंग पर जाएं और संगठन का कोर आईडी नोट करें.

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

Unity Ads डैशबोर्ड से टेस्ट मोड चालू किया जा सकता है. Unity Ads से कमाई करना > टेस्टिंग पर जाएं.

अपने ऐप्लिकेशन के लिए टेस्ट मोड को ज़बरदस्ती चालू किया जा सकता है.इसके लिए, हर प्लैटफ़ॉर्म के 'बदलाव करें' बटन पर क्लिक करें. इसके बाद, क्लाइंट टेस्ट मोड को बदलें को चालू करें और सभी डिवाइसों के लिए टेस्ट मोड को ज़बरदस्ती चालू करें (यानी टेस्ट विज्ञापनों का इस्तेमाल करें) को चुनें.

AndroidiOS

इसके अलावा, टेस्ट डिवाइस जोड़ें पर क्लिक करके, चुनिंदा डिवाइसों के लिए टेस्ट मोड चालू किया जा सकता है.

टेस्टिंग के लिए इस्तेमाल किए जाने वाले डिवाइस की जानकारी डालें. इसके बाद, सेव करें पर क्लिक करें.

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

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

AndroidiOS

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

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

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

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

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

pub.dev की मदद से इंटिग्रेशन करना

अपने पैकेज की pubspec.yaml फ़ाइल में, Unity Ads SDK टूल और अडैप्टर के नए वर्शन के साथ यह डिपेंडेंसी जोड़ें:

dependencies:
  gma_mediation_unity: ^1.2.0

मैन्युअल इंटिग्रेशन

Unity Ads के लिए, Google Mobile Ads मीडिएशन प्लगिन का नया वर्शन डाउनलोड करें. इसके बाद, डाउनलोड की गई फ़ाइल को निकालें और निकाले गए प्लगिन फ़ोल्डर (और उसके कॉन्टेंट) को अपने Flutter प्रोजेक्ट में जोड़ें. इसके बाद, अपनी pubspec.yaml फ़ाइल में प्लग इन का रेफ़रंस दें. इसके लिए, यहां दी गई डिपेंडेंसी जोड़ें:

dependencies:
  gma_mediation_unity:
    path: path/to/local/package

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

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

Unity Ads के लिए Google Mobile Ads मीडिएशन प्लगिन में, GmaMediationUnity.setGDPRConsent() तरीका शामिल है. यहां दिए गए सैंपल कोड में, Unity Ads SDK को सहमति की जानकारी देने का तरीका बताया गया है. अगर आपको यह तरीका आज़माना है, तो हमारा सुझाव है कि आप Google Mobile Ads SDK टूल की मदद से विज्ञापनों का अनुरोध करने से पहले ऐसा करें.

import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...

GmaMediationUnity.setGDPRConsent(true);

ज़्यादा जानकारी और हर तरीके में दी जा सकने वाली वैल्यू के लिए, Unity Ads के निजता सहमति और डेटा एपीआई और जीडीपीआर का पालन करना से जुड़े दिशा-निर्देश देखें.

अमेरिका के निजता कानून

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

Unity Ads के लिए Google Mobile Ads मीडिएशन प्लगिन में, GmaMediationUnity.setCCPAConsent() तरीका शामिल है. यहां दिए गए सैंपल कोड में, Unity Ads SDK को सहमति की जानकारी देने का तरीका बताया गया है. अगर आपको यह तरीका आज़माना है, तो हमारा सुझाव है कि आप Google Mobile Ads SDK टूल की मदद से विज्ञापनों का अनुरोध करने से पहले ऐसा करें.

import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...

GmaMediationUnity.setCCPAConsent(true);

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

AndroidiOS

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

SKAdNetwork इंटिग्रेशन

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

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

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

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

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

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

गड़बड़ी के कोड

अगर अडैप्टर को Unity Ads से कोई विज्ञापन नहीं मिलता है, तो पब्लिशर इन क्लास के तहत ResponseInfo का इस्तेमाल करके, विज्ञापन रिस्पॉन्स से जुड़ी गड़बड़ी की जांच कर सकते हैं:

AndroidiOS
com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter

GADMAdapterUnity
GADMediationAdapterUnity

जब कोई विज्ञापन लोड नहीं होता है, तो UnityAds अडैप्टर से ये कोड और मैसेज मिलते हैं:

AndroidiOS
गड़बड़ी का कोड कारण
0-10 UnityAds SDK टूल से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, कोड देखें.
101 AdMob यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए UnityAds सर्वर पैरामीटर मौजूद नहीं हैं या अमान्य हैं.
102 UnityAds ने NO_FILL स्टेटस वाला प्लेसमेंट दिखाया.
103 UnityAds ने 'बंद है' स्टेटस वाला प्लेसमेंट दिखाया.
104 UnityAds ने बिना संदर्भ वाला विज्ञापन दिखाने की कोशिश की.
105 Unity Ads से विज्ञापनों को शुरू करने, लोड करने, और/या दिखाने के लिए इस्तेमाल किया गया कॉन्टेक्स्ट, गतिविधि का कोई इंस्टेंस नहीं है.
106 UnityAds ने ऐसा विज्ञापन दिखाने की कोशिश की जो दिखाने के लिए तैयार नहीं है.
107 इस डिवाइस पर UnityAds काम नहीं करता.
108 UnityAds, एक बार में हर प्लेसमेंट के लिए सिर्फ़ एक विज्ञापन लोड कर सकता है.
109 UnityAds, गड़बड़ी की स्थिति में बंद हो गया.
200-204 UnityAds बैनर में कोई खास गड़बड़ी. ज़्यादा जानकारी के लिए, कोड देखें.
0-9 UnityAds SDK टूल से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, Unity का दस्तावेज़ देखें.
101 AdMob यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए UnityAds सर्वर पैरामीटर मौजूद नहीं हैं या अमान्य हैं.
102 UnityAds इस डिवाइस पर काम नहीं करता.
103 UnityAds, गड़बड़ी की स्थिति kUnityAdsFinishStateError के साथ विज्ञापन दिखाना बंद कर देता है.
104 Unity विज्ञापन ऑब्जेक्ट को शुरू करने के बाद, वह शून्य हो जाता है.
105 विज्ञापन तैयार न होने की वजह से, Unity Ads नहीं दिखाए जा सके.
106 UnityAds ने प्लेसमेंट की स्थिति kUnityAdsPlacementStateNoFill के साथ, प्लेसमेंट में बदलाव होने पर कॉलबैक को कॉल किया.
107 UnityAds ने प्लेसमेंट की स्थिति kUnityAdsPlacementStateDisabled के साथ, प्लेसमेंट में बदलाव होने पर कॉलबैक को कॉल किया.
108 इस प्लेसमेंट के लिए, पहले से ही एक विज्ञापन लोड हो चुका था. UnityAds SDK टूल, एक ही प्लेसमेंट के लिए कई विज्ञापन लोड करने की सुविधा नहीं देता.

Unity Ads Flutter मीडिएशन अडैप्टर का बदलावों का इतिहास

वर्शन 1.2.0

  • Google Mobile Ads Flutter प्लग इन के 5.3.1 वर्शन के साथ बनाया और टेस्ट किया गया.

वर्शन 1.1.0

  • Google Mobile Ads Flutter प्लग इन के 5.2.0 वर्शन के साथ बनाया और टेस्ट किया गया.

वर्शन 1.0.0

  • Google Mobile Ads Flutter प्लग इन के 5.0.0 वर्शन के साथ बनाया और टेस्ट किया गया.