इस गाइड में बताया गया है कि Google Mobile Ads Flutter Plugin के ज़रिए Chartboost से विज्ञापन लोड करने और दिखाने के लिए, मीडिएशन का इस्तेमाल कैसे किया जाता है. इसमें वॉटरफ़ॉल इंटिग्रेशन भी शामिल है. इसमें विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में Chartboost जोड़ने और Flutter ऐप्लिकेशन में Chartboost SDK और अडैप्टर को इंटिग्रेट करने का तरीका बताया गया है.
इस्तेमाल किए जा सकने वाले इंटिग्रेशन और विज्ञापन फ़ॉर्मैट
Chartboost के लिए AdMob मीडिएशन अडैप्टर में ये सुविधाएं उपलब्ध हैं:
| इंटिग्रेशन | |
|---|---|
| बिडिंग | |
| वॉटरफ़ॉल | |
| फ़ॉर्मैट | |
| बैनर वाले विज्ञापन | |
| इंटरस्टीशियल विज्ञापन | |
| इनाम वाले विज्ञापन | |
ज़रूरी शर्तें
- नवीनतम Google Mobile Ads Flutter Plugin
- Flutter 3.7.0 या इसके बाद का वर्शन
- Android पर डिप्लॉय करने के लिए
- Android का एपीआई लेवल 23 या इसके बाद का वर्शन
- iOS पर डिप्लॉय करने के लिए
- iOS डिप्लॉयमेंट का टारगेट 13.0 या इसके बाद का वर्शन होना चाहिए
- Google Mobile Ads Flutter Plugin के साथ कॉन्फ़िगर किया गया ऐसा Flutter प्रोजेक्ट जिस पर काम किया जा सकता हो. ज़्यादा जानकारी के लिए, सेट अप Google Mobile Ads Flutter Plugin लेख पढ़ें.
- AdMob मीडिएशन सेट अप करना
पहला चरण: Chartboost के यूआई में कॉन्फ़िगरेशन सेट अप करना
Chartboost खाते के लिए साइन अप करें. इसके बाद, खाते की पुष्टि हो जाने पर लॉग इन करें. इसके बाद, ऐप्लिकेशन मैनेजमेंट टैब पर जाएं.
अपना ऐप्लिकेशन बनाने के लिए, नया ऐप्लिकेशन जोड़ें बटन पर क्लिक करें.
फ़ॉर्म में बाकी जानकारी भरें. इसके बाद, अपने ऐप्लिकेशन को फ़ाइनल करने के लिए, ऐप्लिकेशन जोड़ें बटन पर क्लिक करें.
ऐप्लिकेशन बन जाने के बाद, आपको उसके डैशबोर्ड पर रीडायरेक्ट कर दिया जाएगा. अपने ऐप्लिकेशन के ऐप्लिकेशन आईडी और ऐप्लिकेशन के हस्ताक्षर को नोट करें.
Android
iOS
AdMob को AdMob विज्ञापन यूनिट आईडी सेट अप करने के लिए, Chartboost के यूज़र आईडी और उपयोगकर्ता के हस्ताक्षर की ज़रूरत होती है. इन पैरामीटर को Chartboost के यूज़र इंटरफ़ेस (यूआई) पर मौजूद Chartboost mediation पर क्लिक करके देखा जा सकता है.
संसाधन > एपीआई एक्सप्लोरर टैब पर जाएं. इसके बाद, पुष्टि करने वाले सेक्शन में मौजूद यूज़र आईडी और उपयोगकर्ता के हस्ताक्षर को नोट करें.
app-ads.txt फ़ाइल अपडेट करना
ऐप्लिकेशन के लिए, अनुमति वाले सेलर (app-ads.txt), IAB Tech Lab की एक पहल है. इसकी मदद से यह पक्का किया जा सकता है कि आपके ऐप्लिकेशन की विज्ञापन इन्वेंट्री सिर्फ़ वे चैनल बेचें जिन्हें आपने अनुमति दी है. विज्ञापन से मिलने वाले रेवेन्यू में ज़्यादा नुकसान न हो, इसके लिए आपको app-ads.txt फ़ाइल लागू करनी होगी.
अगर आपने अब तक ऐसा नहीं किया है, तो
अपने ऐप्लिकेशन के लिए app-ads.txt फ़ाइल सेट अप करें.
Chartboost के लिए app-ads.txt लागू करने के लिए, app-ads.txt देखें.
टेस्ट मोड को चालू करना
Chartboost यूज़र इंटरफ़ेस (यूआई) में ऐप्लिकेशन मैनेजमेंट टैब पर जाकर, अपने ऐप्लिकेशन पर टेस्ट मोड चालू किया जा सकता है. इसके लिए, सूची से अपना ऐप्लिकेशन चुनें और ऐप्लिकेशन की सेटिंग में बदलाव करें पर क्लिक करें.
Android
iOS
अपने ऐप्लिकेशन की सेटिंग में जाकर, टेस्ट मोड को चालू या बंद किया जा सकता है.
टेस्ट मोड चालू होने के बाद, पहले बनाए गए विज्ञापन यूनिट आईडी का इस्तेमाल करके विज्ञापनों का अनुरोध किया जा सकता है. इसके बाद, आपको Chartboost का टेस्ट विज्ञापन मिलेगा.
Chartboost के टेस्ट विज्ञापन मिलने के बाद, आपके ऐप्लिकेशन को Chartboost के पब्लिशर ऐप्लिकेशन की समीक्षा के लिए भेजा जाएगा. Chartboost पर वीडियो से कमाई करने की सुविधा काम करे, इसके लिए ज़रूरी है कि Chartboost, पब्लिशर ऐप्लिकेशन की समीक्षा को मंज़ूरी दे.
दूसरा चरण: AdMob के यूआई में Chartboost की डिमांड सेट अप करना
अपनी विज्ञापन यूनिट के लिए मीडिएशन सेटिंग कॉन्फ़िगर करना
Chartboost को जीडीपीआर और अमेरिका के राज्यों में लागू कानूनों के तहत विज्ञापन पार्टनरों की सूची में जोड़ना
AdMob के यूज़र इंटरफ़ेस (यूआई) में, यूरोप और अमेरिका के राज्यों के कानूनों के तहत विज्ञापन पार्टनर की सूची में Chartboost को जोड़ने के लिए, यहां दिया गया तरीका अपनाएं: यूरोपीय कानूनों की सेटिंग और अमेरिका के राज्यों के कानूनों की सेटिंग
तीसरा चरण: Chartboost SDK और अडैप्टर को इंपोर्ट करना
pub.dev के ज़रिए इंटिग्रेशन
अपने पैकेज की pubspec.yaml फ़ाइल में, Chartboost SDK और अडैप्टर के नए वर्शन के साथ यह डिपेंडेंसी जोड़ें:
dependencies:
gma_mediation_chartboost: ^1.4.1
मैन्युअल इंटिग्रेशन
Chartboost के लिए Google Mobile Ads मीडिएशन प्लगिन का नया वर्शन डाउनलोड करें. इसके बाद, डाउनलोड की गई फ़ाइल को एक्सट्रैक्ट करें. अब एक्सट्रैक्ट किए गए प्लगिन फ़ोल्डर
(और उसके कॉन्टेंट) को अपने Flutter प्रोजेक्ट में जोड़ें. इसके बाद, अपनी pubspec.yaml फ़ाइल में प्लगिन का रेफ़रंस दें. इसके लिए, यह डिपेंडेंसी जोड़ें:
dependencies:
gma_mediation_chartboost:
path: path/to/local/package
चौथा चरण: Chartboost SDK पर निजता सेटिंग लागू करना
ईयू उपयोगकर्ता की सहमति से जुड़ी नीति और जीडीपीआर
Google की ईयू उपयोगकर्ता की सहमति से जुड़ी नीति का पालन करने के लिए, आपको यूरोपियन इकनॉमिक एरिया (ईईए), यूके, और स्विट्ज़रलैंड में मौजूद उपयोगकर्ताओं को कुछ जानकारी देनी होगी. साथ ही, आपको कानूनी तौर पर ज़रूरी होने पर, कुकी या अन्य लोकल स्टोरेज का इस्तेमाल करने के लिए उनकी सहमति लेनी होगी. इसके अलावा, आपको विज्ञापन को ज़्यादा काम का बनाने के लिए, निजी डेटा को इकट्ठा करने, शेयर करने, और इस्तेमाल करने के लिए भी उनकी सहमति लेनी होगी. इस नीति में, ईयू के ई-निजता निर्देश और जनरल डेटा प्रोटेक्शन रेगुलेशन (जीडीपीआर) की ज़रूरी शर्तों के बारे में बताया गया है. यह आपकी ज़िम्मेदारी है कि सहमति की जानकारी, आपकी मीडिएशन चेन में मौजूद हर विज्ञापन सोर्स को भेजी जाए. Google, उपयोगकर्ता की सहमति के विकल्प को ऐसे नेटवर्क पर अपने-आप नहीं भेज सकता.
Chartboost के लिए Google Mobile Ads मीडिएशन प्लगिन के वर्शन 3.1.0 में, Chartboost.AddDataUseConsent() तरीका शामिल है. नीचे दिए गए सैंपल कोड में, डेटा इस्तेमाल करने की सहमति को NonBehavioral पर सेट किया गया है. अगर आपको इस तरीके का इस्तेमाल करना है, तो हमारा सुझाव है कि
का इस्तेमाल करके विज्ञापनों का अनुरोध करने से पहले ऐसा करें.Google Mobile Ads Flutter Plugin
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);
अमेरिका के राज्यों के निजता कानून
अमेरिका के राज्यों के निजता कानूनों के मुताबिक, उपयोगकर्ताओं को अपनी "निजी जानकारी" (जैसा कि कानून में परिभाषित है) की "बिक्री" से ऑप्ट आउट करने का अधिकार मिलना चाहिए. ऑप्ट आउट का विकल्प देने के लिए, "बिक्री करने वाले" पक्ष को अपने होम पेज पर "मेरी निजी जानकारी न बेचें" का लिंक प्रमुखता से दिखाना होगा. अमेरिका के राज्यों के निजता कानूनों का पालन करने से जुड़ी गाइड में, Google के विज्ञापन दिखाने के लिए सीमित डेटा प्रोसेसिंग मोड को चालू करने की सुविधा मिलती है. हालांकि, Google आपकी मीडिएशन चेन में मौजूद हर विज्ञापन नेटवर्क पर इस सेटिंग को लागू नहीं कर सकता. इसलिए, आपको मीडिएशन चेन में मौजूद हर उस विज्ञापन नेटवर्क कंपनी की पहचान करनी होगी जो निजी जानकारी की बिक्री में हिस्सा ले सकती है. साथ ही, आपको यह पक्का करने के लिए कि निजता कानून का पालन किया जा रहा है, उन सभी नेटवर्क से मिले दिशा-निर्देशों का पालन करना होगा.
Chartboost के लिए Google Mobile Ads मीडिएशन प्लगिन के वर्शन 3.1.0 में, Chartboost.AddDataUseConsent() तरीका शामिल है. नीचे दिए गए सैंपल कोड में, डेटा इस्तेमाल करने की सहमति को OptInSale पर सेट किया गया है. अगर आपको इस तरीके का इस्तेमाल करना है, तो हमारा सुझाव है कि
का इस्तेमाल करके विज्ञापनों का अनुरोध करने से पहले ऐसा करें.Google Mobile Ads Flutter Plugin
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);
पांचवा चरण: ज़रूरी कोड जोड़ना
Android
Chartboost इंटिग्रेशन के लिए, किसी और कोड की ज़रूरत नहीं है.
iOS
SKAdNetwork इंटिग्रेशन
अपने प्रोजेक्ट की Info.plist फ़ाइल में SKAdNetwork आइडेंटिफ़ायर जोड़ने के लिए, Chartboost's
documentation
के दस्तावेज़ पढ़ें.
छठा चरण: लागू किए गए बदलावों की जांच करना
टेस्ट विज्ञापनों को चालू करना
पक्का करें कि आपने AdMob के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो. साथ ही, Chartboost यूज़र इंटरफ़ेस (यूआई) में टेस्ट मोड चालू किया हो.
टेस्ट विज्ञापनों की पुष्टि करना
यह पुष्टि करने के लिए कि आपको Chartboost से टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन जांचने वाले टूल में Chartboost (वॉटरफ़ॉल) विज्ञापन सोर्स का इस्तेमाल करके, विज्ञापन के किसी एक सोर्स को टेस्ट करना चालू करें.
वैकल्पिक चरण
Android
अनुमतियां
Chartboost, बेहतर परफ़ॉर्मेंस के लिए, आपके ऐप्लिकेशन की AndroidManifest.xml फ़ाइल में ये वैकल्पिक अनुमतियां जोड़ने का सुझाव देता है:
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
iOS
iOS इंटिग्रेशन के लिए, किसी और चरण को पूरा करने की ज़रूरत नहीं है.
गड़बड़ी के कोड
अगर अडैप्टर को Chartboost से विज्ञापन नहीं मिलता है,
तो पब्लिशर, विज्ञापन के जवाब में हुई गड़बड़ी की जानकारी देखने के लिए,
ResponseInfo इनमें से किसी क्लास के हिसाब से इस्तेमाल कर सकते हैं:
Android
com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter
iOS
GADMAdapterChartboost
GADMediationAdapterChartboost
विज्ञापन लोड न होने पर, Chartboost अडैप्टर से मिलने वाले कोड और उनसे जुड़े मैसेज यहां दिए गए हैं:
Android
| गड़बड़ी का कोड | कारण |
|---|---|
| 0-99 | Chartboost SDK से गड़बड़ी का मैसेज मिला. |
| 101 | विज्ञापन का अनुरोध किया गया साइज़, Chartboost के साथ काम करने वाले बैनर के साइज़ से मेल नहीं खाता. |
| 102 | Chartboost, एक बार में एक जगह के लिए सिर्फ़ एक विज्ञापन लोड कर सकता है. |
| 103 | AdMob के यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए Chartboost सर्वर पैरामीटर मौजूद नहीं हैं या मान्य नहीं हैं. |
| 104 | Chartboost का इंटरस्टीशियल या इनाम वाला विज्ञापन दिखाने के लिए तैयार नहीं है. |
iOS
| गड़बड़ी का कोड | वजह |
|---|---|
| 101 | AdMob के यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए Chartboost सर्वर पैरामीटर मौजूद नहीं हैं या मान्य नहीं हैं. |
| 102 | शुरू करने के दौरान, Chartboost SDK टूल से गड़बड़ी का मैसेज मिला. |
| 103 | विज्ञापन दिखाने के समय, Chartboost विज्ञापन को कैश मेमोरी में सेव नहीं किया जाता. |
| 104 | विज्ञापन का अनुरोध किया गया साइज़, Chartboost के साथ काम करने वाले बैनर के साइज़ से मेल नहीं खाता. |
| 105 | डिवाइस के ओएस का वर्शन, Chartboost SDK के साथ काम करने वाले ओएस के सबसे पुराने वर्शन से पहले का है. |
| 200-299 | Chartboost SDK टूल की कैश मेमोरी से जुड़ी गड़बड़ियां. ज़्यादा जानकारी के लिए, कोड देखें. |
| 300-399 | Chartboost SDK में गड़बड़ियां दिख रही हैं. ज़्यादा जानकारी के लिए, कोड देखें. |
| 400-499 | Chartboost SDK में क्लिक से जुड़ी गड़बड़ियां. ज़्यादा जानकारी के लिए, कोड देखें. |
Chartboost Flutter Mediation Adapter के बदलावों का लॉग
वर्शन 1.4.2 (डेवलेपमेंट में है)
- Flutter के ज़रूरी वर्शन को 3.38.1 पर अपडेट किया गया
- Google Mobile Ads Flutter Plugin के वर्शन 8.0.0 के साथ काम करने के लिए अपडेट किया गया
वर्शन 1.4.1
- Chartboost Android अडैप्टर के वर्शन 9.11.1.0 के साथ काम करता है.
- Chartboost iOS अडैप्टर के वर्शन 9.11.0.3 के साथ काम करता है.
- Google Mobile Ads Flutter Plugin के वर्शन 7.0.0 के साथ बनाया और टेस्ट किया गया.
वर्शन 1.4.0
- Flutter के ज़रूरी वर्शन को 3.35.1 पर अपडेट किया गया
- Google Mobile Ads Flutter Plugin के वर्शन 7.0.0 के साथ काम करने के लिए अपडेट किया गया
- Chartboost Android अडैप्टर के वर्शन 9.11.0.1 के साथ काम करता है.
- Chartboost iOS अडैप्टर के वर्शन 9.11.0.1 के साथ काम करता है.
- Google Mobile Ads Flutter Plugin के वर्शन 7.0.0 के साथ बनाया और टेस्ट किया गया.
वर्शन 1.3.3
- Chartboost Android अडैप्टर के वर्शन 9.10.2.0 के साथ काम करता है.
- Chartboost iOS अडैप्टर के वर्शन 9.10.1.0 के साथ काम करता है.
- Google Mobile Ads Flutter Plugin के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया.
वर्शन 1.3.2
- Chartboost Android अडैप्टर के वर्शन 9.10.1.0 के साथ काम करता है.
- Chartboost iOS अडैप्टर के वर्शन 9.10.1.0 के साथ काम करता है.
- Google Mobile Ads Flutter Plugin के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया.
वर्शन 1.3.1
- Chartboost Android अडैप्टर के वर्शन 9.10.0.1 के साथ काम करता है.
- Chartboost iOS अडैप्टर के वर्शन 9.10.0.0 के साथ काम करता है.
- Google Mobile Ads Flutter Plugin के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया.
वर्शन 1.3.0
- Chartboost Android अडैप्टर के वर्शन 9.10.0.0 के साथ काम करता है.
- Chartboost iOS अडैप्टर के वर्शन 9.10.0.0 के साथ काम करता है.
- Google Mobile Ads Flutter Plugin के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया.
वर्शन 1.2.1
- Chartboost Android अडैप्टर के वर्शन 9.9.2.0 के साथ काम करता है.
- Chartboost iOS अडैप्टर के वर्शन 9.9.2.0 के साथ काम करता है.
- Google Mobile Ads Flutter Plugin के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया.
वर्शन 1.2.0
- Chartboost Android अडैप्टर के वर्शन 9.9.0.0 के साथ काम करता है.
- Chartboost iOS अडैप्टर के वर्शन 9.9.1.0 के साथ काम करता है.
- Google Mobile Ads Flutter Plugin के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया.
वर्शन 1.1.0
- Chartboost Android अडैप्टर के वर्शन 9.8.3.1 के साथ काम करता है.
- Chartboost iOS अडैप्टर के वर्शन 9.9.0.0 के साथ काम करता है.
- Google Mobile Ads Flutter Plugin के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया.
वर्शन 1.0.2
- Chartboost Android अडैप्टर के वर्शन 9.8.3.1 के साथ काम करता है.
- Chartboost iOS अडैप्टर के वर्शन 9.8.1.0 के साथ काम करता है.
- Google Mobile Ads Flutter Plugin के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया.
वर्शन 1.0.1
- Chartboost Android अडैप्टर के वर्शन 9.8.3.0 के साथ काम करता है.
- Chartboost iOS अडैप्टर के वर्शन 9.8.1.0 के साथ काम करता है.
- Google Mobile Ads Flutter Plugin के वर्शन 5.3.1 के साथ बनाया और टेस्ट किया गया.
वर्शन 1.0.0
- शुरुआती रिलीज़.
- Chartboost Android अडैप्टर के वर्शन 9.8.1.0 के साथ काम करता है.
- Chartboost iOS अडैप्टर के वर्शन 9.8.0.0 के साथ काम करता है.
- Google Mobile Ads Flutter Plugin के वर्शन 5.2.0 के साथ बनाया और टेस्ट किया गया.