PubMatic को AdMob मीडिएशन (अलग-अलग नेटवर्क से विज्ञापन दिखाना) के साथ इंटिग्रेट करना

प्लैटफ़ॉर्म चुनें: Android iOS Unity Flutter React Native Android (लेगसी)

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

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

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

इंटिग्रेशन
बिडिंग
वॉटरफ़ॉल
फ़ॉर्मैट
ऐप का खुलना
बैनर
मध्यवर्ती	^1
इनाम दिया गया	^1
इनाम वाला इंटरस्टीशियल विज्ञापन
मूल भाषा वाला	^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 मीडिएशन सेट अप करें.

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

अपने PubMatic खाते में साइन अप या लॉग इन करें. इसके बाद, OpenWrap SDK कार्ड चुनें.

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

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

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

Android

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

iOS

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

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 OpenWrap SDK की डिमांड सेट अप करना

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

Android

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

iOS

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

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

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

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

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

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

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

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

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

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

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

   npm

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

   ऊन

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

3. अगर Android के लिए ऐप्लिकेशन बनाया जा रहा है, तो अपने प्रोजेक्ट की android डायरेक्ट्री में मौजूद build.gradle फ़ाइल में यह रिपॉज़िटरी जोड़ें:

   repositories {
       google()
       mavenCentral()
       maven {
           url = uri("https://repo.pubmatic.com/artifactory/public-repos")
       }
   }
   

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

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

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

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

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

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

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

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

Android

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

iOS

SKAdNetwork इंटिग्रेशन

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

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

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

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

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

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

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

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

अगर अडैप्टर को 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	विज्ञापन फ़ॉर्मैट, 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	इनाम वाला विज्ञापन शून्य है.
107	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	नेटिव विज्ञापन की इमेज के सोर्स में से किसी एक को लोड नहीं किया जा सका.
107	com.google.ads.mediation.pubmatic	विज्ञापन कॉन्फ़िगरेशन में पब्लिशर आईडी मौजूद नहीं है.
108	com.google.ads.mediation.pubmatic	विज्ञापन कॉन्फ़िगरेशन में प्रोफ़ाइल आईडी मौजूद नहीं है.
109	com.google.ads.mediation.pubmatic	विज्ञापन कॉन्फ़िगरेशन में, प्रोफ़ाइल आईडी के तौर पर नंबर के अलावा कुछ और शामिल है.
110	com.google.ads.mediation.pubmatic	विज्ञापन कॉन्फ़िगरेशन में विज्ञापन यूनिट आईडी मौजूद नहीं है.
111	com.google.ads.mediation.pubmatic	PubMatic OpenWrap SDK, विज्ञापन के साइज़ का इंस्टेंस नहीं बना सका.
1001-5002	PubMatic SDK से भेजा गया	PubMatic SDK से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, PubMatic का दस्तावेज़ देखें.

वर्शन 0.1.0

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

• इसमें PubMatic Android अडैप्टर के 5.3.0.1 वर्शन का इस्तेमाल किया जा सकता है.
• यह PubMatic iOS अडैप्टर के 5.3.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads React Native प्लगिन के 0.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है.