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

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

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

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

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

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

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

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

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

  • 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 सेट अप करना लेख पढ़ें.
  • AdMob मीडिएशन सेट अप करें.

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

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

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

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

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

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

    Android

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

    New App Form

    iOS

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

    New App Form

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

    ऐप्लिकेशन के लिए, अनुमति वाले सेलर (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 को लागू करने का तरीका लेख पढ़ें.

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

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

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

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

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

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

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

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

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

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

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

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

    पब्लिशर आईडी

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

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

    Android

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

    iOS

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

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

    AdMob के यूज़र इंटरफ़ेस (यूआई) में, यूरोप और अमेरिका के राज्यों के कानूनों के तहत विज्ञापन पार्टनर की सूची में 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.1

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

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

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

    Android

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

    iOS

    SKAdNetwork इंटिग्रेशन

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

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

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

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

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

    यह पुष्टि करने के लिए कि आपको 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 का दस्तावेज़ देखें.

    Pubmatic Flutter मीडिएशन अडैप्टर के बदलावों का लॉग

    वर्शन 2.5.1

    वर्शन 2.5.0

    वर्शन 2.4.0

    वर्शन 2.3.1

    वर्शन 2.3.0

    वर्शन 2.2.0

    वर्शन 2.1.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

    वर्शन 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

    वर्शन 1.4.0

    वर्शन 1.3.0

    वर्शन 1.2.0

    वर्शन 1.1.0

    वर्शन 1.0.0