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

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

इस गाइड में बताया गया है कि Google Mobile Ads Unity Plugin का इस्तेमाल करके, BidMachine से विज्ञापन लोड करने और दिखाने का तरीका क्या है. इसमें AdMob मीडिएशन की मदद से बिडिंग इंटिग्रेशन शामिल हैं. इसमें बताया गया है कि किसी विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में 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 प्लगिन के साथ कॉन्फ़िगर किया गया ऐसा Unity प्रोजेक्ट जिस पर काम किया जा सकता हो.Google Mobile Ads Unity Plugin ज़्यादा जानकारी के लिए, शुरू करें लेख पढ़ें.
• मीडिएशन की प्रोसेस पूरी करने के शुरुआती निर्देश

पहला चरण: 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 को जोड़ना

अहम जानकारी: पक्का करें कि आपके पास खाते के मैनेजमेंट की अनुमति हो, ताकि आप ई101}यू उपयोगकर्ता की सहमति और जीडीपीआर, अमेरिका के राज्यों में लागू कानूनों, और 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 プロジェクト エディターで、Edit > Project Settings > Package Manager を選択して、 Unity Package Manager の設定を開きます。

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

• नाम: OpenUPM
• यूआरएल: 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 मीडिएशन प्लगिन का नया वर्शन डाउनलोड करें. इसके बाद, ज़िप फ़ाइल से GoogleMobileAdsBidMachineMediation.unitypackage को एक्सट्रैक्ट करें.

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

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

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

Android

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

iOS

SKAdNetwork इंटिग्रेशन

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

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

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

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

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 ने onAdLoaded() कॉलबैक, null विज्ञापन डेटा के साथ दिखाया.

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 मीडिएशन प्लगिन के बदलावों का लॉग

वर्शन 1.2.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 के साथ बनाया और टेस्ट किया गया है.