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

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

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

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

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

1 बिडिंग इंटिग्रेशन, क्लोज़्ड बीटा वर्शन में है. ऐक्सेस पाने के लिए, अपने खाता मैनेजर से संपर्क करें.

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

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

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

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

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

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

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

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

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

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

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

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

विज्ञापन यूनिट बनाना

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

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

Android

iOS

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

प्लेसमेंट जोड़ना

बिडिंग

बिडिंग प्लेसमेंट बनाने के लिए, अपने Google खाता मैनेजर से संपर्क करें.

झरना

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

ज़रूरी जानकारी भरें और प्लेसमेंट जोड़ें पर क्लिक करें.

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

Android

iOS

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

बिडिंग

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

झरना

AdMob विज्ञापन यूनिट आईडी सेट अप करने के लिए, आपको गेम आईडी और प्लेसमेंट आईडी के अलावा, Unity Ads एपीआई पासकोड और Organization core ID की भी ज़रूरत होगी.

कमाई करना > सेटअप > एपीआई मैनेजमेंट पर जाएं और Monetization Stats API ऐक्सेस पासकोड को नोट करें.

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

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

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

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

Android

iOS

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

फ़ॉर्म भरें और सेव करें पर क्लिक करें.

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

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

Android

निर्देशों के लिए, Android.

iOS

निर्देशों के लिए, iOS.

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

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

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

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

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

dependencies:
  gma_mediation_unity: ^1.0.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);

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

Android

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

iOS

SKAdNetwork इंटिग्रेशन

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

छठा चरण: लागू करने की जांच करना

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

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

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

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

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

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

Android

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

iOS

GADMAdapterUnity
GADMediationAdapterUnity

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

Android

गड़बड़ी का कोड कारण
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 बैनर में कोई खास गड़बड़ी. ज़्यादा जानकारी के लिए, कोड देखें.

iOS

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.1.0

  • Unity Android अडैप्टर के 4.12.3.0 वर्शन के साथ काम करने की पुष्टि की गई
  • Unity iOS अडैप्टर के 4.12.3.1 वर्शन के साथ काम करने की पुष्टि की गई
  • Google Mobile Ads Flutter प्लग इन के 5.2.0 वर्शन के साथ बनाया और टेस्ट किया गया.

वर्शन 1.0.0

  • शुरुआती रिलीज़.
  • Unity Android अडैप्टर के 4.10.0.0 वर्शन के साथ काम करने की पुष्टि की गई है
  • Unity iOS अडैप्टर के वर्शन 4.10.0.0 के साथ काम करने की पुष्टि की गई
  • Google Mobile Ads Flutter प्लग इन के 5.0.0 वर्शन के साथ बनाया और टेस्ट किया गया.