इस गाइड में बताया गया है कि Google Mobile Ads Unity Plugin का इस्तेमाल करके, AdMob मीडिएशन (अलग-अलग नेटवर्क से विज्ञापन दिखाना) की मदद से BidMachine से विज्ञापन लोड करने और दिखाने का तरीका क्या है. इसमें बिडिंग इंटिग्रेशन शामिल हैं. इसमें बताया गया है कि किसी विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में BidMachine को कैसे जोड़ा जाता है. साथ ही, किसी Unity ऐप्लिकेशन में BidMachine SDK और अडैप्टर को कैसे इंटिग्रेट किया जाता है.
इस्तेमाल किए जा सकने वाले इंटिग्रेशन और विज्ञापन फ़ॉर्मैट
BidMachine के लिए AdMob मीडिएशन अडैप्टर में ये सुविधाएं उपलब्ध हैं:
| इंटिग्रेशन | |
|---|---|
| बिडिंग | |
| वॉटरफ़ॉल | 1 |
| फ़ॉर्मैट | |
| ऐप का खुलना | |
| बैनर | |
| इंटरस्टीशियल विज्ञापन | |
| इनाम वाले विज्ञापन | |
| इनाम वाला इंटरस्टीशियल विज्ञापन | |
1 वॉटरफ़ॉल इंटिग्रेशन, चुनिंदा उपयोगकर्ताओं के लिए बीटा वर्शन में उपलब्ध है. ऐक्सेस पाने के लिए अपने खाता मैनेजर से संपर्क करें.
ज़रूरी शर्तें
जारी रखने से पहले, इनकी पुष्टि करें:
- Google Mobile Ads Unity Plugin का नया वर्शन.
- Unity Editor का वर्शन 2019.4 या इसके बाद का वर्शन.
- Android पर डिप्लॉय करने के लिए
- Android का एपीआई लेवल 23 या इसके बाद का वर्शन.
- iOS पर डिप्लॉय करने के लिए
- iOS डिप्लॉयमेंट का टारगेट 13.0 या इसके बाद का वर्शन होना चाहिए.
- Google Mobile Ads Unity Plugin के साथ कॉन्फ़िगर किया गया ऐसा Unity प्रोजेक्ट जिस पर काम किया जा सकता हो. ज़्यादा जानकारी के लिए, शुरू करें लेख पढ़ें.
- AdMob मीडिएशन सेट अप करें.
पहला चरण: BidMachine के यूआई में कॉन्फ़िगरेशन सेट अप करना
BidMachine खाते के डैशबोर्ड में लॉग इन करें.
नए प्लेसमेंट बनाना
सोर्स टैब पर जाएं. इसके बाद, सोर्स टेबल में जाकर, बदलाव करें बटन को चुनें.
आपको उन सभी प्लेसमेंट की सूची दिखेगी जो आपके पास हैं. नया प्लेसमेंट बनाने के लिए, डायलॉग बॉक्स में मौजूद प्लेसमेंट जोड़ें बटन पर क्लिक करें.
प्लेसमेंट टाइप के तौर पर बिडिंग चुनें. फ़ॉर्म भरें और सेव करें पर क्लिक करें.
Android
iOS
आखिर में, प्लेसमेंट आईडी को नोट करें.
Android
iOS
app-ads.txt फ़ाइल अपडेट करना
ऐप्लिकेशन के लिए, अनुमति वाले सेलर (app-ads.txt), IAB Tech Lab की एक पहल है. इसकी मदद से यह पक्का किया जा सकता है कि आपके ऐप्लिकेशन की विज्ञापन इन्वेंट्री सिर्फ़ वे चैनल बेचें जिन्हें आपने अनुमति दी है. विज्ञापन से मिलने वाले रेवेन्यू में ज़्यादा नुकसान न हो, इसके लिए आपको app-ads.txt फ़ाइल लागू करनी होगी.
अगर आपने अब तक ऐसा नहीं किया है, तो
अपने ऐप्लिकेशन के लिए app-ads.txt फ़ाइल सेट अप करें.
BidMachine के लिए app-ads.txt लागू करने के लिए, डैशबोर्ड में जाकर app-ads.txt टैब पर जाएं. इसके बाद, सूची को कॉपी करें और उसे अपनी वेबसाइट की app-ads.txt फ़ाइल में जोड़ें.
दूसरा चरण: AdMob के यूआई में BidMachine की डिमांड सेट अप करना
अपनी विज्ञापन यूनिट के लिए मीडिएशन की सेटिंग कॉन्फ़िगर करना
Android
निर्देशों के लिए, Android के लिए गाइड में दिया गया दूसरा चरण देखें.
iOS
निर्देशों के लिए, iOS के लिए गाइड में दिया गया दूसरा चरण देखें.
BidMachine को जीडीपीआर और अमेरिका के राज्यों में लागू कानूनों के तहत विज्ञापन पार्टनरों की सूची में जोड़ना
AdMob के यूज़र इंटरफ़ेस (यूआई) में, यूरोप और अमेरिका के राज्यों के कानूनों के तहत विज्ञापन पार्टनर की सूची में BidMachine को जोड़ने के लिए, यहां दिया गया तरीका अपनाएं: यूरोपीय कानूनों की सेटिंग और अमेरिका के राज्यों के कानूनों की सेटिंग
तीसरा चरण: BidMachine SDK और अडैप्टर को इंपोर्ट करना
OpenUPM-CLI
अगर आपने OpenUPM-CLI इंस्टॉल किया है, तो अपने प्रोजेक्ट में Google Mobile Ads BidMachine Mediation Plugin for Unity इंस्टॉल किया जा सकता है. इसके लिए, अपने प्रोजेक्ट की रूट डायरेक्ट्री से यह कमांड चलाएं:
openupm add com.google.ads.mobile.mediation.bidmachineOpenUPM
Unity Package Manager Settings खोलने के लिए, Unity प्रोजेक्ट एडिटर में बदलाव करें > प्रोजेक्ट सेटिंग > Package Manager चुनें.
स्कोप की गई रजिस्ट्रियां टैब में जाकर, OpenUPM को स्कोप की गई रजिस्ट्री के तौर पर जोड़ें. इसके लिए, यह जानकारी दें:
- नाम:
OpenUPM - URL:
https://package.openupm.com - स्कोप:
com.google
इसके बाद, विंडो > पैकेज मैनेजर पर जाकर Unity Package Manager खोलें. इसके बाद, ड्रॉप-डाउन मेन्यू से मेरी रजिस्ट्री चुनें.
Google Mobile Ads BidMachine Mediation पैकेज को चुनें और इंस्टॉल करें पर क्लिक करें.
Unity पैकेज
बदलाव की जानकारी में दिए गए डाउनलोड लिंक से, BidMachine के लिए Google Mobile Ads Mediation प्लगिन का नया वर्शन डाउनलोड करें. इसके बाद, ज़िप फ़ाइल से GoogleMobileAdsBidMachineMediation.unitypackage को निकालें.
अपने यूनिटी प्रोजेक्ट एडिटर में, ऐसेट > पैकेज इंपोर्ट करें >
कस्टम पैकेज चुनें. इसके बाद, डाउनलोड की गई
GoogleMobileAdsBidMachineMediation.unitypackage
फ़ाइल ढूंढें. पक्का करें कि सभी फ़ाइलें चुनी गई हों. इसके बाद, इंपोर्ट करें पर क्लिक करें.
इसके बाद, ऐसेट > External Dependency Manager >
Android Resolver > Force Resolve को चुनें. External Dependency Manager लाइब्रेरी, डिपेंडेंसी को शुरू से हल करेगी. साथ ही, एलान की गई डिपेंडेंसी को आपके Unity ऐप्लिकेशन की Assets/Plugins/Android डायरेक्ट्री में कॉपी करेगी.
चौथा चरण: BidMachine SDK पर निजता सेटिंग लागू करना
ईयू उपयोगकर्ता की सहमति से जुड़ी नीति और जीडीपीआर
Google की ईयू उपयोगकर्ता की सहमति से जुड़ी नीति का पालन करने के लिए, आपको यूरोपीय आर्थिक क्षेत्र (ईईए), यूके, और स्विट्ज़रलैंड में अपने उपयोगकर्ताओं को कुछ खास जानकारी देनी होगी. साथ ही, कुकी या डिवाइस की दूसरी मेमोरी का इस्तेमाल करने के लिए, उनकी सहमति लेनी होगी. ऐसा तब करना होगा, जब कानूनी तौर पर इसकी ज़रूरत हो. इसके अलावा, आपको दर्शकों की दिलचस्पी के हिसाब से विज्ञापन दिखाने के लिए, निजी डेटा इकट्ठा करने, शेयर करने, और इस्तेमाल करने के लिए भी उनकी सहमति लेनी होगी. इस नीति में, ईयू के ई-निजता निर्देश और जनरल डेटा प्रोटेक्शन रेगुलेशन (जीडीपीआर) की ज़रूरी शर्तों के बारे में बताया गया है. यह आपकी ज़िम्मेदारी है कि सहमति की जानकारी, आपकी मीडिएशन चेन में मौजूद हर विज्ञापन सोर्स को भेजी जाए. Google, उपयोगकर्ता की सहमति के विकल्प को ऐसे नेटवर्क पर अपने-आप नहीं भेज सकता.
BidMachine, जीडीपीआर के तहत, निजी डेटा प्रोसेस करने की सहमति लेने वाले कंसेंट मैनेजमेंट प्लैटफ़ॉर्म से सेट की गई सहमति को अपने-आप पढ़ लेता है. इनमें UMP SDK भी शामिल है. ज़्यादा जानकारी के लिए, Android और iOS के लिए BidMachine की जीडीपीआर गाइड देखें.
अमेरिका के राज्यों के निजता कानून
अमेरिका के राज्यों के निजता कानूनों के मुताबिक, उपयोगकर्ताओं को अपनी "निजी जानकारी" (जैसा कि कानून में परिभाषित है) की "बिक्री" से ऑप्ट आउट करने का अधिकार मिलना चाहिए. ऑप्ट आउट का विकल्प देने के लिए, "बिक्री करने वाले" पक्ष को अपने होम पेज पर "मेरी निजी जानकारी न बेचें" का लिंक प्रमुखता से दिखाना होगा. अमेरिका के राज्यों के निजता कानूनों का पालन करने से जुड़ी गाइड में, Google के विज्ञापन दिखाने के लिए सीमित डेटा प्रोसेसिंग मोड को चालू करने की सुविधा मिलती है. हालांकि, Google आपकी मीडिएशन चेन में मौजूद हर विज्ञापन नेटवर्क पर इस सेटिंग को लागू नहीं कर सकता. इसलिए, आपको मीडिएशन चेन में मौजूद हर उस विज्ञापन नेटवर्क कंपनी की पहचान करनी होगी जो निजी जानकारी की बिक्री में हिस्सा ले सकती है. साथ ही, आपको यह पक्का करने के लिए कि निजता कानून का पालन किया जा रहा है, उन सभी नेटवर्क से मिले दिशा-निर्देशों का पालन करना होगा.
BidMachine, GPP के लिए सहमति से जुड़ी जानकारी को अपने-आप पढ़ लेता है. यह जानकारी, सहमति मैनेज करने वाले प्लैटफ़ॉर्म सेट करते हैं. इनमें UMP SDK भी शामिल है. ज़्यादा जानकारी के लिए, Android और iOS के लिए, BidMachine की GPP गाइड देखें.
पांचवां चरण: ज़रूरी कोड जोड़ना
Android
BidMachine इंटिग्रेशन के लिए, किसी अन्य कोड की ज़रूरत नहीं होती.
iOS
SKAdNetwork इंटिग्रेशन
अपने प्रोजेक्ट की Info.plist फ़ाइल में SKAdNetwork आइडेंटिफ़ायर जोड़ने के लिए, SKAdNetwork Support के बारे में BidMachine का दस्तावेज़ पढ़ें.
छठा चरण: लागू किए गए बदलावों की जांच करना
टेस्ट विज्ञापनों को चालू करना
पक्का करें कि आपने AdMob के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो.
BidMachine के लिए टेस्ट मोड चालू करने के लिए, BidMachine के दस्तावेज़ में दिए गए निर्देशों का पालन करें. ये निर्देश Android और iOS के लिए दिए गए हैं.
टेस्ट विज्ञापनों की पुष्टि करना
यह पुष्टि करने के लिए कि आपको BidMachine से टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन जांचने वाले टूल में BidMachine (बिडिंग) विज्ञापन सोर्स का इस्तेमाल करके, विज्ञापन के किसी एक सोर्स को टेस्ट करना चालू करें.
गड़बड़ी के कोड
अगर अडैप्टर को BidMachine से विज्ञापन नहीं मिलता है, तो पब्लिशर विज्ञापन रिस्पॉन्स में हुई गड़बड़ी की जानकारी देखने के लिए, इनमें से किसी क्लास के हिसाब से ResponseInfo का इस्तेमाल करें:
Android
io.bidmachine
com.google.ads.mediation.bidmachine
iOS
GADMediationAdapterBidMachine
विज्ञापन लोड न होने पर, BidMachine अडैप्टर से मिलने वाले कोड और उनसे जुड़े मैसेज यहां दिए गए हैं:
Android
| गड़बड़ी का कोड | डोमेन | कारण |
|---|---|---|
| 100 | com.google.ads.mediation.bidmachine | अमान्य या खाली प्लेसमेंट आईडी मिला है. |
| 101 | com.google.ads.mediation.bidmachine | सिग्नल इकट्ठा करने के दौरान गड़बड़ी: सिग्नल डेटा कॉन्फ़िगरेशन नहीं मिला. |
| 102 | com.google.ads.mediation.bidmachine | सिग्नल इकट्ठा करने के दौरान, अमान्य विज्ञापन फ़ॉर्मैट मिला. |
| 103 | com.google.ads.mediation.bidmachine | विज्ञापन के अनुरोध किए गए साइज़ को bidmachine.BannerSize पर मैप नहीं किया जा सका |
| 104 | com.google.ads.mediation.bidmachine | BidMachine के लोड किए गए विज्ञापन दिखाने के अनुरोध की समयसीमा खत्म हो गई है. |
| 105 | com.google.ads.mediation.bidmachine | फ़ुलस्क्रीन विज्ञापन नहीं दिखाया जा सका. |
| 106 | com.google.ads.mediation.bidmachine | BidMachine SDK ने null विज्ञापन डेटा के साथ onAdLoaded() कॉलबैक दिखाया. |
iOS
| गड़बड़ी का कोड | डोमेन | वजह |
|---|---|---|
| 101 | com.google.mediation.bidmachine | सर्वर कॉन्फ़िगरेशन में ज़रूरी पब्लिशर आईडी मौजूद नहीं है. |
| 102 | com.google.mediation.bidmachine | बिडिंग सिग्नल इकट्ठा करने का अनुरोध पूरा नहीं हुआ. इसकी वजह यह है कि आरटीबी पैरामीटर में विज्ञापन का फ़ॉर्मैट शामिल नहीं है या बताया गया फ़ॉर्मैट मौजूद नहीं है. |
| 103 | com.google.mediation.bidmachine | विज्ञापन लोड करने के लिए, विज्ञापन कॉन्फ़िगरेशन अमान्य है. |
| 104 | com.google.mediation.bidmachine | BidMachine SDK ने बैनर विज्ञापन के BidMachineAdProtocol didLoadAd डेलिगेट तरीके को नॉन-बैनर विज्ञापन दिखाया. ऐसा कभी नहीं होना चाहिए. |
| 105 | com.google.mediation.bidmachine | फ़ुलस्क्रीन विज्ञापन दिखाने के लिए तैयार नहीं है. |
| 106 | com.google.mediation.bidmachine | Bid Machine SDK ने नेटिव विज्ञापन के BidMachineAdProtocol didLoadAd डेलिगेट तरीके को नॉन-नेटिव विज्ञापन दिखाया. ऐसा कभी नहीं होना चाहिए. |
| 107 | com.google.mediation.bidmachine | नेटिव विज्ञापन की इमेज के किसी एक सोर्स को लोड नहीं किया जा सका. |
| 108 | com.google.mediation.bidmachine | BidMachine, बैनर विज्ञापन के इस साइज़ के साथ काम नहीं करता. |
BidMachine Unity मीडिएशन प्लगिन के बदलावों की जानकारी
वर्शन 1.4.2
- BidMachine Android अडैप्टर के वर्शन 3.7.1.1 के साथ काम करता है.
- BidMachine iOS अडैप्टर के वर्शन 3.7.1.0.1 के साथ काम करता है.
- इसे Google Mobile Ads Unity Plugin के 11.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.4.1
- BidMachine Android adapter version 3.7.0.0 के साथ काम करता है.
- BidMachine iOS अडैप्टर के वर्शन 3.7.1.0 के साथ काम करता है.
- इसे Google Mobile Ads Unity Plugin के 11.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.4.0
- BidMachine Android adapter version 3.7.0.0 के साथ काम करता है.
- BidMachine iOS अडैप्टर के वर्शन 3.7.0.0 के साथ काम करता है.
- इसे Google Mobile Ads Unity Plugin के 11.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.3.0
- BidMachine Android adapter version 3.7.0.0 के साथ काम करता है.
- BidMachine iOS अडैप्टर के 3.6.1.1 वर्शन के साथ काम करता है.
- इसे Google Mobile Ads Unity Plugin के 11.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.2.1
- BidMachine Android अडैप्टर के वर्शन 3.6.1.0 के साथ काम करता है.
- BidMachine iOS अडैप्टर के वर्शन 3.6.1.0 के साथ काम करता है.
- इसे Google Mobile Ads Unity प्लगिन के 11.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.2.0
- BidMachine Android अडैप्टर के वर्शन 3.6.1.0 के साथ काम करता है.
- BidMachine iOS अडैप्टर के वर्शन 3.6.0.0 के साथ काम करता है.
- इसे Google Mobile Ads Unity प्लगिन के 11.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.1.0
- BidMachine Android अडैप्टर वर्शन 3.5.1.2 के साथ काम करता है.
- BidMachine iOS अडैप्टर के वर्शन 3.6.0.0 के साथ काम करता है.
- इसे Google Mobile Ads Unity प्लगिन के 11.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.0.2
- BidMachine Android अडैप्टर वर्शन 3.5.1.2 के साथ काम करता है.
- BidMachine iOS अडैप्टर वर्शन 3.5.1.2 के साथ काम करता है.
- इसे Google Mobile Ads Unity प्लगिन के 11.0.0 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.0.1
- BidMachine Android अडैप्टर के वर्शन 3.5.1.1 के साथ काम करता है.
- BidMachine iOS अडैप्टर के वर्शन 3.5.1.0 के साथ काम करता है.
- इसे Google Mobile Ads Unity Plugin के 10.7.0 वर्शन के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.0.0
- पहली बार रिलीज़ किया गया!
- BidMachine Android अडैप्टर वर्शन 3.5.1.0 के साथ काम करता है.
- BidMachine iOS अडैप्टर के वर्शन 3.5.1.0 के साथ काम करता है.
- इसे Google Mobile Ads Unity Plugin के 10.6.0 वर्शन के साथ बनाया और टेस्ट किया गया है.