इस गाइड में बताया गया है कि Google Mobile Ads Unity Plugin का इस्तेमाल करके, PubMatic से विज्ञापन लोड करने और दिखाने का तरीका क्या है. इसमें AdMob मीडिएशन की मदद से बिडिंग इंटिग्रेशन शामिल हैं. इसमें बताया गया है कि किसी विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में PubMatic को कैसे जोड़ा जाता है. साथ ही, किसी Unity ऐप्लिकेशन में PubMatic SDK और अडैप्टर को कैसे इंटिग्रेट किया जाता है.
इस्तेमाल किए जा सकने वाले इंटिग्रेशन और विज्ञापन फ़ॉर्मैट
PubMatic के लिए AdMob मीडिएशन अडैप्टर में ये सुविधाएं उपलब्ध हैं:
| इंटिग्रेशन | |
|---|---|
| बिडिंग | |
| वॉटरफ़ॉल | |
| फ़ॉर्मैट | |
| ऐप का खुलना | |
| बैनर | |
| मध्यवर्ती | 1 |
| इनाम दिया गया | 1 |
| पुरस्कृत मध्यवर्ती | |
1 यह फ़ॉर्मैट बीटा वर्शन में है. ऐक्सेस पाने के लिए, अपने खाता मैनेजर से संपर्क करें.
ज़रूरी शर्तें
- नवीनतम Google Mobile Ads Unity Plugin
- Unity 2019.4 या इसके बाद वाला वर्शन
- Android पर डिप्लॉय करने के लिए
- Android का एपीआई लेवल 23 या इसके बाद का वर्शन
- iOS पर डिप्लॉय करने के लिए
- iOS डिप्लॉयमेंट का टारगेट 13.0 या इसके बाद का वर्शन होना चाहिए
- Google Mobile Ads Unity प्लगिन के साथ कॉन्फ़िगर किया गया ऐसा Unity प्रोजेक्ट जिस पर काम किया जा सकता हो.Google Mobile Ads Unity Plugin ज़्यादा जानकारी के लिए, सेट अप Google Mobile Ads Unity Plugin लेख पढ़ें.
- AdMob मीडिएशन सेट अप करना
पहला चरण: PubMatic के यूआई में कॉन्फ़िगरेशन सेट अप करना
PubMatic खाते के लिए साइन अप करें या लॉग इन करें और OpenWrap SDK कार्ड चुनें.
नया ऐप्लिकेशन जोड़ना
ऐप्लिकेशन टैब पर जाएं और ऐप्लिकेशन जोड़ें बटन पर क्लिक करें.
अपने ऐप्लिकेशन के लिए प्लैटफ़ॉर्म के साथ-साथ, ऐप्लिकेशन स्टोर का यूआरएल और ऐप्लिकेशन का नाम चुनें.
Android
इंटिग्रेशन पाथ में जाकर, Unity चुनें. इसके बाद, सब-इंटिग्रेशन पाथ के तौर पर AdMob - SDK बिडिंग चुनें. इसके बाद, ऐप्लिकेशन जोड़ें बटन पर क्लिक करें.
iOS
इंटिग्रेशन पाथ में जाकर, Unity चुनें. इसके बाद, सब-इंटिग्रेशन पाथ के तौर पर 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 को जीडीपीआर और अमेरिका के राज्यों में लागू कानूनों के तहत विज्ञापन पार्टनरों की सूची में जोड़ना
AdMob के यूआई में, यूरोप और अमेरिका के राज्यों में लागू कानूनों के तहत विज्ञापन पार्टननों की सूची में PubMatic को जोड़ें. इसके लिए, यूरोपीय कानूनों से जुड़ी सेटिंग और अमेरिका के राज्यों में लागू कानूनों से जुड़ी सेटिंग में दिए गए तरीकों का पालन करें.
तीसरा चरण: PubMatic SDK और अडैप्टर को इंपोर्ट करना
OpenUPM-CLI
अगर आपने OpenUPM-CLI इंस्टॉल किया है, तो अपने प्रोजेक्ट की रूट डायरेक्ट्री से यह कमांड चलाकर, Google Mobile Ads PubMatic OpenWrap SDK Mediation Plugin for Unity को अपने प्रोजेक्ट में इंस्टॉल किया जा सकता है:
openupm add com.google.ads.mobile.mediation.pubmaticOpenUPM
Unity प्रोजेक्ट एडिटर में, बदलाव करें > प्रोजेक्ट सेटिंग > पैकेज मैनेजर चुनें, ताकि Unity Package Manager की सेटिंग खुल जाए.
स्कोप वाली रजिस्ट्री टैब में जाकर, OpenUPM को स्कोप वाली रजिस्ट्री के तौर पर जोड़ें. इसके लिए, यह जानकारी दें:
- नाम:
OpenUPM - यूआरएल:
https://package.openupm.com - स्कोप:
com.google
इसके बाद, विंडो > पैकेज मैनेजर पर जाएं ताकि Unity Package Manager खुल जाए और ड्रॉप-डाउन मेन्यू से मेरी रजिस्ट्री चुनें.
Google Mobile Ads PubMatic Mediation पैकेज चुनें और इंस्टॉल करें पर क्लिक करें.
Unity पैकेज
Unity प्रोजेक्ट एडिटर में, ऐसेट > पैकेज इंपोर्ट करें > कस्टम पैकेज चुनें. इसके बाद, डाउनलोड की गई GoogleMobileAdsPubMaticMediation.unitypackage फ़ाइल ढूंढें. पक्का करें कि सभी फ़ाइलें चुनी गई हों. इसके बाद, इंपोर्ट करें पर क्लिक करें.
इसके बाद, ऐसेट > एक्सटर्नल डिपेंडेंसी मैनेजर > Android रिज़ॉल्वर > फ़ोर्स रिज़ॉल्व चुनें. एक्सटर्नल डिपेंडेंसी मैनेजर लाइब्रेरी, डिपेंडेंसी रिज़ॉल्यूशन की प्रोसेस को शुरू से करेगी. साथ ही, बताई गई डिपेंडेंसी को आपके Unity ऐप्लिकेशन की Assets/Plugins/Android डायरेक्ट्री में कॉपी करेगी.
चौथा चरण: PubMatic SDK पर निजता सेटिंग लागू करना
ईयू उपयोगकर्ता की सहमति से जुड़ी नीति और जीडीपीआर
Google की ईयू उपयोगकर्ता की सहमति से जुड़ी नीति का पालन करने के लिए, आपको यूरोपियन इकनॉमिक एरिया (ईईए), यूके, और स्विट्ज़रलैंड में मौजूद उपयोगकर्ताओं को कुछ जानकारी देनी होगी. साथ ही, आपको कानूनी तौर पर ज़रूरी होने पर, कुकी या अन्य लोकल स्टोरेज का इस्तेमाल करने के लिए उनकी सहमति लेनी होगी. इसके अलावा, आपको विज्ञापन को ज़्यादा काम का बनाने के लिए, निजी डेटा को इकट्ठा करने, शेयर करने, और इस्तेमाल करने के लिए भी उनकी सहमति लेनी होगी. इस नीति में, ईयू के ई-निजता निर्देश और जनरल डेटा प्रोटेक्शन रेगुलेशन (जीडीपीआर) की ज़रूरी शर्तों के बारे में बताया गया है. यह आपकी ज़िम्मेदारी है कि सहमति की जानकारी, आपकी मीडिएशन चेन में मौजूद हर विज्ञापन सोर्स को भेजी जाए. Google, उपयोगकर्ता की सहमति के विकल्प को ऐसे नेटवर्क पर अपने-आप नहीं भेज सकता.
PubMatic, जीडीपीआर के लिए सहमति की जानकारी को अपने-आप पढ़ लेता है. यह जानकारी, Google के अन्य सहमति मोड की खास जानकारी के साथ काम करने वाले कंसेंट मैनेजमेंट प्लैटफ़ॉर्म सेट करते हैं. इनमें UMP SDK भी शामिल है. ज़्यादा जानकारी के लिए, जीडीपीआर और जीडीपीआर के लिए सहमति की जानकारी पास करना लेख पढ़ें.
अमेरिका के राज्यों के निजता कानून
अमेरिका के राज्यों के निजता कानूनों के मुताबिक, उपयोगकर्ताओं को अपनी "निजी जानकारी" (जैसा कि कानून में परिभाषित है) की "बिक्री" से ऑप्ट आउट करने का अधिकार मिलना चाहिए. ऑप्ट आउट का विकल्प देने के लिए, "बिक्री करने वाले" पक्ष को अपने होम पेज पर "मेरी निजी जानकारी न बेचें" का लिंक प्रमुखता से दिखाना होगा. अमेरिका के राज्यों के निजता कानूनों का पालन करने से जुड़ी गाइड में, Google के विज्ञापन दिखाने के लिए सीमित डेटा प्रोसेसिंग मोड को चालू करने की सुविधा मिलती है. हालांकि, Google आपकी मीडिएशन चेन में मौजूद हर विज्ञापन नेटवर्क पर इस सेटिंग को लागू नहीं कर सकता. इसलिए, आपको मीडिएशन चेन में मौजूद हर उस विज्ञापन नेटवर्क कंपनी की पहचान करनी होगी जो निजी जानकारी की बिक्री में हिस्सा ले सकती है. साथ ही, आपको यह पक्का करने के लिए कि निजता कानून का पालन किया जा रहा है, उन सभी नेटवर्क से मिले दिशा-निर्देशों का पालन करना होगा.
PubMatic, सीसीपीए के लिए सहमति की जानकारी को अपने-आप पढ़ लेता है. यह जानकारी, Google के अन्य सहमति मोड की खास जानकारी के साथ काम करने वाले कंसेंट मैनेजमेंट प्लैटफ़ॉर्म सेट करते हैं. इनमें UMP SDK भी शामिल है. ज़्यादा जानकारी के लिए, सीसीपीए स्ट्रिंग सेट करना लेख पढ़ें.
पांचवा चरण: ज़रूरी कोड जोड़ना
Android
PubMatic इंटिग्रेशन के लिए, किसी और कोड की ज़रूरत नहीं है.
iOS
SKAdNetwork इंटिग्रेशन
अपने प्रोजेक्ट की Info.plist फ़ाइल में SKAdNetwork आइडेंटिफ़ायर जोड़ने के लिए, PubMatic के दस्तावेज़
पढ़ें.
छठा चरण: लागू किए गए बदलावों की जांच करना
टेस्ट विज्ञापनों को चालू करना
पक्का करें कि आपने 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 | विज्ञापन लोड करने के लिए, विज्ञापन का कॉन्फ़िगरेशन अमान्य है. |
| 103 | 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 | नेटिव विज्ञापन के इमेज सोर्स में से कोई एक लोड नहीं हो सका. |
| 1001-5002 | PubMatic SDK से भेजा गया | PubMatic SDK से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, PubMatic के दस्तावेज़ देखें. |
PubMatic Unity मीडिएशन प्लगिन के बदलाव की जानकारी
वर्शन 2.1.0 (डेवलेपमेंट में है)
वर्शन 2.0.1
- प्लगिन को अपडेट किया गया है, ताकि इसमें iOS के सभी टारगेट के लिए
OpenWrapSDKडाइनैमिक फ़्रेमवर्क शामिल हो. - यह PubMatic Android अडैप्टर के 5.0.0.1 वर्शन के साथ काम करता है.
- यह PubMatic iOS अडैप्टर के 5.0.1.0 वर्शन के साथ काम करता है.
- इसे Google Mobile Ads Unity प्लगिन के 11.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 2.0.0
- यह PubMatic Android अडैप्टर के 5.0.0.1 वर्शन के साथ काम करता है.
- यह PubMatic iOS अडैप्टर के 5.0.0.0 वर्शन के साथ काम करता है.
- इसे Google Mobile Ads Unity प्लगिन के 11.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.5.0
- यह PubMatic Android अडैप्टर के 4.12.0.0 वर्शन के साथ काम करता है.
- यह PubMatic iOS अडैप्टर के 4.12.0.0 वर्शन के साथ काम करता है.
- इसे Google Mobile Ads Unity प्लगिन के 11.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.4.1
- यह PubMatic Android अडैप्टर के 4.11.0.1 वर्शन के साथ काम करता है.
- यह PubMatic iOS अडैप्टर के 4.11.0.1 वर्शन के साथ काम करता है.
- इसे Google Mobile Ads Unity प्लगिन के 10.7.0 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.4.0
- यह PubMatic Android अडैप्टर के 4.11.0.0 वर्शन के साथ काम करता है.
- यह PubMatic iOS अडैप्टर के 4.11.0.0 वर्शन के साथ काम करता है.
- इसे Google Mobile Ads Unity प्लगिन के 10.6.0 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.3.1
- यह PubMatic Android अडैप्टर के 4.10.0.1 वर्शन के साथ काम करता है.
- यह PubMatic iOS अडैप्टर के 4.10.0.0 वर्शन के साथ काम करता है.
- इसे Google Mobile Ads Unity प्लगिन के 10.6.0 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.3.0
- यह PubMatic Android अडैप्टर के 4.10.0.0 वर्शन के साथ काम करता है.
- यह PubMatic iOS अडैप्टर के 4.10.0.0 वर्शन के साथ काम करता है.
- इसे Google Mobile Ads Unity प्लगिन के 10.6.0 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.2.0
- यह PubMatic Android अडैप्टर के 4.9.1.0 वर्शन के साथ काम करता है.
- यह PubMatic iOS अडैप्टर के 4.9.0.0 वर्शन के साथ काम करता है.
- इसे Google Mobile Ads Unity प्लगिन के 10.5.0 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.1.0
- यह PubMatic Android अडैप्टर के 4.9.1.0 वर्शन के साथ काम करता है.
- यह PubMatic iOS अडैप्टर के 4.8.1.0 वर्शन के साथ काम करता है.
- इसे Google Mobile Ads Unity प्लगिन के 10.5.0 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.0.0
- पहली बार रिलीज़ होने की तारीख!
- यह PubMatic Android अडैप्टर के 4.8.0.0 वर्शन के साथ काम करता है.
- यह PubMatic iOS अडैप्टर के 4.8.1.0 वर्शन के साथ काम करता है.
- इसे Google Mobile Ads Unity प्लगिन के 10.4.2 वर्शन के साथ बनाया और टेस्ट किया गया है.