इस गाइड में, मीडिएशन का इस्तेमाल करके, Chartboost से विज्ञापन लोड करने और उन्हें दिखाने के लिए Google Mobile Ads SDK का इस्तेमाल करने का तरीका बताया गया है. इसमें वॉटरफ़ॉल इंटिग्रेशन के बारे में भी बताया गया है. इसमें बताया गया है कि किसी विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में Chartboost को कैसे जोड़ा जाता है. साथ ही, किसी Flutter ऐप्लिकेशन में Chartboost SDK और अडैप्टर को कैसे इंटिग्रेट किया जाता है.
उपलब्ध इंटिग्रेशन और विज्ञापन फ़ॉर्मैट
Chartboost के लिए AdMob मीडिएशन अडैप्टर में ये सुविधाएं उपलब्ध हैं:
| इंटिग्रेशन | |
|---|---|
| बिडिंग | |
| वॉटरफ़ॉल | |
| फ़ॉर्मैट | |
| बैनर | |
| इंटरस्टीशियल विज्ञापन | |
| इनाम दिया गया | |
ज़रूरी शर्तें
- Google Mobile Ads SDK पर अपलोड हुआ नया वीडियो
- Flutter 3.7.0 या इसके बाद का वर्शन
- Android पर डिप्लॉय करने के लिए
- Android का एपीआई लेवल 23 या इसके बाद का वर्शन
- iOS पर डिप्लॉय करने के लिए
- iOS डिप्लॉयमेंट का टारगेट 12.0 या इससे ज़्यादा होना चाहिए
- Google Mobile Ads SDK के साथ कॉन्फ़िगर किया गया ऐसा Flutter प्रोजेक्ट जिस पर काम किया जा सकता हो. ज़्यादा जानकारी के लिए, शुरू करें लेख पढ़ें.
- मीडिएशन की प्रोसेस पूरी करें शुरुआती निर्देश
पहला चरण: Chartboost के यूआई में कॉन्फ़िगरेशन सेट अप करना
Chartboost खाते के लिए साइन अप करें. इसके बाद, खाते की पुष्टि हो जाने पर लॉग इन करें. इसके बाद, ऐप्लिकेशन मैनेजमेंट टैब पर जाएं.
अपना ऐप्लिकेशन बनाने के लिए, नया ऐप्लिकेशन जोड़ें बटन पर क्लिक करें.
फ़ॉर्म के बाकी हिस्से को भरें. इसके बाद, अपने ऐप्लिकेशन को फ़ाइनल करने के लिए, ऐप्लिकेशन जोड़ें बटन पर क्लिक करें.
ऐप्लिकेशन बन जाने के बाद, आपको उसके डैशबोर्ड पर भेज दिया जाएगा. अपने ऐप्लिकेशन के ऐप्लिकेशन आईडी और ऐप्लिकेशन के हस्ताक्षर को नोट करें.
Android
iOS
AdMob को आपके AdMob विज्ञापन यूनिट आईडी को सेट अप करने के लिए, Chartboost के उपयोगकर्ता आईडी और उपयोगकर्ता के हस्ताक्षर की ज़रूरत होती है. Chartboost के यूज़र इंटरफ़ेस (यूआई) पर, Chartboost mediation पर क्लिक करके, इन पैरामीटर को देखा जा सकता है.
संसाधन > एपीआई एक्सप्लोरर टैब पर जाएं. इसके बाद, Authentication सेक्शन में मौजूद User ID और User Signature को नोट करें.
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 की डिमांड सेट अप करना
अपनी विज्ञापन यूनिट के लिए मीडिएशन की सेटिंग कॉन्फ़िगर करना
Android
निर्देशों के लिए, Android के लिए गाइड में दिया गया दूसरा चरण देखें.
iOS
निर्देशों के लिए, iOS के लिए गाइड में दिया गया दूसरा चरण देखें.
Chartboost को जीडीपीआर और अमेरिका के राज्यों में लागू कानूनों के तहत विज्ञापन पार्टनरों की सूची में जोड़ना
AdMob के यूज़र इंटरफ़ेस (यूआई) में, यूरोप और अमेरिका के राज्यों में लागू कानूनों के तहत विज्ञापन पार्टनरों की सूची में Chartboost को जोड़ें. इसके लिए, यूरोपीय कानूनों से जुड़ी सेटिंग और अमेरिका के राज्यों में लागू कानूनों से जुड़ी सेटिंग में दिए गए तरीकों का पालन करें.
तीसरा चरण: Chartboost SDK और अडैप्टर को इंपोर्ट करना
pub.dev के ज़रिए इंटिग्रेशन
अपने पैकेज की pubspec.yaml फ़ाइल में, Chartboost SDK और अडैप्टर के नए वर्शन के साथ यह डिपेंडेंसी जोड़ें:
dependencies:
gma_mediation_chartboost: ^1.3.3
मैन्युअल इंटिग्रेशन
Chartboost के लिए, Google Mobile Ads mediation प्लगिन का नया वर्शन डाउनलोड करें. इसके बाद, डाउनलोड की गई फ़ाइल को निकालें और निकाले गए प्लगिन फ़ोल्डर (और उसके कॉन्टेंट) को अपने Flutter प्रोजेक्ट में जोड़ें. इसके बाद, अपनी pubspec.yaml फ़ाइल में प्लगिन का रेफ़रंस दें. इसके लिए, यह डिपेंडेंसी जोड़ें:
dependencies:
gma_mediation_chartboost:
path: path/to/local/package
चौथा चरण: Chartboost SDK पर निजता सेटिंग लागू करना
ईयू उपयोगकर्ता की सहमति से जुड़ी नीति और जीडीपीआर
Google की ईयू उपयोगकर्ता की सहमति से जुड़ी नीति का पालन करने के लिए, आपको यूरोपियन इकनॉमिक एरिया (ईईए), यूके, और स्विट्ज़रलैंड में मौजूद उपयोगकर्ताओं को कुछ जानकारी देनी होगी. साथ ही, आपको कानूनी तौर पर ज़रूरी होने पर, कुकी या अन्य लोकल स्टोरेज का इस्तेमाल करने के लिए उनकी सहमति लेनी होगी. इसके अलावा, आपको विज्ञापन को ज़्यादा काम का बनाने के लिए, निजी डेटा को इकट्ठा करने, शेयर करने, और इस्तेमाल करने के लिए भी उनकी सहमति लेनी होगी. इस नीति में, ईयू के ई-निजता निर्देश और जनरल डेटा प्रोटेक्शन रेगुलेशन (जीडीपीआर) की ज़रूरी शर्तों के बारे में बताया गया है. यह आपकी ज़िम्मेदारी है कि सहमति की जानकारी, आपकी मीडिएशन चेन में मौजूद हर विज्ञापन सोर्स को भेजी जाए. Google, उपयोगकर्ता की सहमति से जुड़े विकल्प को ऐसे नेटवर्क पर अपने-आप नहीं भेज सकता.
Chartboost के वर्शन 3.1.0 के लिए Google Mobile Ads मीडिएशन प्लगिन में Chartboost.AddDataUseConsent() तरीका शामिल है. नीचे दिए गए सैंपल कोड में, डेटा इस्तेमाल करने की सहमति को NonBehavioral पर सेट किया गया है. अगर आपको इस तरीके का इस्तेमाल करना है, तो हमारा सुझाव है कि आप Google Mobile Ads SDK का इस्तेमाल करके विज्ञापन अनुरोध करने से पहले ऐसा करें.
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);
अमेरिका के राज्यों के निजता कानून
अमेरिका के राज्यों के निजता कानूनों के मुताबिक, उपयोगकर्ताओं को अपनी "निजी जानकारी" (जैसा कि कानून में परिभाषित है) की "बिक्री" से ऑप्ट आउट करने का अधिकार मिलना चाहिए. ऑप्ट आउट का विकल्प देने के लिए, "बिक्री करने वाले" पक्ष को अपने होम पेज पर "मेरी निजी जानकारी न बेचें" का लिंक प्रमुखता से दिखाना होगा. अमेरिका के राज्यों के निजता कानूनों का पालन करने से जुड़ी गाइड में, Google के विज्ञापन दिखाने के लिए सीमित डेटा प्रोसेसिंग मोड को चालू करने की सुविधा मिलती है. हालांकि, Google आपकी मीडिएशन चेन में मौजूद हर विज्ञापन नेटवर्क पर इस सेटिंग को लागू नहीं कर सकता. इसलिए, आपको मीडिएशन चेन में मौजूद हर उस विज्ञापन नेटवर्क कंपनी की पहचान करनी होगी जो निजी जानकारी की बिक्री में हिस्सा ले सकती है. साथ ही, आपको यह पक्का करने के लिए कि वह कंपनी कानून का पालन कर रही है, उन सभी नेटवर्क से मिले दिशा-निर्देशों का पालन करना होगा.
Chartboost के वर्शन 3.1.0 के लिए Google Mobile Ads मीडिएशन प्लगिन में Chartboost.AddDataUseConsent() तरीका शामिल है. नीचे दिए गए सैंपल कोड में, डेटा इस्तेमाल करने की सहमति को OptInSale पर सेट किया गया है. अगर आपको इस तरीके का इस्तेमाल करना है, तो हमारा सुझाव है कि आप Google Mobile Ads SDK का इस्तेमाल करके विज्ञापन अनुरोध करने से पहले ऐसा करें.
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);
पांचवां चरण: ज़रूरी कोड जोड़ना
Android
Chartboost इंटिग्रेशन के लिए, किसी अन्य कोड की ज़रूरत नहीं होती.
iOS
SKAdNetwork इंटिग्रेशन
अपने प्रोजेक्ट की Info.plist फ़ाइल में SKAdNetwork आइडेंटिफ़ायर जोड़ने के लिए, Chartboost के दस्तावेज़ पढ़ें.
छठा चरण: लागू किए गए बदलावों की जांच करना
टेस्ट विज्ञापनों को चालू करना
पक्का करें कि आपने 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.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 adapter 9.8.3.1 के साथ काम करता है.
- Chartboost iOS अडैप्टर के 9.9.0.0 वर्शन के साथ काम करता है.
- इसे Google Mobile Ads Flutter Plugin के वर्शन 6.0.0 के साथ बनाया और टेस्ट किया गया है.
वर्शन 1.0.2
- Chartboost Android adapter 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 के साथ बनाया और टेस्ट किया गया है.