इस गाइड में बताया गया है कि 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 या इसके बाद का वर्शन होना चाहिए
- Google Mobile Ads Flutter Plugin के साथ कॉन्फ़िगर किया गया ऐसा Flutter प्रोजेक्ट जिस पर काम किया जा सकता हो. ज़्यादा जानकारी के लिए, शुरू करें लेख पढ़ें.
- मीडिएशन की प्रोसेस पूरी करने के शुरुआती निर्देश
पहला चरण: BidMachine के यूआई में कॉन्फ़िगरेशन सेट अप करना
लॉग इन करें अपने BidMachine खाते के डैशबोर्ड में.
नई प्लेसमेंट बनाना
सोर्स टैब पर जाएं. इसके बाद, सोर्स टेबल में जाकर, बदलाव करें बटन चुनें.
आपको अपनी सभी प्लेसमेंट की सूची दिखेगी. नई प्लेसमेंट बनाने के लिए, डायलॉग बॉक्स में प्लेसमेंट जोड़ें बटन पर क्लिक करें.
फ़ॉर्म भरें और सेव करें पर क्लिक करें.
Android
iOS
आखिर में, प्लेसमेंट आईडी को नोट करें.
Android
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 की डिमांड सेट अप करना
अपनी विज्ञापन यूनिट के लिए मीडिएशन की सेटिंग कॉन्फ़िगर करना
BidMachine को जीडीपीआर और अमेरिका के राज्यों में लागू कानूनों के तहत विज्ञापन पार्टनरों की सूची में जोड़ना
AdMob के यूआई में, यूरोप और अमेरिका के राज्यों में लागू कानूनों के तहत विज्ञापन पार्टनरों की सूची में BidMachine को जोड़ने के लिए, यहां दिया गया तरीका अपनाएं: यूरोपीय कानूनों की सेटिंग और अमेरिका के राज्यों के कानूनों की सेटिंग
तीसरा चरण: BidMachine SDK और अडैप्टर को इंपोर्ट करना
pub.dev के ज़रिए इंटिग्रेशन करना
अपने पैकेज की pubspec.yaml फ़ाइल में, BidMachine SDK और अडैप्टर के नए वर्शन के साथ यह डिपेंडेंसी जोड़ें:
dependencies:
gma_mediation_bidmachine: ^1.3.2
मैन्युअल इंटिग्रेशन
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 के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो.
टेस्ट विज्ञापनों की पुष्टि करना
यह पुष्टि करने के लिए कि आपको 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 | नेटिव विज्ञापन के इमेज सोर्स में से एक को लोड नहीं किया जा सका. |
BidMachine Flutter मीडिएशन अडैप्टर के बदलावों की जानकारी
वर्शन 1.4.0 (डेवलेपमेंट में है)
वर्शन 1.3.2
- Flutter का ज़रूरी वर्शन 3.38.1 पर अपडेट किया गया
- Google Mobile Ads Flutter Plugin के वर्शन 8.0.0 के साथ काम करने के लिए अपडेट किया गया
- BidMachine Android अडैप्टर के वर्शन 3.6.1.0 के साथ काम करता है.
- BidMachine iOS अडैप्टर के वर्शन 3.6.0.0 के साथ काम करता है.
- Google Mobile Ads Flutter Plugin के वर्शन 8.0.0 के साथ बनाया और टेस्ट किया गया.
वर्शन 1.3.1
- BidMachine Android अडैप्टर के वर्शन 3.5.1.0 के साथ काम करता है.
- BidMachine iOS अडैप्टर के वर्शन 3.5.1.0 के साथ काम करता है.
- Google Mobile Ads Flutter Plugin के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया.
वर्शन 1.3.0
- BidMachine Android अडैप्टर के वर्शन 3.5.0.0 के साथ काम करता है.
- BidMachine iOS अडैप्टर के वर्शन 3.5.0.0 के साथ काम करता है.
- Google Mobile Ads Flutter Plugin के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया.
वर्शन 1.2.0
- BidMachine Android अडैप्टर के वर्शन 3.5.0.0 के साथ काम करता है.
- BidMachine iOS अडैप्टर के वर्शन 3.4.0.2 के साथ काम करता है.
- Google Mobile Ads Flutter Plugin के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया.
वर्शन 1.1.0
- BidMachine Android अडैप्टर के वर्शन 3.4.0.0 के साथ काम करता है.
- BidMachine iOS अडैप्टर के वर्शन 3.4.0.1 के साथ काम करता है.
- Google Mobile Ads Flutter Plugin के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया.
वर्शन 1.0.0
- शुरुआती रिलीज़.
- BidMachine Android अडैप्टर के वर्शन 3.3.0.0 के साथ काम करता है.
- BidMachine iOS अडैप्टर के वर्शन 3.4.0.0 के साथ काम करता है.
- Google Mobile Ads Flutter Plugin के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया.