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

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

इस गाइड में, 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 कुंजी खोजें

बिडिंग

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

झरना

गेम आईडी और प्लेसमेंट आईडी के अलावा, आपको अपने Unity Ads API Key और Organization कोर आईडी: Ad Manager विज्ञापन यूनिट का आईडी.

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

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

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

परीक्षण मोड को यहां से सक्षम किया जा सकता है: 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.3.0")
    implementation("com.unity3d.ads:unity-ads:4.12.1")
    implementation("com.google.ads.mediation:unity:4.12.2.0")
}

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

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

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

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

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

SDK टूल के वर्शन 2.0.0 में, Unity Ads ने निजता सेटिंग के साथ काम करने के लिए एक एपीआई जोड़ा है. कॉन्टेंट बनाने यहां दिए गए सैंपल कोड में, Unity के लिए सहमति की इस जानकारी को भेजने का तरीका बताया गया है Google Ads SDK टूल. क्या आपको Unity 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 के लिए विज्ञापन देखें Privacy Consent and Data API और जीडीपीआर का पालन करना गाइड देखें.

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

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