Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

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

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

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

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

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

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

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

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

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

Google Mobile Ads SDK का नया वर्शन.
AdMob मीडिएशन सेट अप करें.

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

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

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

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

सोर्स डैशबोर्ड

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

सोर्स डायलॉग में बदलाव करें

प्लेसमेंट टाइप के तौर पर, बिडिंग चुनें. फ़ॉर्म भरें और सेव करें पर क्लिक करें.

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

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

प्लेसमेंट विवरण

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 की डिमांड सेट अप करना

अपनी विज्ञापन यूनिट के लिए मीडिएशन सेटिंग कॉन्फ़िगर करना

आपको अपनी विज्ञापन यूनिट के लिए, मीडिएशन कॉन्फ़िगरेशन में BidMachine को जोड़ना होगा.

सबसे पहले, अपने AdMob खाते में साइन इन करें. इसके बाद, मीडिएशन टैब पर जाएं. अगर आपको किसी मौजूदा मीडिएशन ग्रुप में बदलाव करना है, तो उस मीडिएशन ग्रुप के नाम पर क्लिक करके उसमें बदलाव करें. इसके बाद, BidMachine को विज्ञापन सोर्स के तौर पर जोड़ें पर जाएं.

नया मीडिएशन ग्रुप बनाने के लिए, मीडिएशन ग्रुप बनाएं को चुनें.

विज्ञापन फ़ॉर्मैट और प्लैटफ़ॉर्म की जानकारी डालें. इसके बाद, जारी रखें पर क्लिक करें.

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

इस मीडिएशन ग्रुप को अपनी मौजूदा AdMob विज्ञापन यूनिट में से एक या इससे ज़्यादा विज्ञापन यूनिट से जोड़ें. इसके बाद, हो गया पर क्लिक करें.

अब आपको विज्ञापन यूनिट का कार्ड दिखेगा. इसमें आपको वे विज्ञापन यूनिट दिखेंगी जिन्हें आपने चुना था:

BidMachine को विज्ञापन सोर्स के तौर पर जोड़ना

बिडिंग

विज्ञापन सोर्स सेक्शन में जाकर, बिडिंग कार्ड ढूंढें और विज्ञापन सोर्स जोड़ें को चुनें. इसके बाद, BidMachine को चुनें .

पार्टनरशिप के कानूनी समझौते पर हस्ताक्षर करने का तरीका पर क्लिक करें और BidMachine के साथ बिडिंग पार्टनरशिप सेट अप करें.

स्वीकार करें और सहमति दें पर क्लिक करें. इसके बाद, जारी रखें पर क्लिक करें.

अगर आपने BidMachine को पहले से विज्ञापन सोर्स के तौर पर जोड़ा हुआ है, तो उसे चुना जा सकता है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें पर क्लिक करें.

इसके बाद, पिछले सेक्शन में मिला सोर्स आईडी और प्लेसमेंट आईडी डालें. इसके बाद, हो गया पर क्लिक करें.

वॉटरफ़ॉल

विज्ञापन सोर्स सेक्शन में मौजूद, वॉटरफ़ॉल कार्ड में जाकर, विज्ञापन सोर्स जोड़ें को चुनें.

BidMachine को चुनें. इसके बाद, BidMachine के लिए ईसीपीएम वैल्यू डालें और जारी रखें पर क्लिक करें.

इसके बाद, पिछले सेक्शन में मिला प्लेसमेंट आईडी डालें. इसके बाद, हो गया पर क्लिक करें.

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

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

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

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

जारी रखने से पहले, आपके पास अडैप्टर का कम से कम 3.6.0.0 वर्शन होना चाहिए.

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

Xcode में, File > Add Package Dependencies... पर जाएं.
इसके बाद, जो प्रॉम्प्ट दिखेगा उसमें यह पैकेज यूआरएल खोजें:
```
https://github.com/googleads/googleads-mobile-ios-mediation-bidmachine.git
```
डिपेंडेंसी नियम में जाकर, ब्रांच को चुनें.
टेक्स्ट फ़ील्ड में, main डालें.

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

अपने प्रोजेक्ट की Podfile में यह लाइन जोड़ें:
```
pod 'GoogleMobileAdsMediationBidMachine'
```
कमांड लाइन से, यह चलाएं:
```
pod install --repo-update
```

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

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

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

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

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

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

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

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

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

SKAdNetwork को लागू करना

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

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

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

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

BidMachine के लिए टेस्ट मोड चालू करने के लिए, iOS के लिए 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	नेटिव विज्ञापन के लिए इमेज के सोर्स में से किसी एक को लोड नहीं किया जा सका.
108	com.google.mediation.bidmachine	BidMachine, बैनर विज्ञापन के इस साइज़ के साथ काम नहीं करता.