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

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

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

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

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

इंटिग्रेशन
बिडिंग
वॉटरफ़ॉल  1
फ़ॉर्मैट
ऐप का खुलना
बैनर
इंटरस्टीशियल विज्ञापन
इनाम वाले विज्ञापन
इनाम वाला इंटरस्टीशियल विज्ञापन
नेटिव लेआउट

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

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

आगे बढ़ने से पहले, यह पक्का करें कि:

  • नया Google Mobile Ads Flutter Plugin वर्शन.
  • Flutter फ़्रेमवर्क का वर्शन 3.7.0 या इसके बाद का वर्शन इंस्टॉल हो.
  • Android पर डिप्लॉय करने के लिए
    • Android का एपीआई लेवल 23 या इसके बाद का वर्शन इंस्टॉल हो.
  • iOS पर डिप्लॉय करने के लिए
    • iOS डिप्लॉयमेंट का टारगेट 13.0 या इसके बाद का वर्शन हो.
  • ऐसा Flutter प्रोजेक्ट हो जिस पर काम किया जा सकता हो और जिसे Google Mobile Ads Flutter Plugin के साथ कॉन्फ़िगर किया गया हो. ज़्यादा जानकारी के लिए, शुरू करें लेख पढ़ें.
  • AdMob मीडिएशन सेट अप किया गया हो.

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

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

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

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

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

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

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

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

Android

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

iOS

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

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

Android

Android प्लेसमेंट की जानकारी

iOS

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 को जोड़ना

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

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

pub.dev के ज़रिए इंटिग्रेशन

अपने पैकेज की pubspec.yaml फ़ाइल में, BidMachine SDK और अडैप्टर के नए वर्शन के साथ यह डिपेंडेंसी जोड़ें:

dependencies:
  gma_mediation_bidmachine: ^1.4.1

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

BidMachine के लिए Google Mobile Ads मीडिएशन प्लगिन का नया वर्शन डाउनलोड करें. इसके बाद, डाउनलोड की गई फ़ाइल को एक्सट्रैक्ट करें. अब एक्सट्रैक्ट किए गए प्लगिन फ़ोल्डर (और उसके कॉन्टेंट) को अपने Flutter प्रोजेक्ट में जोड़ें. इसके बाद, अपनी pubspec.yaml फ़ाइल में प्लगिन का रेफ़रंस दें. इसके लिए, यह डिपेंडेंसी जोड़ें:

dependencies:
  gma_mediation_bidmachine:
    path: path/to/local/package

चौथा चरण: 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

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

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

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

BidMachine Flutter मीडिएशन अडैप्टर के बदलावों की जानकारी

वर्शन 1.4.2 (डेवलेपमेंट में है)

  • Google Mobile Ads Flutter प्लगिन के वर्शन 9.1.0 के साथ काम करने के लिए अपडेट किया गया.
  • Swift Package Manager की सुविधा जोड़ी गई.

वर्शन 1.4.1

वर्शन 1.4.0

वर्शन 1.3.2

वर्शन 1.3.1

वर्शन 1.3.0

वर्शन 1.2.0

वर्शन 1.1.0

वर्शन 1.0.0