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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

तीसरा चरण: PubMatic OpenWrap 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: ^2.5.0

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

GADMediationAdapterPubMatic

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

Pubmatic Flutter Mediation Adapter के बदलावों की जानकारी

वर्शन 2.5.1 (डेवलपमेंट में है)

वर्शन 2.5.0

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

वर्शन 2.4.0

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

वर्शन 2.3.1

• Google Mobile Ads Flutter प्लगिन के 9.1.0 वर्शन के साथ काम करने के लिए अपडेट किया गया.
• Swift Package Manager के लिए सहायता जोड़ी गई है.
• PubMatic Android अडैप्टर के 5.2.0.0 वर्शन के साथ काम करता है.
• PubMatic iOS अडैप्टर के 5.2.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter Plugin के 9.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 2.3.0

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

वर्शन 2.2.0

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

वर्शन 2.1.0

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

वर्शन 2.0.0

• Flutter के कम से कम वर्शन को 3.38.1 पर अपडेट किया गया
• Google Mobile Ads Flutter प्लगिन के 8.0.0 वर्शन के साथ काम करने के लिए अपडेट किया गया
• PubMatic Android अडैप्टर के 5.0.0.1 वर्शन के साथ काम करता है.
• PubMatic iOS अडैप्टर के 5.0.1.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 8.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.6.0

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

वर्शन 1.5.0

• Flutter के कम से कम वर्शन को 3.35.1 पर अपडेट किया गया
• Google Mobile Ads Flutter प्लगिन के 7.0.0 वर्शन के साथ काम करने के लिए अपडेट किया गया
• PubMatic Android अडैप्टर के 4.11.0.1 वर्शन के साथ काम करता है.
• PubMatic iOS अडैप्टर के 4.11.0.1 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के 7.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.4.1

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

वर्शन 1.4.0

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

वर्शन 1.3.0

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

वर्शन 1.2.0

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

वर्शन 1.1.0

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

वर्शन 1.0.0

• शुरुआती रिलीज़.
• PubMatic Android adapter version 4.7.1.1 के साथ काम करता है.
• PubMatic iOS अडैप्टर के 4.7.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Flutter प्लगिन के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया है.