बिडिंग के साथ PubMatic को इंटिग्रेट करना

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

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

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

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

² बैनर के अलावा, विज्ञापन के अन्य सभी फ़ॉर्मैट, ऐल्फ़ा वर्शन में उपलब्ध हैं.

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

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

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

• मीडिएशन की प्रोसेस पूरी करें शुरुआती निर्देश.

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

अपने PubMatic खाते में लॉग इन करें और OpenWrap SDK कार्ड चुनें.

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

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

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

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

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

Authorized Sellers for Apps 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 की डिमांड सेट अप करना

अपने Ad Manager खाते में साइन इन करें.

सुरक्षित सिग्नल शेयरिंग की सुविधा चालू करना

एडमिन > ग्लोबल सेटिंग पर जाएं. Ad Exchange खाते की सेटिंग टैब पर जाएं. इसके बाद, सुरक्षित तरीके से सिग्नल शेयर करने की सुविधा की समीक्षा करें और इसे टॉगल करके चालू करें. सेव करें पर क्लिक करें.

बिड अनुरोधों पर सुरक्षित सिग्नल शेयर करना

इन्वेंट्री > सुरक्षित सिग्नल पर जाएं. सुरक्षित सिग्नल में जाकर, PubMatic OpenWrap SDK खोजें. इसके बाद, ऐप्लिकेशन इंटिग्रेशन चालू करें को टॉगल करके चालू करें.

सेव करें पर क्लिक करें.

एसडीके बिडिंग के लिए सुरक्षित सिग्नल शेयरिंग की अनुमति देना

डिलीवरी > डिमांड चैनल की सेटिंग पर जाएं. डिफ़ॉल्ट सेटिंग टैब में जाकर, एसडीके बिडिंग के लिए, सुरक्षित सिग्नल शेयर करने की अनुमति दें को टॉगल करके चालू करें.

सेव करें पर क्लिक करें.

PubMatic बिडिंग को कॉन्फ़िगर करना

डिलीवरी > बिड करने वाले पर जाएं. इसके बाद, एसडीके से बिडिंग की सुविधा पर जाएं पर क्लिक करें.

नया बिडर पर क्लिक करें.

बिडर के तौर पर PubMatic OpenWrap SDK चुनें.

बिड करने वाले इस व्यक्ति या कंपनी के लिए एसडीके बिडिंग की सुविधा चालू करने के लिए, जारी रखें पर क्लिक करें.

हो गया पर क्लिक करें.

विज्ञापन यूनिट को मैप करने की सुविधा कॉन्फ़िगर करना

डिलीवरी > बिड करने वाले पर जाएं. इसके बाद, एसडीके से बिडिंग की सुविधा पर जाएं पर क्लिक करें.

PubMatic OpenWrap SDK के लिए कंपनी चुनें.

विज्ञापन यूनिट की मैपिंग टैब पर जाएं. इसके बाद, विज्ञापन यूनिट की नई मैपिंग पर क्लिक करें.

चुनिंदा विज्ञापन यूनिट चुनें. कोई विज्ञापन यूनिट और फ़ॉर्मैट चुनें. इसके बाद, इन्वेंट्री टाइप के तौर पर मोबाइल ऐप्लिकेशन और अपना मोबाइल ऐप्लिकेशन चुनें. इसके बाद, पिछले सेक्शन में मिला OpenWrap विज्ञापन यूनिट आईडी डालें.

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

आखिर में, सेव करें पर क्लिक करें.

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

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

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

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

  pod 'GoogleMobileAdsMediationPubMatic'
  

• कमांड लाइन से यह निर्देश चलाएं:

  pod install --repo-update

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

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

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

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

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

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

अमेरिका के निजता कानून

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

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

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

SKAdNetwork इंटिग्रेशन

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

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

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

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

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

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

वैकल्पिक चरण

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

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

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

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

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

GADMediationAdapterPubMatic

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

PubMatic iOS Mediation Adapter के बदलावों का लॉग

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