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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

AdMob यूज़र इंटरफ़ेस (यूआई) में जीडीपीआर और अमेरिका के कानूनों के विज्ञापन पार्टनर की सूची में 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 Ads की Privacy Consent and data API और जीडीपीआर का पालन करने से जुड़ी गाइड देखें.

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

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

Unity Ads के लिए Google मोबाइल विज्ञापन मीडिएशन प्लगिन इसमें 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.3.0 के साथ काम करने की पुष्टि
• Unity iOS अडैप्टर के वर्शन 4.12.3.1 के साथ काम करने की पुष्टि
• इसे Google Mobile Ads Flutter प्लगिन वर्शन 5.2.0 की मदद से बनाया और टेस्ट किया गया है.

वर्शन 1.0.0

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