इस गाइड में बताया गया है कि Google Mobile Ads Flutter Plugin का इस्तेमाल करके, Unity Ads से विज्ञापन लोड करने और दिखाने के लिए, मीडिएशन का इस्तेमाल कैसे किया जाता है. इसमें बिडिंग और वॉटरफ़ॉल इंटिग्रेशन भी शामिल है. इसमें बताया गया है कि किसी विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में Unity Ads को कैसे जोड़ा जाता है. साथ ही, किसी Flutter ऐप्लिकेशन में Unity Ads SDK और अडैप्टर को कैसे इंटिग्रेट किया जाता है.
इस्तेमाल किए जा सकने वाले इंटिग्रेशन और विज्ञापन फ़ॉर्मैट
Unity Ads के लिए AdMob मीडिएशन अडैप्टर में ये सुविधाएं उपलब्ध हैं:
| इंटिग्रेशन | |
|---|---|
| बिडिंग | |
| झरना | 1 |
| फ़ॉर्मैट | |
| बैनर वाले विज्ञापन | |
| इंटरस्टीशियल विज्ञापन | |
| इनाम दिया गया | |
ज़रूरी शर्तें
- Google Mobile Ads Flutter Plugin पर अपलोड हुआ नया वीडियो
- Flutter 3.7.0 या इसके बाद का वर्शन
- [बिडिंग के लिए]: बिडिंग में काम करने वाले सभी विज्ञापन फ़ॉर्मैट को इंटिग्रेट करने के लिए, Unity Ads 1.1.0 या इसके बाद के वर्शन के लिए Google Mobile Ads मीडिएशन प्लगिन का इस्तेमाल करें (नया वर्शन इस्तेमाल करने का सुझाव दिया जाता है)
- Android पर डिप्लॉय करने के लिए
- Android का एपीआई लेवल 23 या इसके बाद का वर्शन
- iOS पर डिप्लॉय करने के लिए
- iOS डिप्लॉयमेंट का टारगेट 12.0 या इसके बाद का वर्शन होना चाहिए
- Google Mobile Ads Flutter Plugin के साथ कॉन्फ़िगर किया गया ऐसा Flutter प्रोजेक्ट जिस पर काम किया जा सकता हो. ज़्यादा जानकारी के लिए, Google Mobile Ads Flutter Plugin सेट अप करना लेख पढ़ें.
- AdMob मीडिएशन सेट अप करें.
पहला चरण: Unity Ads के यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगरेशन सेट अप करना
Unity Ads के लिए साइन अप करें या लॉग इन करें.
प्रोजेक्ट बनाना
Unity Ads डैशबोर्ड पर, प्रोजेक्ट पर जाएं और नया पर क्लिक करें.
फ़ॉर्म भरें और अपना प्रोजेक्ट जोड़ने के लिए, बनाएं पर क्लिक करें.
Unity Ads Monetization पर जाएं. इसके बाद, शुरू करें पर क्लिक करें.
नया प्रोजेक्ट मोडल में, मैं मीडिएशन का इस्तेमाल करूंगा और मीडिएशन पार्टनर के लिए Google AdMob को चुनें. इसके बाद, आगे बढ़ें पर क्लिक करें.
विज्ञापन सेटिंग का विकल्प चुनें. इसके बाद, आगे बढ़ें पर क्लिक करें.
प्लेसमेंट का सेटअप चुनें. इसके बाद, आगे बढ़ें पर क्लिक करें.
बिडिंग
झरना
फ़ॉर्म भरें. इसके बाद, प्रोजेक्ट जोड़ें पर क्लिक करें.
गेम आईडी को नोट करें.
विज्ञापन यूनिट और प्लेसमेंट बनाना
Unity Ads Monetization > Placements पर जाएं. इसके बाद, अपना प्रोजेक्ट चुनें और विज्ञापन यूनिट जोड़ें पर क्लिक करें.
विज्ञापन यूनिट का नाम डालें. इसके बाद, अपना प्लैटफ़ॉर्म और विज्ञापन फ़ॉर्मैट चुनें.
Android
iOS
बिडिंग
सेटअप के लिए, बिडिंग चुनें. प्लेसमेंट में जाकर, प्लेसमेंट का नाम डालें.
प्लेसमेंट आईडी को नोट करें.
झरना
सेटअप के लिए, वॉटरफ़ॉल चुनें. प्लेसमेंट में जाकर, प्लेसमेंट का नाम, जियो टैगिंग, और टारगेट डालें.
प्लेसमेंट आईडी को नोट करें.
आखिर में, अपनी विज्ञापन यूनिट और प्लेसमेंट को सेव करने के लिए, विज्ञापन यूनिट जोड़ें पर क्लिक करें.
Unity Ads Reporting API का पासकोड ढूंढना
बिडिंग
बिडिंग इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.
झरना
Unity Ads Monetization > API management पर जाएं और Monetization Stats API Access में मौजूद API Key को नोट करें.
इसके बाद, Unity Ads Monetization > Organization Settings पर जाएं और Organization core ID नोट करें.
app-ads.txt फ़ाइल अपडेट करना
ऐप्लिकेशन के लिए, अनुमति वाले सेलर (app-ads.txt), IAB Tech Lab की एक पहल है. इसकी मदद से यह पक्का किया जा सकता है कि आपके ऐप्लिकेशन की विज्ञापन इन्वेंट्री सिर्फ़ वे चैनल बेचें जिन्हें आपने अनुमति दी है. विज्ञापन से मिलने वाले रेवेन्यू में ज़्यादा नुकसान न हो, इसके लिए आपको app-ads.txt फ़ाइल लागू करनी होगी.
अगर आपने अब तक ऐसा नहीं किया है, तो
अपने ऐप्लिकेशन के लिए app-ads.txt फ़ाइल सेट अप करें.
Unity Ads के लिए app-ads.txt लागू करने के लिए, पहली बार app-ads.txt सेट अप करना लेख पढ़ें.
टेस्ट मोड को चालू करना
टेस्ट मोड को Unity Ads डैशबोर्ड से चालू किया जा सकता है. Unity Ads Monetization > Testing पर जाएं.
अपने ऐप्लिकेशन के लिए टेस्ट मोड को फ़ोर्स किया जा सकता है.इसके लिए, हर प्लैटफ़ॉर्म के 'बदलाव करें' बटन पर क्लिक करें. इसके बाद, क्लाइंट टेस्ट मोड को बदलें को चालू करें और सभी डिवाइसों के लिए, टेस्ट मोड को चालू करें (यानी कि टेस्ट विज्ञापनों का इस्तेमाल करें) को चुनें.
Android
iOS
इसके अलावा, टेस्ट डिवाइस जोड़ें पर क्लिक करके, कुछ डिवाइसों के लिए टेस्ट मोड चालू किया जा सकता है.
टेस्ट डिवाइस की जानकारी डालें. इसके बाद, सेव करें पर क्लिक करें.
दूसरा चरण: AdMob के यूआई में Unity Ads की डिमांड सेट अप करना
अपनी विज्ञापन यूनिट के लिए मीडिएशन की सेटिंग कॉन्फ़िगर करना
Android
निर्देशों के लिए, Android के लिए गाइड में दिया गया दूसरा चरण देखें.
iOS
निर्देशों के लिए, iOS के लिए गाइड में दिया गया दूसरा चरण देखें.
GDPR और अमेरिका के राज्यों में लागू कानूनों के तहत विज्ञापन पार्टनर की सूची में Unity Ads को जोड़ना
AdMob के यूज़र इंटरफ़ेस (यूआई) में, यूरोप और अमेरिका के राज्यों के कानूनों के तहत विज्ञापन पार्टनर की सूची में Unity Ads को जोड़ने के लिए, यहां दिया गया तरीका अपनाएं: यूरोपीय कानूनों की सेटिंग और अमेरिका के राज्यों के कानूनों की सेटिंग
तीसरा चरण: Unity Ads SDK और अडैप्टर को इंपोर्ट करना
pub.dev के ज़रिए इंटिग्रेशन
अपने पैकेज की pubspec.yaml फ़ाइल में, Unity Ads SDK और अडैप्टर के नए वर्शन के साथ यह डिपेंडेंसी जोड़ें:
dependencies:
gma_mediation_unity: ^1.6.4
मैन्युअल इंटिग्रेशन
Unity Ads के लिए, Google Mobile Ads mediation प्लगिन का नया वर्शन डाउनलोड करें. इसके बाद, डाउनलोड की गई फ़ाइल को एक्सट्रैक्ट करें. अब एक्सट्रैक्ट किए गए प्लगिन फ़ोल्डर (और उसके कॉन्टेंट) को अपने 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 Flutter Plugin के ज़रिए विज्ञापनों का अनुरोध करने से पहले ऐसा करें.
import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...
GmaMediationUnity.setGDPRConsent(true);
ज़्यादा जानकारी के लिए, Unity Ads की Privacy Consent and data APIs और Consumer privacy act compliance गाइड देखें. साथ ही, यह भी जानें कि हर तरीके में कौनसी वैल्यू दी जा सकती हैं.
अमेरिका के राज्यों के निजता कानून
अमेरिका के राज्यों के निजता कानूनों के मुताबिक, उपयोगकर्ताओं को अपनी "निजी जानकारी" (जैसा कि कानून में परिभाषित है) की "बिक्री" से ऑप्ट आउट करने का अधिकार मिलना चाहिए. ऑप्ट आउट का विकल्प देने के लिए, "बिक्री करने वाले" पक्ष को अपने होम पेज पर "मेरी निजी जानकारी न बेचें" का लिंक प्रमुखता से दिखाना होगा. अमेरिका के राज्यों के निजता कानूनों का पालन करने से जुड़ी गाइड में, Google के विज्ञापन दिखाने के लिए सीमित डेटा प्रोसेसिंग मोड को चालू करने की सुविधा मिलती है. हालांकि, Google आपकी मीडिएशन चेन में मौजूद हर विज्ञापन नेटवर्क पर इस सेटिंग को लागू नहीं कर सकता. इसलिए, आपको मीडिएशन चेन में मौजूद हर उस विज्ञापन नेटवर्क कंपनी की पहचान करनी होगी जो निजी जानकारी की बिक्री में हिस्सा ले सकती है. साथ ही, आपको यह पक्का करने के लिए कि निजता कानून का पालन किया जा रहा है, उन सभी नेटवर्क से मिले दिशा-निर्देशों का पालन करना होगा.
Unity Ads के लिए Google Mobile Ads मीडिएशन प्लगिन में, GmaMediationUnity.setCCPAConsent() तरीका शामिल है. यहां दिए गए सैंपल कोड में, Unity Ads SDK को सहमति की जानकारी भेजने का तरीका बताया गया है. अगर आपको इस तरीके का इस्तेमाल करना है, तो हमारा सुझाव है कि Google Mobile Ads Flutter Plugin के ज़रिए विज्ञापनों का अनुरोध करने से पहले ऐसा करें.
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 ने DISABLED स्टेटस वाला प्लेसमेंट दिखाया. |
| 104 | UnityAds ने शून्य कॉन्टेक्स्ट वाला विज्ञापन दिखाने की कोशिश की. |
| 105 | Unity Ads से विज्ञापन दिखाने, लोड करने, और/या शुरू करने के लिए इस्तेमाल किया गया कॉन्टेक्स्ट, गतिविधि का इंस्टेंस नहीं है. |
| 106 | UnityAds ने ऐसा विज्ञापन दिखाने की कोशिश की है जो दिखाए जाने के लिए तैयार नहीं है. |
| 107 | इस डिवाइस पर UnityAds काम नहीं करता. |
| 108 | UnityAds, एक बार में हर प्लेसमेंट के लिए सिर्फ़ एक विज्ञापन लोड कर सकता है. |
| 109 | UnityAds, ERROR स्थिति के साथ खत्म हुआ. |
| 200-204 | UnityAds Banner में कोई गड़बड़ी हुई है. ज़्यादा जानकारी के लिए, कोड देखें. |
iOS
| 0-9 | UnityAds SDK से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, Unity का दस्तावेज़ देखें. |
| 101 | AdMob के यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए UnityAds सर्वर पैरामीटर मौजूद नहीं हैं या मान्य नहीं हैं. |
| 102 | UnityAds इस डिवाइस पर काम नहीं करता. |
| 103 | UnityAds ने kUnityAdsFinishStateError गड़बड़ी की स्थिति के साथ विज्ञापन दिखाना बंद कर दिया. |
| 104 | इनिशियलाइज़र को कॉल करने के बाद, Unity विज्ञापन ऑब्जेक्ट शून्य होता है. |
| 105 | विज्ञापन तैयार न होने की वजह से, Unity Ads नहीं दिखाए जा सके. |
| 107 | UnityAds ने प्लेसमेंट की स्थिति kUnityAdsPlacementStateDisabled के साथ, प्लेसमेंट में बदलाव होने पर कॉल किए जाने वाले कॉलबैक को कॉल किया. |
| 108 | इस प्लेसमेंट के लिए, कोई विज्ञापन पहले ही लोड किया जा चुका है. UnityAds SDK, एक ही प्लेसमेंट के लिए कई विज्ञापन लोड करने की सुविधा नहीं देता. |
| 109 | UnityAds से मिला बैनर विज्ञापन, अनुरोध किए गए साइज़ से मेल नहीं खाता. |
| 110 | UnityAds को शुरू करने के दौरान गड़बड़ी का मैसेज मिला. |
| 111 | विज्ञापन का यह फ़ॉर्मैट इस्तेमाल नहीं किया जा सकता. |
Unity Ads Flutter Mediation Adapter के बदलावों की जानकारी
वर्शन 1.6.4 (जारी है)
- Flutter के कम से कम वर्शन को 3.35.1 पर अपडेट किया गया
- Google Mobile Ads Flutter Plugin के 7.0.0 वर्शन के साथ काम करने के लिए अपडेट किया गया
वर्शन 1.6.3
- Unity Android अडैप्टर वर्शन 4.16.3.0 के साथ काम करता है.
- यह Unity iOS अडैप्टर के 4.16.3.0 वर्शन के साथ काम करता है.
- इसे Google Mobile Ads Flutter Plugin के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.6.2
- Unity Android अडैप्टर वर्शन 4.16.3.0 के साथ काम करता है.
- Unity iOS अडैप्टर वर्शन 4.16.2.0 के साथ काम करता है.
- इसे Google Mobile Ads Flutter Plugin के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.6.1
- Unity Android adapter version 4.16.1.0 के साथ काम करता है.
- Unity iOS अडैप्टर के 4.16.1.0 वर्शन के साथ काम करता है.
- इसे Google Mobile Ads Flutter Plugin के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.6.0
- अब इसके लिए, iOS 13.0 या इसके बाद का वर्शन होना ज़रूरी है.
- Unity Android adapter version 4.16.0.0 के साथ काम करता है.
- Unity iOS अडैप्टर के वर्शन 4.16.0.0 के साथ काम करता है.
- इसे Google Mobile Ads Flutter Plugin के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.
संस्करण 1.5.1
- Unity Android अडैप्टर 4.15.1.0 के साथ काम करता है.
- Unity iOS अडैप्टर वर्शन 4.15.1.0 के साथ काम करता है.
- इसे Google Mobile Ads Flutter Plugin के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.5.0
- Unity Android अडैप्टर 4.15.0.0 वर्शन के साथ काम करता है.
- Unity iOS अडैप्टर वर्शन 4.15.0.0 के साथ काम करता है.
- इसे Google Mobile Ads Flutter Plugin के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.4.1
- Unity Android adapter version 4.14.2.0 के साथ काम करता है.
- Unity iOS अडैप्टर वर्शन 4.14.2.0 के साथ काम करता है.
- इसे Google Mobile Ads Flutter Plugin के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.4.0
- Unity Android adapter version 4.14.1.0 के साथ काम करता है.
- Unity iOS अडैप्टर वर्शन 4.14.1.1 के साथ काम करता है.
- इसे Google Mobile Ads Flutter Plugin के 6.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.3.0
- Unity Android अडैप्टर के वर्शन 4.13.1.0 के साथ काम करता है.
- Unity iOS अडैप्टर के 4.13.1.0 वर्शन के साथ काम करता है.
- इसे Google Mobile Ads Flutter Plugin के 5.3.1 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.2.0
- Unity Android अडैप्टर वर्शन 4.13.0.0 के साथ काम करता है.
- Unity iOS अडैप्टर वर्शन 4.12.5.0 के साथ काम करता है.
- इसे Google Mobile Ads Flutter Plugin के 5.3.1 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.1.0
- Unity Android अडैप्टर के 4.12.3.0 वर्शन के साथ काम करता है.
- Unity iOS अडैप्टर वर्शन 4.12.3.1 के साथ काम करता है.
- इसे Google Mobile Ads Flutter Plugin के 5.2.0 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.0.0
- शुरुआती रिलीज़.
- Unity Android अडैप्टर के 4.10.0.0 वर्शन के साथ काम करता है.
- Unity iOS अडैप्टर के 4.10.0.0 वर्शन के साथ काम करता है.
- इसे Google Mobile Ads Flutter Plugin के 5.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.