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

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

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

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

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

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

• Google Mobile Ads SDK का सबसे नया वर्शन
• Flutter 3.7.0 या इसके बाद का वर्शन
• Android पर डिप्लॉय करने के लिए
  • Android का एपीआई लेवल 21 या उसके बाद का वर्शन
• iOS पर डिप्लॉय करने के लिए
  • iOS 12.0 या इसके बाद का डिप्लॉयमेंट टारगेट
• Google के साथ कॉन्फ़िगर किया गया Flutter काम कर रहा प्रोजेक्ट मोबाइल विज्ञापन SDK टूल. ज़्यादा जानकारी के लिए, शुरू करें देखें.
• मध्यस्थता की प्रक्रिया पूरी करें शुरुआती निर्देश

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

pub.dev की मदद से इंटिग्रेशन

अपने पैकेज की pubspec.yaml फ़ाइल में,Unity Ads SDK टूल और अडैप्टर के नए वर्शन के साथ यह डिपेंडेंसी जोड़ें:

dependencies:
  gma_mediation_unity: ^1.0.0

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

इसके लिए Google मोबाइल विज्ञापन मीडिएशन प्लग-इन का सबसे नया वर्शन डाउनलोड करें Unity Ads, डाउनलोड की गई फ़ाइल को एक्सट्रैक्ट करें और एक्सट्रैक्ट किए गए प्लगिन फ़ोल्डर को जोड़ें (और इसकी सामग्री) को आपके Flutter प्रोजेक्ट में शामिल करना होगा. फिर, अपने pubspec.yaml फ़ाइल में यह डिपेंडेंसी जोड़कर:

dependencies:
  gma_mediation_unity:
    path: path/to/local/package

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

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

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

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

import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...

GmaMediationUnity.setGDPRConsent(true);

Unity के लिए विज्ञापन देखें Privacy Consent and Data API और जीडीपीआर का पालन करना गाइड देखें.

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

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

Unity Ads के लिए Google Mobile Ads मीडिएशन प्लग इन केमें, GmaMediationUnity.setCCPAConsent() का तरीका शामिल है. नीचे दिया गया सैंपल कोड यह बताता है कि सहमति की जानकारी कैसे Unity Ads SDK टूल. अगर आपको यह तरीका आज़माना है, तो हमारा सुझाव है कि आप Google Mobile Ads SDK टूल की मदद से विज्ञापनों का अनुरोध करने से पहले ऐसा करें.

import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...

GmaMediationUnity.setCCPAConsent(true);

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

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

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

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

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

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

गड़बड़ी कोड

अगर अडैप्टर को Unity Ads से कोई विज्ञापन नहीं मिलता है, तो पब्लिशर में मौजूद गड़बड़ी ResponseInfo ये क्लास:

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

GADMAdapterUnity
GADMediationAdapterUnity

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

Unity Ads Flutter मीडिएशन अडैप्टर का बदलावों का इतिहास

वर्शन 1.1.0

• Unity Android अडैप्टर के 4.12.2.0 वर्शन के साथ काम करने की पुष्टि की गई है
• Unity iOS अडैप्टर के वर्शन 4.12.2.0 के साथ काम करने की पुष्टि की गई
• इसे Google Mobile Ads Flutter प्लगिन वर्शन 5.1.0 की मदद से बनाया और टेस्ट किया गया है.

वर्शन 1.0.0

• शुरुआती रिलीज़.
• Unity Android अडैप्टर के 4.10.0.0 वर्शन के साथ काम करने की पुष्टि की गई है
• Unity iOS अडैप्टर के वर्शन 4.10.0.0 के साथ काम करने की पुष्टि की गई
• इसे Google Mobile Ads Flutter प्लगिन वर्शन 5.0.0 की मदद से बनाया और टेस्ट किया गया है.