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

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

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

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

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

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

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

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

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

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

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

ऐप्लिकेशन डैशबोर्ड

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

Android

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

ऐप्लिकेशन का नया फ़ॉर्म

iOS

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

ऐप्लिकेशन का नया फ़ॉर्म

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

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

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

app-aps.txt

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

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

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

ऐप्लिकेशन प्रोफ़ाइल आईडी

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

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

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

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

विज्ञापन यूनिट का फ़ॉर्म बनाना

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

ऐप्लिकेशन की विज्ञापन यूनिट का आईडी

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

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

पब्लिशर आईडी

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

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

Android

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

iOS

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

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

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

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

pub.dev के ज़रिए इंटिग्रेशन

(सिर्फ़ Android के लिए) अपने प्रोजेक्ट की android डायरेक्ट्री में मौजूद build.gradle फ़ाइल में, ये रिपॉज़िटरी जोड़ें:

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

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

dependencies:
  gma_mediation_pubmatic: ^

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

PubMatic OpenWrap SDK के लिए, Google Mobile Ads mediation प्लगिन का नया वर्शन डाउनलोड करें. इसके बाद, डाउनलोड की गई फ़ाइल को एक्सट्रैक्ट करें. अब एक्सट्रैक्ट किए गए प्लगिन फ़ोल्डर (और उसके कॉन्टेंट) को अपने Flutter प्रोजेक्ट में जोड़ें. इसके बाद, अपनी pubspec.yaml फ़ाइल में प्लगिन का रेफ़रंस दें. इसके लिए, यह डिपेंडेंसी जोड़ें:

dependencies:
  gma_mediation_pubmatic:
    path: path/to/local/package

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

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

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

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

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

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

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

Android

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

iOS

SKAdNetwork इंटिग्रेशन

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

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

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

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

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

यह पुष्टि करने के लिए कि आपको 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 Flutter Mediation Adapter के बदलाव का लॉग

वर्शन 1.1.0

वर्शन 1.0.0