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

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

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

Unity Ads के AdMob मीडिएशन अडैप्टर में ये क्षमताएं होती हैं:

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

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

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

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

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

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

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

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

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

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

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

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

गेम आईडी को ध्यान में रखें.

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

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

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

Android

iOS

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

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

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

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

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

Android

iOS

अपने क्रेडेंशियल वापस पाएं

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

कमाई करना > सेटअप > एपीआई मैनेजमेंट पर जाएं और कमाई करने से जुड़े आंकड़ों की एपीआई ऐक्सेस कुंजी पर ध्यान दें.

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

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

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

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

Android

iOS

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

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

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

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

Android

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

iOS

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

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

अहम जानकारी: पुष्टि करें कि आपके पास खाता मैनेजमेंट की अनुमति है, ताकि ईयू (यूरोपीय संघ) की सहमति के साथ-साथ जीडीपीआर, सीपीआरए, और उपयोगकर्ता मैसेज सेवा प्लैटफ़ॉर्म का कॉन्फ़िगरेशन पूरा किया जा सके. ज़्यादा जानकारी के लिए, अपने खाते के लिए उपयोगकर्ता का ऐक्सेस मैनेज करना देखें.

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

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

ध्यान दें: Unity Ads और Google Mobile 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 के दस्तावेज़ को फ़ॉलो करें.

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

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

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

अहम जानकारी: ऐप्लिकेशन रिलीज़ करने से पहले, AdMob और Unity Ads अपने ऐप्लिकेशन के लिए टेस्ट मोड बंद करें.

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

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

गड़बड़ी कोड

अगर अडैप्टर को 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 विज्ञापन के इनिशलाइज़र को कॉल करने के बाद, Unity विज्ञापन ऑब्जेक्ट शून्य हो जाता है.
105	Unity विज्ञापन नहीं दिखाए जा सके, क्योंकि विज्ञापन तैयार नहीं है.
106	UnityAds को प्लेसमेंट की स्थिति kUnityAdsप्लेसमेंटStateNoFill के साथ बदला गया कॉलबैक कॉल किया जाता है.
107	UnityAds को प्लेसमेंट की स्थिति kUnityAdsप्लेसमेंटStateबंद है. इस वजह से, हमने प्लेसमेंट को बदलकर कॉलबैक कर दिया था.
108	इस प्लेसमेंट के लिए एक विज्ञापन पहले से लोड किया गया था. UnityAds SDK टूल, एक ही प्लेसमेंट के लिए कई विज्ञापन लोड करने पर काम नहीं करता.

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

वर्शन 1.0.0

• शुरुआती रिलीज़.
• Unity Android अडैप्टर के 4.10.0.0 वर्शन के साथ काम करने की पुष्टि की गई
• Unity iOS अडैप्टर के 4.10.0.0 वर्शन के साथ काम करता है