BidMachine को मीडिएशन के साथ इंटिग्रेट करना

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

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

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

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

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

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

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

• iOS डिप्लॉयमेंट का टारगेट 13.0 या इसके बाद का वर्शन होना चाहिए

• Google Mobile Ads SDK पर अपलोड हुआ नया वीडियो

• मीडिएशन की प्रोसेस पूरी करने के शुरुआती निर्देश

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

BidMachine खाते के डैशबोर्ड में लॉग इन करें.

नए प्लेसमेंट बनाना

सोर्स टैब पर जाएं. इसके बाद, सोर्स टेबल में जाकर, बदलाव करें बटन को चुनें.

ध्यान दें: BidMachine आपके लिए सोर्स अपने-आप बनाता है. अगर आपको नया सोर्स बनाना है, तो कृपया अपने खाता मैनेजर से संपर्क करें.

आपको उन सभी प्लेसमेंट की सूची दिखेगी जो आपके पास हैं. नया प्लेसमेंट बनाने के लिए, डायलॉग बॉक्स में मौजूद प्लेसमेंट जोड़ें बटन पर क्लिक करें.

फ़ॉर्म भरें और सेव करें पर क्लिक करें.

आखिर में, प्लेसमेंट आईडी को नोट करें.

app-ads.txt फ़ाइल अपडेट करना

ऐप्लिकेशन के लिए, अनुमति वाले सेलर (app-ads.txt), IAB Tech Lab की एक पहल है. इसकी मदद से यह पक्का किया जा सकता है कि आपके ऐप्लिकेशन की विज्ञापन इन्वेंट्री सिर्फ़ वे चैनल बेचें जिन्हें आपने अनुमति दी है. विज्ञापन से मिलने वाले रेवेन्यू में ज़्यादा नुकसान न हो, इसके लिए आपको app-ads.txt फ़ाइल लागू करनी होगी. अगर आपने अब तक ऐसा नहीं किया है, तो Ad Manager के लिए app-ads.txt फ़ाइल बनाएं.

BidMachine के लिए app-ads.txt लागू करने के लिए, डैशबोर्ड में जाकर app-ads.txt टैब पर जाएं. इसके बाद, सूची को कॉपी करें और उसे अपनी वेबसाइट की app-ads.txt फ़ाइल में जोड़ें.

दूसरा चरण: Ad Manager के यूआई में BidMachine की डिमांड सेट अप करना

अपने Ad Manager खाते में साइन इन करें.

'कंपनियां' सेक्शन में BidMachine जोड़ना

बिडिंग

बिडिंग इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.

वॉटरफ़ॉल

एडमिन > कंपनियां पर जाएं. इसके बाद, सभी कंपनियां टैब में मौजूद, नई कंपनी बटन पर क्लिक करें. विज्ञापन नेटवर्क चुनें.

विज्ञापन नेटवर्क के तौर पर BidMachine चुनें. इसके बाद, यूनीक नाम डालें और मीडिएशन चालू करें.

आपको उपयोगकर्ता नाम या पासवर्ड डालने की ज़रूरत नहीं है. बदलाव पूरा होने पर, सेव करें पर क्लिक करें.

सुरक्षित तरीके से सिग्नल शेयर करने की सुविधा चालू करना

बिडिंग

एडमिन > ग्लोबल सेटिंग पर जाएं. Ad Exchange खाते की सेटिंग टैब पर जाएं. इसके बाद, सुरक्षित तरीके से सिग्नल शेयर करने की सुविधा की समीक्षा करें और इसे टॉगल करके चालू करें. सेव करें पर क्लिक करें.

वॉटरफ़ॉल

वॉटरफ़ॉल इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.

बिड रिक्वेस्ट पर सुरक्षित तरीके से सिग्नल शेयर करना

बिडिंग

इन्वेंट्री > सुरक्षित सिग्नल पर जाएं. सुरक्षित सिग्नल में जाकर, BidMachineToken खोजें. इसके बाद, ऐप्लिकेशन इंटिग्रेशन चालू करें को टॉगल करके चालू करें.

सेव करें पर क्लिक करें.

वॉटरफ़ॉल

वॉटरफ़ॉल इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.

एसडीके से बिडिंग के लिए सुरक्षित सिग्नल शेयरिंग की अनुमति देना

बिडिंग

डिलीवरी > डिमांड चैनल की सेटिंग पर जाएं. डिफ़ॉल्ट सेटिंग टैब में, एसडीके से बिडिंग के लिए, सुरक्षित सिग्नल शेयर करने की अनुमति दें को टॉगल करके चालू करें.

सेव करें पर क्लिक करें.

वॉटरफ़ॉल

वॉटरफ़ॉल इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.

BidMachine बिडिंग को कॉन्फ़िगर करना

बिडिंग

विज्ञापन डिलीवरी > बिड करने वाले पर जाएं. इसके बाद, एसडीके से बिडिंग पर जाएं पर क्लिक करें.

नया बिडर पर क्लिक करें.

बिडर के तौर पर BidMachine को चुनें.

बिड करने वाले इस व्यक्ति या कंपनी के लिए एसडीके से बिडिंग की सुविधा चालू करने के लिए, जारी रखें पर क्लिक करें.

हो गया पर क्लिक करें.

वॉटरफ़ॉल

वॉटरफ़ॉल इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.

विज्ञापन यूनिट को मैप करने की सुविधा कॉन्फ़िगर करना

बिडिंग

विज्ञापन डिलीवरी > बिड करने वाले पर जाएं. इसके बाद, एसडीके से बिडिंग पर जाएं पर क्लिक करें.

BidMachine के लिए कंपनी चुनें.

विज्ञापन यूनिट की मैपिंग टैब पर जाएं. इसके बाद, नई विज्ञापन यूनिट की मैपिंग पर क्लिक करें.

कोई खास विज्ञापन यूनिट चुनें. कोई विज्ञापन यूनिट और फ़ॉर्मैट चुनें. इसके बाद, इन्वेंट्री टाइप के तौर पर मोबाइल ऐप्लिकेशन और अपना मोबाइल ऐप्लिकेशन चुनें. इसके बाद, पिछले सेक्शन में मिला सोर्स आईडी और प्लेसमेंट आईडी डालें.

आखिर में, सेव करें पर क्लिक करें.

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

झरना

डिलीवरी > यील्ड ग्रुप पर जाएं. इसके बाद, नया यील्ड ग्रुप बटन पर क्लिक करें. अपना मोबाइल ऐप्लिकेशन चुनें.

नीचे की ओर स्क्रोल करें और यील्ड पार्टनर जोड़ें पर क्लिक करें.

उस कंपनी को चुनें जिसे आपने पिछले सेक्शन में BidMachine के लिए बनाया था. इंटिग्रेशन टाइप के तौर पर मोबाइल एसडीके मीडिएशन, प्लैटफ़ॉर्म के तौर पर iOS, और स्टेटस के तौर पर चालू है चुनें.

पिछले सेक्शन में मिला प्लेसमेंट आईडी और डिफ़ॉल्ट सीपीएम वैल्यू डालें. सेव करें पर क्लिक करें.

अहम जानकारी: सोर्स आईडी को टारगेट किए गए ऐप्लिकेशन से जोड़ना ज़रूरी है. ऐसा BidMachine के यूज़र इंटरफ़ेस (यूआई) में किया जाता है.

BidMachine को जीडीपीआर और अमेरिका के राज्यों में लागू कानूनों के तहत विज्ञापन पार्टनरों की सूची में जोड़ना

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

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

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

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

Swift Package Manager का इस्तेमाल करना

आगे बढ़ने से पहले, आपके पास कम से कम 3.6.0.0 वर्शन का अडैप्टर होना चाहिए.

अपने प्रोजेक्ट में पैकेज डिपेंडेंसी जोड़ने के लिए, यह तरीका अपनाएं:

1. Xcode में, File > Add Package Dependencies... पर जाएं.

2. दिखने वाले प्रॉम्प्ट में, इस पैकेज यूआरएल को खोजें:

   https://github.com/googleads/googleads-mobile-ios-mediation-bidmachine.git
   

3. डिपेंडेंसी का नियम में जाकर, ब्रांच चुनें.

4. टेक्स्ट फ़ील्ड में, main डालें.

CocoaPods का इस्तेमाल करना

• अपने प्रोजेक्ट की Podfile में यह लाइन जोड़ें:

  pod 'GoogleMobileAdsMediationBidMachine'
  

• कमांड लाइन में यह निर्देश चलाएं:

  pod install --repo-update

मैन्युअल इंटिग्रेशन

1. iOS के लिए BidMachine SDK का नया वर्शन डाउनलोड करें. इसके बाद, अपने प्रोजेक्ट में सभी .xcframework फ़ाइलों और बंडलों को लिंक करें.

2. बदलाव की जानकारी में दिए गए डाउनलोड लिंक से, BidMachine अडैप्टर का नया वर्शन डाउनलोड करें. इसके बाद, BidMachineAdapter.xcframework को अपने प्रोजेक्ट में लिंक करें.

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

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

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

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

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

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

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

SKAdNetwork लागू करना

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

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

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

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

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

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

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

यह पुष्टि करने के लिए कि आपको BidMachine से टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन जांचने वाले टूल में BidMachine (बिडिंग) विज्ञापन सोर्स का इस्तेमाल करके, विज्ञापन के किसी एक सोर्स को टेस्ट करना चालू करें.

वैकल्पिक चरण

नेटिव विज्ञापन

विज्ञापन रेंडरिंग

BidMachine अडैप्टर, अपने नेटिव विज्ञापनों को GADNativeAd ऑब्जेक्ट के तौर पर दिखाता है. यह GADNativeAd के लिए, इन फ़ील्ड में जानकारी भरता है.

फ़ील्ड	BidMachine अडैप्टर की ओर से हमेशा शामिल की जाने वाली ऐसेट
हेडलाइन
इमेज
Body
आइकॉन
कॉल-टू-ऐक्शन
स्टार रेटिंग
स्टोर
कीमत
विज्ञापन देने वाला

गड़बड़ी के कोड

अगर अडैप्टर को BidMachine से विज्ञापन नहीं मिलता है, तो विज्ञापन के जवाब में हुई गड़बड़ी की जानकारी देखने के लिए, इनमें से किसी क्लास के हिसाब से GADResponseInfo.adNetworkInfoArray का इस्तेमाल करें:

GADMediationAdapterBidMachine

विज्ञापन लोड न होने पर, BidMachine अडैप्टर से मिलने वाले कोड और उनसे जुड़े मैसेज यहां दिए गए हैं:

गड़बड़ी का कोड	डोमेन	वजह
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 iOS Mediation Adapter के बदलावों की जानकारी

वर्शन 3.7.0.0

• BidMachine SDK के 3.7.0 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 13.4.0.
• BidMachine SDK टूल का वर्शन 3.7.0.

वर्शन 3.6.1.1

• अब अडैप्टर, ageRestrictedTreatment Google Mobile Ads SDK फ़्लैग को BidMachine SDK के COPPA API पर फ़ॉरवर्ड करता है.
• BidMachine अडैप्टर और यूनिट टेस्ट को Swift 6 पर अपग्रेड किया गया.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 13.3.0.
• BidMachine SDK टूल का वर्शन 3.6.1.

वर्शन 3.6.1.0

• BidMachine SDK के 3.6.1 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 13.2.0.
• BidMachine SDK टूल का वर्शन 3.6.1.

वर्शन 3.6.0.0

• BidMachine SDK के 3.6.0 वर्शन के साथ काम करने की पुष्टि की गई है.
• BidMachine बैनर विज्ञापन लोड करने और नेटिव विज्ञापन की इमेज हैंडल करने की प्रोसेस को बेहतर बनाया गया है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 13.1.0.
• BidMachine SDK टूल का वर्शन 3.6.0.

वर्शन 3.5.1.2

• Google Mobile Ads SDK की डिपेंडेंसी को 13.0.0 वर्शन पर अपडेट किया गया है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 13.0.0.
• BidMachine SDK टूल का वर्शन 3.5.1.

वर्शन 3.5.1.1

• CocoaPods के लिए, iOS के कम से कम वर्शन को 13.0 पर अपडेट किया गया है.
• tagForUnderAgeOfConsent Google Mobile Ads SDK पैरामीटर को BidMachine SDK पर फ़ॉरवर्ड करने की सुविधा जोड़ी गई.
• BidMachine SDK के कॉलबैक के व्यवहार के मुताबिक, BidMachineAdDelegate के अनुपालन से जुड़े सेक्शन में बदलाव किया गया है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 13.0.0.
• BidMachine SDK टूल का वर्शन 3.5.1.

वर्शन 3.5.1.0

• BidMachine SDK के 3.5.1 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 12.14.0.
• BidMachine SDK टूल का वर्शन 3.5.1.

वर्शन 3.5.0.0

• BidMachine SDK के 3.5.0 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 12.12.0.
• BidMachine SDK टूल का वर्शन 3.5.0.

वर्शन 3.4.0.2

• बैनर, इंटरस्टीशियल, इनाम वाले, और नेटिव विज्ञापन फ़ॉर्मैट के लिए वॉटरफ़ॉल की सुविधा जोड़ी गई.
• BidMachineAdapterExtras से isTestMode स्टैटिक प्रॉपर्टी हटा दी गई है.
• वॉटरफ़ॉल बैनर विज्ञापनों के लिए, बैनर विज्ञापन के साइज़ की पुष्टि करने की सुविधा जोड़ी गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 12.12.0.
• BidMachine SDK टूल का वर्शन 3.4.0.

वर्शन 3.4.0.1

• टेस्ट मोड अब Objective-C में GADMediationAdapterBidMachineExtras.isTestMode प्रॉपर्टी के ज़रिए उपलब्ध है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 12.0.0.
• BidMachine SDK टूल का वर्शन 3.4.0.

वर्शन 3.4.0.0

• शुरुआती रिलीज़.
• बैनर, इंटरस्टीशियल, इनाम वाले, और नेटिव विज्ञापन फ़ॉर्मैट के लिए बिडिंग की सुविधा जोड़ी गई.
• BidMachine SDK के 3.4.0 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 12.8.0.
• BidMachine SDK टूल का वर्शन 3.4.0.