Google Advertising and Measurement Community सर्वर के #gma-next-gen-sdk Discord चैनल में, GMA Next-Gen SDK के बारे में अपना सुझाव/राय दें या शिकायत करें.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

Android iOS Unity Flutter

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

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

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

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

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

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

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

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

GMA Next-Gen SDK पर अपलोड हुआ नया वीडियो
मीडिएशन की प्रोसेस पूरी करने के शुरुआती निर्देश

पहला चरण: 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 के लिए बनाया था. इंटिग्रेशन टाइप के तौर पर मोबाइल SDK मीडिएशन, प्लैटफ़ॉर्म के तौर पर Android, और स्टेटस के तौर पर चालू है को चुनें.

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

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

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

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

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

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

Kotlin

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

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.1.1'
    implementation 'com.google.ads.mediation:bidmachine:3.7.0.0'
}

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

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

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

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

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

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

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

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

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

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

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()` कॉलबैक दिखाया.

BidMachine Android Mediation Adapter के बदलावों की जानकारी