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

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

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

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

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

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

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

Android API का लेवल 19 या उसके बाद वाला वर्शन

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

टेस्ट मोड को 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.0.0")
    implementation("com.unity3d.ads:unity-ads:4.9.3")
    implementation("com.google.ads.mediation:unity:4.9.3.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 की निजता सहमति और डेटा एपीआई और जीडीपीआर का पालन करना ज़्यादा जानकारी और हर तरीके में दी जा सकने वाली वैल्यू के लिए गाइड देखें.

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

अमेरिका के निजता कानून उपयोगकर्ताओं को यह अधिकार देना ज़रूरी है कि वे अपनी "निजी जानकारी" को "बेचने" से ऑप्ट आउट कर सकें (जैसा कि कानून में उन शर्तों के बारे में बताया गया है). साथ ही, "बिक्री" पार्टी के होम पेज पर "मेरी निजी जानकारी न बेचें" लिंक से, "मेरी निजी जानकारी न बेचें" विकल्प से ऑप्ट-आउट करने का अधिकार देना ज़रूरी है. अमेरिका के निजता कानून के पालन से जुड़ी गाइड में, 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 की निजता के लिए सहमति और डेटा एपीआई और सीसीपीए का पालन करना ज़्यादा जानकारी और तरीकों में दी जा सकने वाली वैल्यू के लिए गाइड देखें.

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

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

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

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

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

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

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

गड़बड़ी कोड

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

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