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

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

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

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

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

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

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

• iOS डिप्लॉयमेंट का टारगेट 13.0 या इसके बाद का वर्शन होना चाहिए.

• Google Mobile Ads SDK का नया वर्शन.

• AdMob मीडिएशन सेट अप करें.

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

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

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

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

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

इंटिग्रेशन पाथ में जाकर, iOS (Objective-C / Swift) चुनें. इसके बाद, सब-इंटिग्रेशन पाथ के तौर पर, AdMob - SDK से बिडिंग चुनें. इसके बाद, ऐप्लिकेशन जोड़ें बटन पर क्लिक करें.

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

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

ऐप्लिकेशन को फ़ाइनल करने से पहले, आपको app-ads.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 को पहले से विज्ञापन सोर्स के तौर पर जोड़ा हुआ है, तो उसे चुना जा सकता है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें पर क्लिक करें.



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

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

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

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

सुझाव: Swift Package Manager का इस्तेमाल करें

जारी रखने से पहले, आपके पास अडैप्टर का कम से कम 4.10.0.0 वर्शन होना चाहिए.

अपने प्रोजेक्ट में पैकेज डिपेंडेंसी जोड़ने के लिए, यह तरीका अपनाएं:

1. Xcode में, File > Add Package Dependencies... पर जाएं.

2. इसके बाद, जो प्रॉम्प्ट दिखेगा उसमें यह पैकेज यूआरएल खोजें:

   https://github.com/googleads/googleads-mobile-ios-mediation-pubmatic.git
   

3. डिपेंडेंसी नियम में जाकर, ब्रांच को चुनें.

4. टेक्स्ट फ़ील्ड में, main डालें.

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

1. iOS के लिए PubMatic OpenWrap SDK का नया वर्शन डाउनलोड करें. इसके बाद, अपने प्रोजेक्ट में सभी .xcframework फ़ाइलें और बंडल लिंक करें.

2. बदलाव की जानकारी में दिए गए डाउनलोड लिंक से, PubMatic अडैप्टर का नया वर्शन डाउनलोड करें. इसके बाद, PubMaticAdapter.xcframework को अपने प्रोजेक्ट में लिंक करें.

CocoaPods का इस्तेमाल करना

• अपने प्रोजेक्ट की Podfile में यह लाइन जोड़ें:

  pod 'GoogleMobileAdsMediationPubMatic'
  

• कमांड लाइन से, यह कमांड चलाएं:

  pod install --repo-update

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

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

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

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

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

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

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

SKAdNetwork को लागू करना

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

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

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

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

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

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

वैकल्पिक चरण

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

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

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

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

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

GADMediationAdapterPubMatic

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

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

वर्शन 5.5.0.0

• PubMatic OpenWrap SDK के 5.5.0 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 13.12.0.
• PubMatic OpenWrap SDK का वर्शन 5.5.0.

वर्शन 5.4.1.0

• PubMatic OpenWrap SDK के 5.4.1 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 13.10.0.
• PubMatic OpenWrap SDK टूल का वर्शन 5.4.1.

वर्शन 5.4.0.0

• PubMatic OpenWrap SDK के 5.4.0 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 13.9.0.
• PubMatic OpenWrap SDK टूल का वर्शन 5.4.0.

वर्शन 5.3.0.0

• PubMatic OpenWrap SDK के 5.3.0 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 13.8.0.
• PubMatic OpenWrap SDK टूल का वर्शन 5.3.0.

वर्शन 5.2.0.0

• PubMatic OpenWrap SDK के 5.2.0 वर्शन के साथ काम करने की पुष्टि की गई है.
• अब इसके लिए, Google Mobile Ads SDK का 13.6 या इसके बाद का वर्शन ज़रूरी है.
• mediaView API का इस्तेमाल करके, नेटिव विज्ञापनों में वीडियो ऐसेट के लिए सहायता जोड़ी गई.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 13.7.0.
• PubMatic OpenWrap SDK का वर्शन 5.2.0.

वर्शन 5.1.1.0

• PubMatic OpenWrap SDK के 5.1.1 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 13.4.0.
• PubMatic OpenWrap SDK टूल का वर्शन 5.1.1.

वर्शन 5.1.0.1

• अडैप्टर अब ageRestrictedTreatment Google Mobile Ads SDK फ़्लैग को PubMatic OpenWrap SDK के COPPA API पर फ़ॉरवर्ड करता है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 13.3.0.
• PubMatic OpenWrap SDK का वर्शन 5.1.0.

वर्शन 5.1.0.0

• PubMatic OpenWrap SDK के 5.1.0 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 13.3.0.
• PubMatic OpenWrap SDK का वर्शन 5.1.0.

वर्शन 5.0.1.0

• PubMatic OpenWrap SDK के 5.0.1 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 13.2.0.
• PubMatic OpenWrap SDK का वर्शन 5.0.1.

वर्शन 5.0.0.0

• PubMatic OpenWrap SDK के 5.0.0 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 13.1.0.
• PubMatic OpenWrap SDK का वर्शन 5.0.0.

वर्शन 4.12.0.0

• PubMatic OpenWrap SDK के 4.12.0 वर्शन के साथ काम करने की पुष्टि की गई है.
• Google Mobile Ads SDK की डिपेंडेंसी को 13.0.0 वर्शन पर अपडेट किया गया.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 13.0.0.
• PubMatic OpenWrap SDK का वर्शन 4.12.0.

वर्शन 4.11.0.2

• CocoaPods के लिए, iOS के कम से कम वर्शन को 13.0 पर अपडेट किया गया.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 13.0.0.
• PubMatic OpenWrap SDK का वर्शन 4.11.0.

वर्शन 4.11.0.1

• PubMatic OpenWrap SDK टूल में, tagForChildDirectedTreatment और tagForUnderAgeOfConsent Google Mobile Ads SDK टूल के पैरामीटर फ़ॉरवर्ड करने की सुविधा जोड़ी गई.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 12.14.0.
• PubMatic OpenWrap SDK का वर्शन 4.11.0.

वर्शन 4.11.0.0

• PubMatic OpenWrap SDK के 4.11.0 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 12.14.0.
• PubMatic OpenWrap SDK का वर्शन 4.11.0.

वर्शन 4.10.0.0

• PubMatic OpenWrap SDK के 4.10.0 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 12.12.0.
• PubMatic OpenWrap SDK का वर्शन 4.10.0.

वर्शन 4.9.0.0

• बैनर, इंटरस्टीशियल, इनाम वाले, और नेटिव विज्ञापन फ़ॉर्मैट के लिए वॉटरफ़ॉल की सुविधा जोड़ी गई.
• उस गड़बड़ी को ठीक किया गया है जिसकी वजह से नेटिव विज्ञापन डेलिगेट सही तरीके से सेट नहीं हो रहे थे.
• GADMediationAdapterPubMaticExtras क्लास में, टेस्ट मोड की प्रॉपर्टी जोड़ें.
• PubMatic OpenWrap SDK के 4.9.0 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 12.12.0.
• PubMatic OpenWrap SDK का वर्शन 4.9.0.

वर्शन 4.8.1.0

• PubMatic OpenWrap SDK के 4.8.1 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 12.9.0.
• PubMatic OpenWrap SDK टूल का वर्शन 4.8.1.

वर्शन 4.8.0.0

• PubMatic OpenWrap SDK के 4.8.0 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 12.8.0.
• PubMatic OpenWrap SDK का वर्शन 4.8.0.

वर्शन 4.7.0.0

• शुरुआती रिलीज़.
• बैनर, इंटरस्टीशियल, इनाम वाले, और नेटिव विज्ञापन फ़ॉर्मैट के लिए बिडिंग की सुविधा देता है.
• PubMatic OpenWrap SDK के 4.7.0 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 12.6.0.
• PubMatic OpenWrap SDK का वर्शन 4.7.0.