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

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

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

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

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

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

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

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

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

Android एपीआई लेवल 24 या इसके बाद का वर्शन.

[बिडिंग के लिए]: बिडिंग में इस्तेमाल किए जा सकने वाले सभी विज्ञापन फ़ॉर्मैट को इंटिग्रेट करने के लिए, BidMachine अडैप्टर का 3.4.0.1 या इसके बाद का वर्शन इस्तेमाल करें. हमारा सुझाव है कि आप नया वर्शन इस्तेमाल करें.

GMA Next-Gen 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 और अडैप्टर को इंपोर्ट करना

Android Studio इंटिग्रेशन (सुझाया गया)

अपने प्रोजेक्ट-लेवल की settings.gradle (या settings.gradle.kts) फ़ाइल में, ये रिपॉज़िटरी जोड़ें:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://artifactory.bidmachine.io/bidmachine")
    }
  }
}

अपने ऐप्लिकेशन-लेवल की gradle फ़ाइल में, लागू करने से जुड़ी ये डिपेंडेंसी और कॉन्फ़िगरेशन जोड़ें:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0")
    implementation("com.google.ads.mediation:bidmachine:3.8.0.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

ग्रूवी

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0'
    implementation 'com.google.ads.mediation:bidmachine:3.8.0.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

वैकल्पिक चरण

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

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

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

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

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

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

io.bidmachine
com.google.ads.mediation.bidmachine

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

गड़बड़ी का कोड	डोमेन	कारण
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()` कॉलबैक दिखाया.