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

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

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

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

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

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

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

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

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

पहला चरण: 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 इंस्टॉल किया है, तो अपने प्रोजेक्ट में Google Mobile Ads BidMachine Mediation Plugin for Unity इंस्टॉल किया जा सकता है. इसके लिए, अपने प्रोजेक्ट की रूट डायरेक्ट्री से यह कमांड चलाएं:

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

OpenUPM

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

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 के लिए दिए गए हैं.

अहम जानकारी: अपने ऐप्लिकेशन को रिलीज़ करने से पहले, 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	नेटिव विज्ञापन की इमेज के किसी एक सोर्स को लोड नहीं किया जा सका.

BidMachine Unity Mediation Plugin के बदलावों का लॉग

वर्शन 1.4.0 (डेवलपमेंट में है)

वर्शन 1.3.0

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

वर्शन 1.1.0

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

वर्शन 1.0.2

• BidMachine Android अडैप्टर वर्शन 3.5.1.2 के साथ काम करता है.
• BidMAchine iOS adapter version 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 वर्शन के साथ बनाया और टेस्ट किया गया है.