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

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

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

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

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

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

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

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

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

  • Google Mobile Ads Unity Plugin का नया वर्शन.
  • Unity Editor का वर्शन 2019.4 या इसके बाद का वर्शन.
  • Android पर डिप्लॉय करने के लिए
    • Android एपीआई लेवल 24 या इसके बाद का वर्शन.
  • iOS पर डिप्लॉय करने के लिए
    • iOS डिप्लॉयमेंट का टारगेट 13.0 या इसके बाद का वर्शन होना चाहिए.
  • Google Mobile Ads Unity Plugin के साथ कॉन्फ़िगर किया गया ऐसा Unity प्रोजेक्ट जिस पर काम किया जा सकता हो. ज़्यादा जानकारी के लिए, Google Mobile Ads Unity Plugin सेट अप करना लेख पढ़ें.
  • मीडिएशन सेट अप करें.
  • पहला चरण: PubMatic OpenWrap SDK के यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगरेशन सेट अप करना

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

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

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

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

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

    Android

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

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

    iOS

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

    New App Form

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

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

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

    app-aps.txt

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

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

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

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

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

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

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

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

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

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

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

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

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

    पब्लिशर आईडी

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

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

    Android

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

    iOS

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

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

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

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

    OpenUPM-CLI

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

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

    OpenUPM

    Unity Package Manager Settings खोलने के लिए, Unity प्रोजेक्ट एडिटर में Edit > Project Settings > Package Manager चुनें.

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

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

    OpenUPM की जानकारी

    इसके बाद, Window > Package Manager पर जाकर, Unity Package Manager खोलें. इसके बाद, ड्रॉप-डाउन मेन्यू से My Registries चुनें.

    Unity Registries

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

    OpenUPM से इंस्टॉल करना

    Unity पैकेज

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

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

    Unity से इंपोर्ट करना

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

    समस्या को ज़बरदस्ती हल करना

    चौथा चरण: 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 के दस्तावेज़ पढ़ें.

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

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

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

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

    यह पुष्टि करने के लिए कि आपको 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 Unity Mediation Plugin के बदलावों की जानकारी

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

    वर्शन 2.4.0

    वर्शन 2.3.0

    वर्शन 2.2.0

    वर्शन 2.1.3

    वर्शन 2.1.2

    वर्शन 2.1.1

    वर्शन 2.1.0

    वर्शन 2.0.1

    वर्शन 2.0.0

    वर्शन 1.5.0

    वर्शन 1.4.1

    वर्शन 1.4.0

    वर्शन 1.3.1

    वर्शन 1.3.0

    वर्शन 1.2.0

    वर्शन 1.1.0

    वर्शन 1.0.0