BidMachine को मध्यस्थता के साथ इंटिग्रेट करना

प्लैटफ़ॉर्म चुनें: Android iOS Unity Flutter Android (लेगसी)

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

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

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

इंटिग्रेशन
बिडिंग
वॉटरफ़ॉल	^1
फ़ॉर्मैट
ऐप का खुलना
बैनर
इंटरस्टीशियल विज्ञापन
इनाम वाले विज्ञापन
इनाम वाला इंटरस्टीशियल विज्ञापन

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

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

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

• Google Mobile Ads Unity Plugin का नया वर्शन.
• Unity Editor का वर्शन 2019.4 या इसके बाद का वर्शन.
• Android पर डिप्लॉय करने के लिए
  • Android एपीआई लेवल 24 या इसके बाद का वर्शन.
• iOS पर डिप्लॉय करने के लिए
  • iOS डिप्लॉयमेंट का टारगेट 13.0 या इसके बाद का वर्शन होना चाहिए.
• Google Mobile Ads Unity Plugin के साथ कॉन्फ़िगर किया गया ऐसा Unity प्रोजेक्ट जिस पर काम किया जा सकता हो. ज़्यादा जानकारी के लिए, शुरू करें लेख पढ़ें.

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

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

अपने 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 को जोड़ना

अहम जानकारी: पक्का करें कि आपके पास खाते के मैनेजमेंट की अनुमति हो, ताकि आप ईयू उपयोगकर्ता की सहमति और जीडीपीआर, अमेरिका के राज्यों में लागू कानूनों, और User Messaging Platform के लिए कॉन्फ़िगरेशन पूरा कर सकें. ज़्यादा जानकारी के लिए, अपने खाते में उपयोगकर्ता के ऐक्सेस को मैनेज करना लेख पढ़ें.

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

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

ध्यान दें: साथ काम करने वाले BidMachine और Google Mobile Ads Unity Plugin के वर्शन इंटिग्रेट न होने पर, बिल्ड से जुड़ी समस्याएं आ सकती हैं.

OpenUPM-CLI

अहम जानकारी: अगर आपको .unitypackage से OpenUPM-CLI पर माइग्रेट करना है, तो आपको पुरानी जगह से ऐसेट को मैन्युअल तरीके से अनइंस्टॉल करना होगा. इसके लिए, Assets/GoogleMobileAds/Mediation/BidMachine फ़ोल्डर से सभी फ़ाइलें मिटाएं.

अगर आपके पास OpenUPM-CLI इंस्टॉल है, तो अपने प्रोजेक्ट की रूट डायरेक्ट्री से यह कमांड चलाकर, Unity के लिए Google Mobile Ads BidMachine मीडिएशन प्लगिन को अपने प्रोजेक्ट में इंस्टॉल किया जा सकता है:

openupm add com.google.ads.mobile.mediation.bidmachine

OpenUPM

अहम जानकारी: अगर आपको .unitypackage से OpenUPM पर माइग्रेट करना है, तो आपको पुरानी जगह से ऐसेट को मैन्युअल तरीके से अनइंस्टॉल करना होगा. इसके लिए, Assets/GoogleMobileAds/Mediation/BidMachine फ़ोल्डर से सभी फ़ाइलें मिटाएं.

अपने Unity प्रोजेक्ट एडिटर में, Edit > Project Settings > Package Manager को चुनें. इससे Unity Package Manager Settings खुल जाएगा.

Scoped Registries टैब में जाकर, OpenUPM को ऐसी रजिस्ट्री के तौर पर जोड़ें जो उसके स्कोप में हो. इसके लिए, यह जानकारी डालें:

• नाम: OpenUPM
• URL: https://package.openupm.com
• स्कोप: com.google

इसके बाद, Window > Package Manager पर जाकर, Unity Package Manager खोलें. इसके बाद, ड्रॉप-डाउन मेन्यू से My Registries को चुनें.

Google Mobile Ads BidMachine Mediation पैकेज चुनें और Install पर क्लिक करें.

Unity पैकेज

बदलाव की जानकारी में दिए गए डाउनलोड करने के लिंक से, BidMachine के लिए Google Mobile Ads मीडिएशन प्लग इन का नया वर्शन डाउनलोड करें. इसके बाद, zip फ़ाइल से GoogleMobileAdsBidMachineMediation.unitypackage को एक्सट्रैक्ट करें.

अपने Unity प्रोजेक्ट एडिटर में, Assets > Import Package > Custom Package को चुनें. इसके बाद, डाउनलोड की गई GoogleMobileAdsBidMachineMediation.unitypackage फ़ाइल को ढूंढें. पक्का करें कि सभी फ़ाइलें चुनी गई हों. इसके बाद, इंपोर्ट करें पर क्लिक करें.

इसके बाद, ऐसेट > External Dependency Manager > Android Resolver > Force Resolve को चुनें. External Dependency Manager लाइब्रेरी, डिपेंडेंसी रिज़ॉल्यूशन को शुरू से पूरा करेगी. साथ ही, एलान की गई डिपेंडेंसी को आपके Unity ऐप्लिकेशन की Assets/Plugins/Android डायरेक्ट्री में कॉपी करेगी.

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

ईयू उपयोगकर्ता की सहमति से जुड़ी नीति और जीडीपीआर

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

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

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

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

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

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

Android

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

iOS

SKAdNetwork इंटिग्रेशन

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

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

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

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

BidMachine के लिए टेस्ट मोड चालू करने के लिए, Android और iOS के लिए BidMachine के दस्तावेज़ में दिए गए निर्देशों का पालन करें.

अहम जानकारी: अपने ऐप्लिकेशन को रिलीज़ करने से पहले, AdMob और BidMachine के लिए टेस्ट मोड बंद करें.

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

यह पुष्टि करने के लिए कि आपको 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.5.2

• BidMachine Android अडैप्टर के 3.8.0.1 वर्शन के साथ काम करता है.
• इसमें BidMachine iOS अडैप्टर के वर्शन 3.8.1.0 के साथ काम करने की सुविधा जोड़ी गई है.
• इसे Google Mobile Ads Unity प्लगिन के 11.6.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.5.1

• BidMachine Android अडैप्टर के 3.8.0.1 वर्शन के साथ काम करता है.
• BidMachine iOS अडैप्टर के 3.8.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Unity प्लगिन के 11.5.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.5.0

• BidMachine Android अडैप्टर के वर्शन 3.8.0.0 के साथ काम करता है.
• BidMachine iOS अडैप्टर के 3.8.0.0 वर्शन के साथ काम करता है.
• इसे Google Mobile Ads Unity प्लगिन के 11.5.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.4.2

• BidMachine Android अडैप्टर के 3.7.1.1 वर्शन के साथ काम करता है.
• इसमें BidMachine के iOS अडैप्टर का वर्शन 3.7.1.0.1 काम करता है.
• इसे Google Mobile Ads Unity प्लग इन के 11.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.4.1

• BidMachine Android अडैप्टर के 3.7.0.0 वर्शन के साथ काम करता है.
• इसमें BidMachine के iOS अडैप्टर का 3.7.1.0 वर्शन काम करता है.
• इसे Google Mobile Ads Unity प्लग इन के 11.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.4.0

• BidMachine Android अडैप्टर के 3.7.0.0 वर्शन के साथ काम करता है.
• BidMachine iOS अडैप्टर के वर्शन 3.7.0.0 के साथ काम करता है.
• इसे Google Mobile Ads Unity प्लग इन के 11.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.3.0

• BidMachine Android अडैप्टर के 3.7.0.0 वर्शन के साथ काम करता है.
• BidMachine iOS अडैप्टर के वर्शन 3.6.1.1 के साथ काम करता है.
• इसे Google Mobile Ads Unity प्लग इन के 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 प्लगिन के 10.7.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

वर्शन 1.0.0

• शुरुआती रिलीज़!
• इसमें BidMachine Android अडैप्टर के वर्शन 3.5.1.0 का इस्तेमाल किया जा सकता है.
• इसमें BidMachine के iOS अडैप्टर का वर्शन 3.5.1.0 काम करता है.
• इसे Google Mobile Ads Unity प्लग इन के 10.6.0 वर्शन के साथ बनाया और टेस्ट किया गया है.