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

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

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

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

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

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

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

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

iOS डिप्लॉयमेंट टारगेट 12.0 या उसके बाद का होना चाहिए

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

बिडिंग

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

झरना

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

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

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

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

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

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

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

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

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

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

अपने Ad Manager खाते में साइन इन करें.

डिलीवरी > Yiel ग्रुप पर जाएं और नया Yiel ग्रुप बटन पर क्लिक करें.

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

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

अगर आपके पास Unity Ads के लिए पहले से ही कोई यील्ड पार्टनर है, तो उसे चुना जा सकता है. इसके अलावा, नया यील्ड पार्टनर बनाएं को चुनें.

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

डेटा अपने-आप इकट्ठा होने की सुविधा चालू करें. इसके बाद, पिछले सेक्शन में मिले एपीआई पासकोड और संगठन का कोर आईडी डालें.

यील्ड पार्टनर चुनने के बाद, इंटिग्रेशन टाइप के तौर पर Mobile SDK मीडिएशन, प्लैटफ़ॉर्म के तौर पर iOS, और स्टेटस के तौर पर चालू है चुनें. पिछले सेक्शन में मिले गेम आईडी और प्लेसमेंट आईडी डालें. इसके बाद, डिफ़ॉल्ट सीपीएम वैल्यू डालें.

इसके बाद, पेज पर सबसे नीचे सेव करें पर क्लिक करें.

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

Ad Manager के यूज़र इंटरफ़ेस (यूआई) में, जीडीपीआर और अमेरिका के कानूनों के तहत विज्ञापन पार्टनर की सूची में 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 दस्तावेज़ में इंटिग्रेशन के तरीके अपनाने होंगे.

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

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

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

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

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

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

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

GADMAdapterUnity
GADMediationAdapterUnity

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

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