इस पेज का अनुवाद Cloud Translation API से किया गया है.

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

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

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

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

इंटिग्रेशन
बिडिंग	¹
झरना
फ़ॉर्मैट
बैनर
मध्यवर्ती
इनाम दिया गया
मूल भाषा वाला

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

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

iOS डिप्लॉयमेंट टारगेट 12.0 या उसके बाद का होना चाहिए
[बिडिंग के लिए]: बिडिंग में काम करने वाले सभी विज्ञापन फ़ॉर्मैट को इंटिग्रेट करने के लिए, Unity अडैप्टर 4.11.3.1 या इसके बाद के वर्शन का इस्तेमाल करें. नया वर्शन इस्तेमाल करने का सुझाव दिया जाता है

Google Mobile Ads SDK का सबसे नया वर्शन
मीडिएशन की प्रोसेस पूरी करें शुरुआती निर्देशों की गाइड

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

बिडिंग

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

झरना

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

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

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

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

बिडिंग

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

झरना

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

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

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

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

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

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

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

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

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

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

आपको अपनी विज्ञापन यूनिट के लिए, मीडिएशन कॉन्फ़िगरेशन में Unity Ads जोड़ना होगा.

सबसे पहले, अपने AdMob खाते में साइन इन करें. इसके बाद, मीडिएशन टैब पर जाएं. अगर आपके पास कोई मौजूदा मीडिएशन ग्रुप है जिसमें आपको बदलाव करना है, तो उसमें बदलाव करने के लिए, मीडिएशन ग्रुप के नाम पर क्लिक करें. इसके बाद, Unity Ads को विज्ञापन स्रोत के तौर पर जोड़ें पर जाएं.

नया मीडिएशन ग्रुप बनाने के लिए, मीडिएशन ग्रुप बनाएं को चुनें.

विज्ञापन फ़ॉर्मैट और प्लैटफ़ॉर्म डालें. इसके बाद, जारी रखें पर क्लिक करें.

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

इस मीडिएशन ग्रुप को अपनी एक या उससे ज़्यादा मौजूदा AdMob विज्ञापन यूनिट से जोड़ें. इसके बाद, हो गया पर क्लिक करें.

अब आपको विज्ञापन यूनिट कार्ड दिखेगा, जिसमें आपने जो विज्ञापन यूनिट चुनी हैं वे दिखेंगी:

Unity Ads को विज्ञापन स्रोत के तौर पर जोड़ना

विज्ञापन स्रोत सेक्शन में, वॉटरफ़ॉल कार्ड में जाकर, विज्ञापन स्रोत जोड़ें को चुनें. इसके बाद, Unity Ads चुनें.

Unity Ads चुनें और ऑप्टिमाइज़ करें स्विच को चालू करें. Unity Ads के लिए विज्ञापन स्रोत का ऑप्टिमाइज़ेशन सेट अप करने के लिए, पिछले सेक्शन में मिले एपीआई पासकोड और संगठन का कोर आईडी डालें. इसके बाद, Unity Ads के लिए eCPM वैल्यू डालें और जारी रखें पर क्लिक करें.

अगर आपके पास पहले से ही Unity Ads के लिए मैपिंग है, तो उसे चुना जा सकता है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें पर क्लिक करें.

इसके बाद, पिछले सेक्शन में मिले गेम आईडी और प्लेसमेंट आईडी डालें. इसके बाद, हो गया पर क्लिक करें.

ध्यान दें: विज्ञापन स्रोत के ऑप्टिमाइज़ेशन में कुछ दिन लगते हैं, ताकि किसी मीडिएशन नेटवर्क के लिए eCPM का सटीक हिसाब लगाया जा सके. इस दौरान, विज्ञापन सोर्स के ऑप्टिमाइज़ेशन की स्थिति PENDING है. इसलिए, आपको नेटवर्क के लिए eCPM वैल्यू को मैन्युअल तरीके से सेट करना होगा. eCPM का हिसाब लगाने के बाद, विज्ञापन स्रोत आपकी ओर से eCPM को अपने-आप अपडेट करना शुरू कर देता है.

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

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

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

CocoaPods का इस्तेमाल करना (सुझाया गया)

अपने प्रोजेक्ट की Podfile में यह लाइन जोड़ें:
```
pod 'GoogleMobileAdsMediationUnity'
```
कमांड लाइन से चलाएं:
```
pod install --repo-update
```

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

Unity Ads SDK का सबसे नया वर्शन डाउनलोड करें और अपने प्रोजेक्ट में UnityAds.framework को लिंक करें.
बदलावों की जानकारी में दिए गए डाउनलोड लिंक से, Unity Ads अडैप्टर का नया वर्शन डाउनलोड करें. इसके बाद, अपने प्रोजेक्ट में UnityAdapter.framework को लिंक करें.

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

ईयू (यूरोपीय संघ) की सहमति और जीडीपीआर

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

SDK टूल के 2.0.0 वर्शन में, Unity Ads ने निजता सेटिंग के साथ काम करने के लिए एक एपीआई जोड़ा है. यहां दिए गए सैंपल कोड में, सहमति की इस जानकारी को Unity Ads SDK टूल को पास करने का तरीका बताया गया है. अगर आपको सहमति की जानकारी को Unity Ads SDK टूल में मैन्युअल तरीके से भेजना है, तो हमारा सुझाव है कि Google Mobile Ads SDK टूल की मदद से विज्ञापनों का अनुरोध करने से पहले, इस कोड को कॉल करें.

Swift

import UnityAds
// ...

let gdprMetaData = UADSMetaData()
gdprMetaData.set("gdpr.consent", value: true)
gdprMetaData.commit()

Objective-C

#import <UnityAds/UnityAds.h>
// ...

UADSMetaData *gdprMetaData = [[UADSMetaData alloc] init];
[gdprMetaData set:@"gdpr.consent" value:@YES];
[gdprMetaData commit];

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

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

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

Swift

import UnityAds
// ...

let ccpaMetaData = UADSMetaData()
ccpaMetaData.set("privacy.consent", value: true)
ccpaMetaData.commit()

Objective-C

#import <UnityAds/UnityAds.h>
// ...

UADSMetaData *ccpaMetaData = [[UADSMetaData alloc] init];
[ccpaMetaData set:@"privacy.consent" value:@YES];
[ccpaMetaData commit];

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

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

SKAdNetwork इंटिग्रेशन

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

कंपाइल करने से जुड़ी गड़बड़ियां

Swift

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

Objective-C

Unity Ads अडैप्टर 4.4.0.0 या इसके बाद के वर्शन के लिए, आपको Unity दस्तावेज़ में दिए गए इंटिग्रेशन के तरीके अपनाने होंगे.

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

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

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

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

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

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

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

GADMAdapterUnity
GADMediationAdapterUnity

जब कोई विज्ञापन लोड नहीं होता है, तो 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 टूल, एक ही प्लेसमेंट के लिए एक से ज़्यादा विज्ञापन लोड करने की सुविधा नहीं देता.