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

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

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

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

इंटिग्रेशन
बिडिंग
वॉटरफ़ॉल  1
फ़ॉर्मैट
ऐप का खुलना
बैनर
इंटरस्टीशियल विज्ञापन
इनाम वाले विज्ञापन
इनाम वाला इंटरस्टीशियल विज्ञापन
मूल भाषा वाला

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

जारी रखने से पहले, इनकी पुष्टि करें:

  • Google Mobile Ads SDK for React Native का नया वर्शन.
  • React Native फ़्रेमवर्क का वर्शन 0.85.0 या इसके बाद का वर्शन.
  • Android पर डिप्लॉय करने के लिए
    • Android एपीआई लेवल 24 या इसके बाद का वर्शन.
  • iOS पर डिप्लॉय करने के लिए
    • iOS डिप्लॉयमेंट का टारगेट 13.0 या इसके बाद का वर्शन होना चाहिए.
  • Google Mobile Ads SDK for React Native के साथ कॉन्फ़िगर किया गया ऐसा React Native प्रोजेक्ट जिस पर काम किया जा सकता हो. ज़्यादा जानकारी के लिए, Google Mobile Ads SDK for React Native सेट अप करना लेख पढ़ें.
    • पक्का करें कि आपने gma-sdk-react-native फ़ोल्डर से adapters फ़ोल्डर को डाउनलोड और एक्सट्रैक्ट कर लिया हो. अगर आपके पास adapters फ़ोल्डर नहीं है, तो Google Mobile Ads SDK for React Native इंस्टॉल करें में जाकर, पहला, दूसरा, और तीसरा चरण अपनाएं.
  • AdMob मीडिएशन सेट अप करें.

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

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

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

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

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

Unity Ads Monetization पर जाएं. इसके बाद, Get started पर क्लिक करें.

New Project मॉडल में, I will use Mediation को चुनें. इसके बाद, Mediation Partner के लिए Google Admob को चुनें और Next पर क्लिक करें.

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

प्लेसमेंट सेटअप चुनें. इसके बाद, आगे बढ़ें पर क्लिक करें.

बिडिंग

वॉटरफ़ॉल

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

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

विज्ञापन यूनिट और प्लेसमेंट बनाना

Unity Ads Monetization > Placements पर जाएं. इसके बाद, अपना प्रोजेक्ट चुनें और विज्ञापन यूनिट जोड़ें पर क्लिक करें.

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

Android

iOS

बिडिंग

सेटअप के लिए, बिडिंग चुनें. प्लेसमेंट में जाकर, प्लेसमेंट का नाम डालें.

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

वॉटरफ़ॉल

सेटअप के लिए, वॉटरफ़ॉल चुनें. प्लेसमेंट में जाकर, प्लेसमेंट का नाम, जियो टैगिंग, और टारगेट डालें.

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

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

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

बिडिंग

बिडिंग इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.

वॉटरफ़ॉल

Unity Ads Monetization > API management पर जाएं. इसके बाद, Monetization Stats API Access में जाकर, एपीआई पासकोड को नोट करें.

इसके बाद, Unity Ads Monetization > Organization Settings पर जाएं और Organization core ID को नोट करें.

app-ads.txt फ़ाइल अपडेट करना

ऐप्लिकेशन के लिए, अनुमति वाले सेलर (app-ads.txt), IAB Tech Lab की एक पहल है. इसकी मदद से यह पक्का किया जा सकता है कि आपके ऐप्लिकेशन की विज्ञापन इन्वेंट्री सिर्फ़ वे चैनल बेचें जिन्हें आपने अनुमति दी है. विज्ञापन से मिलने वाले रेवेन्यू में ज़्यादा नुकसान न हो, इसके लिए आपको app-ads.txt फ़ाइल लागू करनी होगी. अगर आपने अब तक ऐसा नहीं किया है, तो अपने ऐप्लिकेशन के लिए app-ads.txt फ़ाइल सेट अप करें.

Unity Ads के लिए app-ads.txt लागू करने के लिए, पहली बार app-ads.txt सेट अप करना देखें.

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

टेस्ट मोड को Unity Ads डैशबोर्ड से चालू किया जा सकता है. Unity Ads Monetization > Testing पर जाएं.

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

Android

iOS

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

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

दूसरा चरण: AdMob के यूआई में Unity Ads की डिमांड सेट अप करना

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

Android

निर्देशों के लिए, Android के लिए दी गई गाइड में दूसरा चरण देखें.

iOS

निर्देशों के लिए, iOS की गाइड में दूसरा चरण देखें.

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

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

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

अपने प्रोजेक्ट की रूट डायरेक्ट्री में, Unity Ads के लिए Google Mobile Ads SDK for React Native मीडिएशन अडैप्टर इंस्टॉल करें. नीचे दिए गए कदमों को पूरा करें:

  1. Google Mobile Ads SDK for React Native अडैप्टर की tar फ़ाइल को gma-sdk-react-native/adapters/unity/ डायरेक्ट्री से अपने प्रोजेक्ट की local_packages/ डायरेक्ट्री में कॉपी करें. अगर आपके पास adapters फ़ोल्डर नहीं है, तो ज़रूरी शर्तें देखें.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/unity/gma-mediation-unity-0.1.0.tgz local_packages/

    EXTRACT_DIR को उस डायरेक्ट्री के पाथ से बदलें जहां आपने संग्रह को एक्सट्रैक्ट किया है.

  2. अपने पसंदीदा पैकेज मैनेजर का इस्तेमाल करके, अडैप्टर पैकेज इंस्टॉल करें:

    npm

    npm install ./local_packages/gma-mediation-unity-0.1.0.tgz

    ऊन

    yarn add ./local_packages/gma-mediation-unity-0.1.0.tgz

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

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

Unity Ads React Native अडैप्टर का वर्शन 0.1.0 और इसके बाद के वर्शन, जीडीपीआर के तहत सहमति के सिग्नल को Unity Ads विज्ञापन के लिए इस्तेमाल होने वाले एसडीके टूल को पास करने की सुविधा देते हैं. ये सिग्नल, सहमति मैनेज करने वाले उन प्लैटफ़ॉर्म से पास किए जाते हैं जो IAB के पारदर्शिता और सहमति फ़्रेमवर्क (टीसीएफ़) के साथ इंटिग्रेट होते हैं. ज़्यादा जानकारी के लिए, टीसीएफ़ या नॉन-टीसीएफ़ सहमति कॉन्फ़िगरेशन सेट अप करना लेख पढ़ें.

अमेरिका के राज्यों के निजता कानून

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

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

import { UnityMediation } from '@google/gma-mediation-unity';
// ...

UnityMediation.setCCPAConsent(false);

उम्र के हिसाब से विज्ञापन दिखाने की सेटिंग सेट करना

Unity Ads मीडिएशन प्लग इन का 0.1.0 और इसके बाद का वर्शन, बच्चों के लिए बनी सेटिंग और सहमति देने की मान्य उम्र से कम उम्र के उपयोगकर्ताओं की सेटिंग को Unity Ads को फ़ॉरवर्ड करता है.

हर उपयोगकर्ता के हिसाब से इन सिग्नल को प्रोसेस करने के लिए, Unity Ads को Unity Monetization डैशबोर्ड में मिली-जुली ऑडियंस को चालू करना होगा. अपने प्रोजेक्ट के लिए, मिली-जुली ऑडियंस के लिए उपलब्ध होने की जानकारी देने वाली सुविधा चालू करने के बारे में ज़्यादा जानने के लिए, गेम के लेवल पर उम्र से जुड़ी जानकारी सेट करना लेख पढ़ें.

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

Android

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

iOS

SKAdNetwork इंटिग्रेशन

अपने प्रोजेक्ट की Info.plist फ़ाइल में SKAdNetwork आइडेंटिफ़ायर जोड़ने के लिए, Unity Ads के दस्तावेज़ पढ़ें.

छठा चरण: लागू किए गए बदलावों की जांच करना

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

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

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

यह पुष्टि करने के लिए कि आपको Unity Ads से टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन जांचने वाले टूल में Unity Ads (बिडिंग) और Unity Ads (वॉटरफ़ॉल) विज्ञापन सोर्स का इस्तेमाल करके, विज्ञापन के किसी एक सोर्स को टेस्ट करना चालू करें.

गड़बड़ी के कोड

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

Android

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

iOS

GADMAdapterUnity
GADMediationAdapterUnity

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

Android

गड़बड़ी का कोड कारण
0-10 UnityAds SDK से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, कोड देखें.
101 AdMob के यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए UnityAds सर्वर पैरामीटर मौजूद नहीं हैं या मान्य नहीं हैं.
102 UnityAds ने NO_FILL स्टेटस के साथ प्लेसमेंट दिखाया.
103 UnityAds ने 'बंद है' स्टेटस वाला प्लेसमेंट दिखाया.
104 UnityAds ने शून्य कॉन्टेक्स्ट वाला विज्ञापन दिखाने की कोशिश की.
105 Unity Ads से विज्ञापनों को शुरू करने, लोड करने, और/या दिखाने के लिए इस्तेमाल किया गया कॉन्टेक्स्ट, गतिविधि का इंस्टेंस नहीं है.
106 UnityAds ने ऐसा विज्ञापन दिखाने की कोशिश की जो दिखाने के लिए तैयार नहीं है.
107 डिवाइस पर UnityAds का इस्तेमाल नहीं किया जा सकता.
108 UnityAds, हर प्लेसमेंट के लिए एक बार में सिर्फ़ एक विज्ञापन लोड कर सकता है.
109 UnityAds, गड़बड़ी की स्थिति के साथ खत्म हुआ.
110 जिस विज्ञापन साइज़ का अनुरोध किया गया है वह UnityAds के साथ काम करने वाले बैनर के साइज़ से मेल नहीं खाता है.
111 शुरू करने के दौरान, UnityAds से गड़बड़ी का मैसेज मिला.
112 Unity Ads ने शून्य या खाली बिडिंग टोकन दिखाया.
200-204 UnityAds बैनर से जुड़ी कोई गड़बड़ी. ज़्यादा जानकारी के लिए, कोड देखें.

iOS

0-9 UnityAds SDK से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, Unity का दस्तावेज़ देखें.
101 AdMob के यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए UnityAds सर्वर पैरामीटर मौजूद नहीं हैं या मान्य नहीं हैं.
102 UnityAds इस डिवाइस पर काम नहीं करता.
103 UnityAds ने गड़बड़ी की स्थिति kUnityAdsFinishStateError के साथ विज्ञापन दिखाना बंद कर दिया.
104 इनिशलाइज़र को कॉल करने के बाद, Unity विज्ञापन ऑब्जेक्ट की वैल्यू शून्य हो जाती है.
105 विज्ञापन तैयार न होने की वजह से, Unity Ads के विज्ञापन नहीं दिखाए जा सके.
107 UnityAds ने प्लेसमेंट की स्थिति kUnityAdsPlacementStateDisabled के साथ, प्लेसमेंट में बदलाव किए जाने वाले कॉलबैक को कॉल किया.
108 इस प्लेसमेंट के लिए पहले से ही एक विज्ञापन लोड किया गया था. UnityAds SDK, एक ही प्लेसमेंट के लिए कई विज्ञापन लोड करने की सुविधा नहीं देता.
109 UnityAds से मिला बैनर विज्ञापन, अनुरोध किए गए साइज़ से मेल नहीं खाता.
110 शुरू करने के दौरान, UnityAds से गड़बड़ी का मैसेज मिला.
111 यह विज्ञापन फ़ॉर्मैट इस्तेमाल नहीं किया जा सकता.
112 UnityAds ने शून्य या खाली बिडिंग टोकन दिखाया.

वर्शन 0.1.0

  • शुरुआती रिलीज़.