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

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

इस गाइड में, मीडिएशन का इस्तेमाल करके, 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 डैशबोर्ड पर, प्रोजेक्ट पर जाएं और नया पर क्लिक करें.

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

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

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

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

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

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

विज्ञापन यूनिट और प्लेसमेंट बनाना

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

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

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

सेटअप के लिए, वॉटरफ़ॉल चुनें. प्लेसमेंट में जाकर, प्लेसमेंट का नाम, जियो टैगिंग, और टारगेट डालें.

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

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

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

बिडिंग

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

झरना

Unity Ads से कमाई करना > एपीआई मैनेजमेंट पर जाएं. इसके बाद, कमाई करने से जुड़े आंकड़े देखने के लिए एपीआई का ऐक्सेस में जाकर, एपीआई पासकोड को नोट करें.

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

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

Unity Ads डैशबोर्ड से टेस्ट मोड चालू किया जा सकता है. Unity Ads से कमाई करना > जांच करना पर जाएं.

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

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

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

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

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

कंपनियों में Unity Ads जोड़ना

बिडिंग

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

झरना

एडमिन > कंपनियां पर जाएं. इसके बाद, सभी कंपनियां टैब में नई कंपनी बटन पर क्लिक करें. विज्ञापन नेटवर्क चुनें.

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

आपको उपयोगकर्ता नाम या पासवर्ड डालने की ज़रूरत नहीं है. बदलाव करने के बाद, सेव करें पर क्लिक करें.

सुरक्षित सिग्नल शेयर करने की सुविधा चालू करना

बिडिंग

एडमिन > ग्लोबल सेटिंग पर जाएं. Ad Exchange खाते की सेटिंग टैब पर जाएं. इसके बाद, सुरक्षित सिग्नल शेयर करने की सुविधा की समीक्षा करें और उसे टॉगल करके चालू करें. सेव करें पर क्लिक करें.

झरना

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

बिड रिक्वेस्ट पर सुरक्षित सिग्नल शेयर करना

बिडिंग

इन्वेंट्री > सुरक्षित सिग्नल पर जाएं. सुरक्षित सिग्नल में जाकर, Unity Ads खोजें और ऐप्लिकेशन इंटिग्रेशन चालू करें को टॉगल करें.

सेव करें पर क्लिक करें.

झरना

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

SDK बिडिंग के लिए, सुरक्षित सिग्नल शेयर करने की अनुमति देना

बिडिंग

डिलीवरी > डिमांड चैनल की सेटिंग पर जाएं. डिफ़ॉल्ट सेटिंग टैब में, SDK बिडिंग के लिए, सुरक्षित सिग्नल शेयर करने की अनुमति दें को टॉगल करें.

सेव करें पर क्लिक करें.

झरना

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

Unity Ads बिडिंग को कॉन्फ़िगर करना

बिडिंग

डिलीवरी > बिड करने वाले पर जाएं और SDK Bidding पर जाएं पर क्लिक करें.

नया बिडर पर क्लिक करें.

बिडर के तौर पर Unity Ads चुनें.

इस बिडर के लिए SDK Bidding की सुविधा चालू करने के लिए, जारी रखें पर क्लिक करें.

हो गया पर क्लिक करें.

झरना

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

विज्ञापन यूनिट मैपिंग को कॉन्फ़िगर करना

बिडिंग

डिलीवरी > बिड करने वाले पर जाएं और SDK Bidding पर जाएं पर क्लिक करें.

Unity Ads के लिए कंपनी चुनें.

विज्ञापन यूनिट मैपिंग टैब पर जाएं और नई विज्ञापन यूनिट मैपिंग पर क्लिक करें.

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

झरना

डिलीवरी > नतीजे के ग्रुप पर जाएं और नया नतीजा ग्रुप बटन पर क्लिक करें. अपना मोबाइल ऐप्लिकेशन चुनें.

नीचे की ओर स्क्रोल करें और नतीजों के लिए पार्टनर जोड़ें पर क्लिक करें.

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

पिछले सेक्शन में मिले गेम आईडी और प्लेसमेंट आईडी के साथ-साथ डिफ़ॉल्ट सीपीएम की वैल्यू डालें. सेव करें पर क्लिक करें.

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

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