Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

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

इस गाइड में बताया गया है कि GMA Next-Gen SDK का इस्तेमाल करके, AdMob मीडिएशन की मदद से PubMatic से डिसप्ले विज्ञापन लोड करने और दिखाने का तरीका क्या है. इसमें वॉटरफ़ॉल और बिडिंग, दोनों तरह के इंटिग्रेशन शामिल हैं. इसमें बताया गया है कि किसी विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में PubMatic OpenWrap SDK को कैसे जोड़ा जाता है. साथ ही, किसी Android ऐप्लिकेशन में PubMatic OpenWrap SDK और अडैप्टर को कैसे इंटिग्रेट किया जाता है.

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

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

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

¹ वॉटरफ़ॉल इंटिग्रेशन, ऐल्फ़ा वर्शन में उपलब्ध है.

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

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

Android एपीआई लेवल 24 या इसके बाद का वर्शन.

GMA Next-Gen SDK का नया वर्शन.
AdMob मीडिएशन सेट अप करें.

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

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

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

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

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

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

इंटिग्रेशन पाथ में जाकर, Android (Java / Kotlin) चुनें. इसके बाद, सब-इंटिग्रेशन पाथ के तौर पर, 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 को लागू करने का तरीका लेख पढ़ें.

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

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

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

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

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

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

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

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

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

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

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

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

पब्लिशर आईडी

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

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

आपको अपनी विज्ञापन यूनिट के लिए, मीडिएशन कॉन्फ़िगरेशन में PubMatic OpenWrap SDK जोड़ना होगा.

सबसे पहले, अपने AdMob खाते में साइन इन करें. इसके बाद, मीडिएशन टैब पर जाएं. अगर आपको किसी मौजूदा मीडिएशन ग्रुप में बदलाव करना है, तो उस मीडिएशन ग्रुप के नाम पर क्लिक करके उसमें बदलाव करें. इसके बाद, PubMatic OpenWrap SDK को विज्ञापन सोर्स के तौर पर जोड़ें पर जाएं.

नया मीडिएशन ग्रुप बनाने के लिए, मीडिएशन ग्रुप बनाएं को चुनें.

विज्ञापन फ़ॉर्मैट और प्लैटफ़ॉर्म की जानकारी डालें. इसके बाद, जारी रखें पर क्लिक करें.

अपने मीडिएशन ग्रुप को कोई नाम दें और टारगेट करने के लिए जगहें चुनें. इसके बाद, मीडिएशन ग्रुप की स्थिति को चालू है पर सेट करें. फिर, विज्ञापन यूनिट जोड़ें पर क्लिक करें.

इस मीडिएशन ग्रुप को अपनी मौजूदा AdMob विज्ञापन यूनिट में से एक या इससे ज़्यादा विज्ञापन यूनिट से जोड़ें. इसके बाद, हो गया पर क्लिक करें.

अब आपको विज्ञापन यूनिट का कार्ड दिखेगा. इसमें आपको वे विज्ञापन यूनिट दिखेंगी जिन्हें आपने चुना था:

PubMatic OpenWrap SDK को विज्ञापन सोर्स के तौर पर जोड़ना

बिडिंग

विज्ञापन सोर्स सेक्शन में जाकर, बिडिंग कार्ड ढूंढें और विज्ञापन सोर्स जोड़ें को चुनें. इसके बाद, PubMatic OpenWrap SDK चुनें .

स्वीकार करें और सहमति दें पर क्लिक करें. इसके बाद, सेव करें पर क्लिक करें.

अगर आपने PubMatic OpenWrap SDK को पहले से विज्ञापन सोर्स के तौर पर जोड़ा हुआ है, तो उसे चुना जा सकता है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें पर क्लिक करें.

इसके बाद, पिछले सेक्शन में मिला OpenWrap विज्ञापन यूनिट आईडी डालें. इसके बाद, हो गया पर क्लिक करें.

वॉटरफ़ॉल

विज्ञापन सोर्स सेक्शन में मौजूद, वॉटरफ़ॉल कार्ड में जाकर, विज्ञापन सोर्स जोड़ें को चुनें.

PubMatic OpenWrap SDK को चुनें. इसके बाद, PubMatic OpenWrap SDK के लिए ईसीपीएम वैल्यू डालें और जारी रखें पर क्लिक करें.

अगर आपने PubMatic OpenWrap SDK के लिए पहले से कोई मैपिंग की हुई है, तो उसे चुना जा सकता है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें पर क्लिक करें.

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

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

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

Android Studio इंटिग्रेशन (सुझाया गया)

अपने प्रोजेक्ट-लेवल की settings.gradle.kts फ़ाइल में, ये रिपॉज़िटरी जोड़ें:

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

इसके बाद, अपने ऐप्लिकेशन-लेवल की build.gradle.kts फ़ाइल में, लागू करने से जुड़ी ये डिपेंडेंसी और कॉन्फ़िगरेशन जोड़ें. PubMatic OpenWrap SDK और अडैप्टर के नए वर्शन इस्तेमाल करें:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0")
    implementation("com.google.ads.mediation:pubmatic:5.4.1.0")
}

configurations {
    all {
        exclude(group = "com.google.android.gms", module = "play-services-ads")
        exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
    }
}

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

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

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

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

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

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

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

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

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

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

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

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

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

वैकल्पिक चरण

नेटिव विज्ञापन

विज्ञापन रेंडरिंग

PubMatic अडैप्टर, अपने नेटिव विज्ञापनों को NativeAd ऑब्जेक्ट के तौर पर दिखाता है. यह NativeAd के लिए, इन फ़ील्ड को भरता है.

फ़ील्ड	PubMatic अडैप्टर में हमेशा शामिल की जाने वाली ऐसेट
हेडलाइन
इमेज
Body
आइकॉन
कॉल-टू-ऐक्शन
स्टार रेटिंग
स्टोर
कीमत
विज्ञापन देने वाला

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

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

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

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

गड़बड़ी का कोड	डोमेन	वजह
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 का दस्तावेज़ देखें.

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