मीडिएशन के साथ PubMatic OpenWrap (बीटा) को इंटिग्रेट करना

प्लैटफ़ॉर्म चुनें: Android (बीटा वर्शन) Android iOS Unity Flutter

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

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

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

इंटिग्रेशन
बिडिंग	^1
झरना
फ़ॉर्मैट
ऐप का खुलना
बैनर
मध्यवर्ती	^2
इनाम दिया गया	^2
इनाम वाला इंटरस्टीशियल विज्ञापन

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

² बैनर के अलावा, विज्ञापन के अन्य सभी फ़ॉर्मैट, ऐल्फ़ा वर्शन में उपलब्ध हैं.

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

• Google Mobile Ads Unity Plugin पर अपलोड हुआ नया वीडियो
• Unity 2019.4 या इसके बाद का वर्शन
• Android पर डिप्लॉय करने के लिए
  • Android का एपीआई लेवल 23 या इसके बाद का वर्शन
• iOS पर डिप्लॉय करने के लिए
  • iOS डिप्लॉयमेंट का टारगेट 12.0 या इसके बाद का वर्शन होना चाहिए
• Google Mobile Ads Unity Plugin के साथ कॉन्फ़िगर किया गया ऐसा Unity प्रोजेक्ट जिस पर काम किया जा सकता हो. ज़्यादा जानकारी के लिए, Google Mobile Ads Unity Plugin सेट अप करना लेख पढ़ें.
• AdMob मीडिएशन सेट अप करना

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

अपने PubMatic खाते में लॉग इन करें और OpenWrap SDK कार्ड चुनें.

नया ऐप्लिकेशन जोड़ना

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

अपने ऐप्लिकेशन के लिए, प्लैटफ़ॉर्म, ऐप्लिकेशन स्टोर का यूआरएल, और ऐप्लिकेशन का नाम चुनें.

Android

इंटिग्रेशन पाथ में जाकर, Unity चुनें. इसके बाद, सब-इंटिग्रेशन पाथ के तौर पर AdMob - SDK बिडिंग चुनें. इसके बाद, ऐप्लिकेशन जोड़ें बटन पर क्लिक करें.

iOS

इंटिग्रेशन पाथ में जाकर, Unity चुनें. इसके बाद, सब-इंटिग्रेशन पाथ के तौर पर AdMob - SDK बिडिंग चुनें. इसके बाद, ऐप्लिकेशन जोड़ें बटन पर क्लिक करें.

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

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

ऐप्लिकेशन को फ़ाइनल करने से पहले, आपको अपनी app-ads.txt में जोड़ने के लिए सही एंट्री दिखाई जाएंगी.

PubMatic के लिए app-ads.txt लागू करने के तरीके के बारे में ज़्यादा जानकारी के लिए, app-ads.txt लागू करने का तरीका लेख पढ़ें.

प्रोफ़ाइल आईडी

ऐप्लिकेशन बन जाने के बाद, ऐप्लिकेशन टैब पर जाएं और नए ऐप्लिकेशन के प्रोफ़ाइल आईडी को नोट करें.

विज्ञापन इकाई बनाएं

विज्ञापन यूनिट टैब में जाकर, पिछले सेक्शन में बनाया गया ऐप्लिकेशन चुनें. इसके बाद, विज्ञापन यूनिट बनाएं बटन पर क्लिक करें.

फ़ॉर्म में अपनी विज्ञापन यूनिट की जानकारी भरें और सेव करें पर क्लिक करें.

नई बनाई गई OpenWrap विज्ञापन यूनिट आईडी को नोट करें.

अपना पब्लिशर आईडी पाना

Analytics डैशबोर्ड पर जाएं. प्रोफ़ाइल आइकॉन पर कर्सर घुमाएं और अपना आईडी नोट करें.

दूसरा चरण: AdMob के यूज़र इंटरफ़ेस (यूआई) में PubMatic की डिमांड सेट अप करना

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

Android

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

iOS

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

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

अहम जानकारी: पक्का करें कि आपके पास खाते के मैनेजमेंट की अनुमति हो, ताकि आप ईयू उपयोगकर्ता की सहमति और जीडीपीआर, अमेरिका के राज्यों में लागू कानूनों, और User Messaging Platform के लिए कॉन्फ़िगरेशन पूरा कर सकें. ज़्यादा जानकारी के लिए, अपने खाते में उपयोगकर्ता के ऐक्सेस को मैनेज करना लेख पढ़ें.

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

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

ध्यान दें: साथ काम करने वाले PubMatic और Google Mobile Ads Unity Plugin के वर्शन इंटिग्रेट न होने पर, बिल्ड से जुड़ी समस्याएं आ सकती हैं.

OpenUPM-CLI

अहम जानकारी: अगर आपको .unitypackage से OpenUPM-CLI पर माइग्रेट करना है, तो आपको पुरानी जगह से ऐसेट को मैन्युअल तरीके से अनइंस्टॉल करना होगा. इसके लिए, Assets/GoogleMobileAds/Mediation/PubMatic फ़ोल्डर से सभी फ़ाइलें मिटाएं.

अगर आपने OpenUPM-CLI इंस्टॉल किया है, तो अपने प्रोजेक्ट में Google Mobile Ads PubMatic OpenWrap SDK Mediation Plugin for Unity को इंस्टॉल किया जा सकता है. इसके लिए, अपने प्रोजेक्ट की रूट डायरेक्ट्री से यह कमांड चलाएं:

openupm add com.google.ads.mobile.mediation.pubmatic

OpenUPM

अहम जानकारी: अगर आपको .unitypackage से OpenUPM पर माइग्रेट करना है, तो आपको पुरानी जगह से ऐसेट को मैन्युअल तरीके से अनइंस्टॉल करना होगा. इसके लिए, Assets/GoogleMobileAds/Mediation/PubMatic फ़ोल्डर से सभी फ़ाइलें मिटाएं.

अपने यूनिटी प्रोजेक्ट एडिटर में, बदलाव करें > प्रोजेक्ट सेटिंग > Package Manager को चुनें. इससे Unity Package Manager की सेटिंग खुल जाएंगी.

स्कोप की गई रजिस्ट्री टैब में जाकर, OpenUPM को स्कोप की गई रजिस्ट्री के तौर पर जोड़ें. इसके लिए, यह जानकारी दें:

• नाम: OpenUPM
• URL: https://package.openupm.com
• स्कोप: com.google

इसके बाद, विंडो > पैकेज मैनेजर पर जाकर, Unity Package Manager खोलें. इसके बाद, ड्रॉप-डाउन मेन्यू से मेरी रजिस्ट्री चुनें.

Google Mobile Ads PubMatic Mediation पैकेज चुनें और Install पर क्लिक करें.

Unity पैकेज

बदलाव की जानकारी में दिए गए डाउनलोड लिंक से, PubMatic OpenWrap SDK के लिए Google Mobile Ads मीडिएशन प्लगिन का नया वर्शन डाउनलोड करें. इसके बाद, ज़िप फ़ाइल से GoogleMobileAdsPubMaticMediation.unitypackage को निकालें.

अपने यूनिटी प्रोजेक्ट एडिटर में, ऐसेट > पैकेज इंपोर्ट करें > कस्टम पैकेज चुनें. इसके बाद, डाउनलोड की गई GoogleMobileAdsPubMaticMediation.unitypackage फ़ाइल ढूंढें. पक्का करें कि सभी फ़ाइलें चुनी गई हों. इसके बाद, इंपोर्ट करें पर क्लिक करें.

इसके बाद, ऐसेट > External Dependency Manager > Android Resolver > Force Resolve को चुनें. External Dependency Manager लाइब्रेरी, डिपेंडेंसी को शुरू से हल करेगी. साथ ही, एलान की गई डिपेंडेंसी को आपके Unity ऐप्लिकेशन की Assets/Plugins/Android डायरेक्ट्री में कॉपी करेगी.

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

ईयू उपयोगकर्ता की सहमति से जुड़ी नीति और जीडीपीआर

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

PubMatic, जीडीपीआर के तहत सहमति को मैनेज करने वाले उन प्लैटफ़ॉर्म से सेट की गई सहमति को अपने-आप पढ़ लेता है जो Google के अन्य सहमति मोड की तकनीकी जानकारी के साथ काम करते हैं. इनमें UMP SDK भी शामिल है. ज़्यादा जानकारी के लिए, जीडीपीआर और जीडीपीआर के तहत सहमति लेने की ज़रूरी शर्तें पूरी करना लेख पढ़ें.

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

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

PubMatic, सीसीपीए के तहत दी गई सहमति को अपने-आप पढ़ लेता है. यह सहमति, Google के अन्य सहमति मोड की तकनीकी जानकारी के साथ काम करने वाले कंसेंट मैनेजमेंट प्लैटफ़ॉर्म (सीएमपी) से सेट की जाती है. इसमें UMP SDK भी शामिल है. ज़्यादा जानकारी के लिए, सीसीपीए स्ट्रिंग सेट करना लेख पढ़ें.

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

Android

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

iOS

SKAdNetwork इंटिग्रेशन

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

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

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

पक्का करें कि आपने AdMob के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो.

अहम जानकारी: अपने ऐप्लिकेशन को रिलीज़ करने से पहले, AdMob और PubMatic OpenWrap SDK के लिए टेस्ट मोड बंद करें.

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

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

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

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

Android

com.pubmatic.sdk
com.google.ads.mediation.pubmatic

iOS

GADMediationAdapterPubMatic

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

Android

गड़बड़ी का कोड	डोमेन	वजह
101	com.google.ads.mediation.pubmatic	सर्वर कॉन्फ़िगरेशन में ज़रूरी पब्लिशर आईडी मौजूद नहीं है.
102	com.google.ads.mediation.pubmatic	विज्ञापन लोड करने के लिए, विज्ञापन कॉन्फ़िगरेशन अमान्य है.
103	com.google.ads.mediation.pubmatic	विज्ञापन नहीं दिखाया जा सका, क्योंकि वह तैयार नहीं था.
1001-5002	PubMatic SDK टूल ने भेजा	PubMatic SDK से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, PubMatic का दस्तावेज़ देखें.

iOS

गड़बड़ी का कोड	डोमेन	वजह
101	com.google.ads.mediation.pubmatic	सर्वर कॉन्फ़िगरेशन में ज़रूरी पब्लिशर आईडी मौजूद नहीं है.
102	com.google.ads.mediation.pubmatic	बिडिंग सिग्नल इकट्ठा करने का अनुरोध पूरा नहीं हो सका. ऐसा इसलिए हुआ, क्योंकि अनुरोध के पैरामीटर में कई फ़ॉर्मैट, कोई फ़ॉर्मैट या इस्तेमाल नहीं किया जा सकने वाला फ़ॉर्मैट तय किया गया था.
103	com.google.ads.mediation.pubmatic	विज्ञापन लोड करने के लिए, विज्ञापन कॉन्फ़िगरेशन अमान्य है.
104	com.google.ads.mediation.pubmatic	विज्ञापन तैयार न होने की वजह से, अचानक दिखने वाला विज्ञापन नहीं दिखाया जा सका.
105	com.google.ads.mediation.pubmatic	इनाम वाला विज्ञापन नहीं दिखाया जा सका, क्योंकि विज्ञापन तैयार नहीं था.
106	com.google.ads.mediation.pubmatic	नेटिव विज्ञापन की इमेज के किसी सोर्स को लोड नहीं किया जा सका.
1001-5002	PubMatic SDK टूल ने भेजा	PubMatic SDK से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, PubMatic का दस्तावेज़ देखें.

PubMatic Unity Mediation Plugin के बदलावों की जानकारी

वर्शन 1.4.0

• PubMatic Android अडैप्टर के 4.11.0.0 वर्शन के साथ काम करता है.
• PubMatic iOS अडैप्टर के 4.11.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Unity प्लगिन के 10.6.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.3.1

• PubMatic Android अडैप्टर के वर्शन 4.10.0.1 के साथ काम करता है.
• PubMatic iOS अडैप्टर के 4.10.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Unity प्लगिन के 10.6.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.3.0

• PubMatic Android अडैप्टर के 4.10.0.0 वर्शन के साथ काम करता है.
• PubMatic iOS अडैप्टर के 4.10.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Unity प्लगिन के 10.6.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.2.0

• PubMatic Android अडैप्टर 4.9.1.0 के साथ काम करता है.
• PubMatic iOS अडैप्टर के 4.9.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Unity प्लगिन के 10.5.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.1.0

• PubMatic Android अडैप्टर 4.9.1.0 के साथ काम करता है.
• PubMatic iOS अडैप्टर के 4.8.1.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Unity प्लगिन के 10.5.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.0.0

• पहली रिलीज़!
• PubMatic Android अडैप्टर वर्शन 4.8.0.0 के साथ काम करता है.
• PubMatic iOS अडैप्टर के 4.8.1.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Unity प्लगिन के 10.4.2 वर्शन के साथ बनाया और टेस्ट किया गया है.