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

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

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

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

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

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

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

Android का एपीआई लेवल 21 या उसके बाद का वर्शन

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

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

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

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

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

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

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

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

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

फ़ॉर्म भरें, फिर प्रोजेक्ट जोड़ें पर क्लिक करें.

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

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

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

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

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

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

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

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

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

Unity Ads Reporting API कुंजी खोजें

बिडिंग

बिडिंग इंटिग्रेशन के लिए, ऐसा करना ज़रूरी नहीं है.

वॉटरफ़ॉल

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

विज्ञापन नेटवर्क के तौर पर Unity Ads चुनें और यूनीक नाम डालें. साथ ही, मीडिएशन की सुविधा चालू करें.

अपने-आप डेटा इकट्ठा होने की सुविधा को चालू करें और पिछले सेक्शन में मौजूद API Key and Organization core ID को डालें.

यील्ड पार्टनर चुनने के बाद, इंटिग्रेशन टाइप के तौर पर मोबाइल SDK टूल मीडिएशन, प्लैटफ़ॉर्म के तौर पर Android, और स्टेटस के तौर पर ऐक्टिव चुनें. पिछले सेक्शन में दिए गए Game ID and Placement ID कोड को डालें. इसके बाद, डिफ़ॉल्ट सीपीएम वैल्यू डालें.

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

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

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

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

Android Studio इंटिग्रेशन (सुझाया गया)

अपने ऐप्लिकेशन-लेवल की build.gradle.kts फ़ाइल में, लागू करने की इन निर्भरता और कॉन्फ़िगरेशन जोड़ें. Unity Ads SDK टूल और अडैप्टर के सबसे नए वर्शन का इस्तेमाल करें:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.2.0")
    implementation("com.unity3d.ads:unity-ads:4.12.1")
    implementation("com.google.ads.mediation:unity:4.12.1.0")
}

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

Unity Ads SDK (unity-ads.aar) का सबसे नया वर्शन, GitHub की रिपॉज़िटरी से डाउनलोड करें और उसे अपने प्रोजेक्ट में जोड़ें.
Google की Maven रिपॉज़िटरी में, Unity Ads के लिए अडैप्टर के आर्टफ़ैक्ट पर जाएं. सबसे नया वर्शन चुनें, Unity Ads अडैप्टर की .aar फ़ाइल डाउनलोड करें और उसे अपने प्रोजेक्ट में जोड़ें.

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

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

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

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

Java

import com.unity3d.ads.metadata.MetaData;
// ...

MetaData gdprMetaData = new MetaData(this);
gdprMetaData.set("gdpr.consent", true);
gdprMetaData.commit();

Kotlin

import com.unity3d.ads.metadata.MetaData
// ...

val gdprMetaData = MetaData(this)
gdprMetaData["gdpr.consent"] = true
gdprMetaData.commit()

Unity Ads की Privacy Consent and data API और जीडीपीआर का पालन करना ज़्यादा जानकारी और हर तरीके में दी जा सकने वाली वैल्यू के लिए गाइड देखें.

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

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

Java

import com.unity3d.ads.metadata.MetaData;
// ...

MetaData ccpaMetaData = new MetaData(this);
ccpaMetaData.set("privacy.consent", true);
ccpaMetaData.commit();

Kotlin

import com.unity3d.ads.metadata.MetaData
// ...

val ccpaMetaData = MetaData(this)
ccpaMetaData["privacy.consent"] = true
ccpaMetaData.commit()

Unity Ads की Privacy Consent and data API और सीसीपीए का पालन करना ज़्यादा जानकारी और हर तरीके में दी जा सकने वाली वैल्यू के लिए गाइड देखें.

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

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

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

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

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

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

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

गड़बड़ी कोड

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

com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter

यहां किसी विज्ञापन के लोड न होने पर, UnityAds अडैप्टर से भेजे गए कोड और उनके साथ दिखने वाले मैसेज दिए गए हैं:

गड़बड़ी का कोड	वजह
0-10	UnityAds SDK टूल में कोई गड़बड़ी मिली है. ज़्यादा जानकारी के लिए कोड देखें.
101	Ad Manager यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगर किए गए UnityAds सर्वर के पैरामीटर मौजूद नहीं हैं या अमान्य हैं.
102	UnityAds ने NO_FILL की स्थिति में एक प्लेसमेंट दिखाया.
103	UnityAds का प्लेसमेंट बंद किया गया, लेकिन इसकी स्थिति 'बंद है' पर सेट की गई.
104	UnityAds ने एक ऐसा विज्ञापन दिखाने की कोशिश की जिसमें शून्य संदर्भ दिया गया था.
105	Unity Ads से विज्ञापनों को शुरू करने, लोड करने, और/या दिखाने के लिए इस्तेमाल किया जाने वाला कॉन्टेक्स्ट, ऐक्टिविटी इंस्टेंस नहीं है.
106	UnityAds ने एक ऐसा विज्ञापन दिखाने की कोशिश की जो दिखाए जाने के लिए तैयार नहीं है.
107	इस डिवाइस पर UnityAds का इस्तेमाल नहीं किया जा सकता.
108	UnityAds, हर प्लेसमेंट के लिए एक बार में सिर्फ़ एक विज्ञापन लोड कर सकता है.
109	UnityAds में गड़बड़ी की स्थिति दिखी.
200-204	UnityAds बैनर से जुड़ी गड़बड़ी की जानकारी. ज़्यादा जानकारी के लिए कोड देखें.
0-9	UnityAds SDK टूल में कोई गड़बड़ी मिली है. ज़्यादा जानकारी के लिए, Unity का दस्तावेज़ देखें.
101	Ad Manager यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगर किए गए UnityAds सर्वर के पैरामीटर मौजूद नहीं हैं या अमान्य हैं.
102	यह डिवाइस UnityAds के साथ काम नहीं करता.
103	UnityAds की स्क्रीन पर गड़बड़ी की स्थिति kUnityAdsFinishStateError के साथ पूरी हुई.
104	Unity विज्ञापन ऑब्जेक्ट को शुरू करने वाले टूल को कॉल करने के बाद, यह शून्य हो जाता है.
105	विज्ञापन तैयार नहीं है, इसलिए Unity विज्ञापन नहीं दिखाया जा सका.
106	UnityAds का नाम एक ऐसे प्लेसमेंट को बदलने वाला कॉलबैक है जिसकी प्लेसमेंट स्थिति kUnityAds placementStateNoFill से की गई.
107	UnityAds का नाम एक ऐसे प्लेसमेंट को बदलने वाला कॉलबैक है जिसकी प्लेसमेंट स्थिति kUnityAdsplacementDisplayd पर नहीं.
108	इस प्लेसमेंट के लिए एक विज्ञापन पहले ही लोड किया जा चुका है. UnityAds SDK टूल, एक ही प्लेसमेंट के लिए कई विज्ञापन लोड नहीं करता.