इस गाइड में, मीडिएशन का इस्तेमाल करके, Chartboost से विज्ञापन लोड करने और दिखाने के लिए, Google Mobile Ads SDK का इस्तेमाल करने का तरीका बताया गया है. इसमें वॉटरफ़ॉल इंटिग्रेशन के बारे में भी बताया गया है. इसमें, विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में Chartboost को जोड़ने का तरीका बताया गया है. साथ ही, Chartboost SDK टूल और अडैप्टर को Flutter ऐप्लिकेशन में इंटिग्रेट करने का तरीका भी बताया गया है.
इस्तेमाल किए जा सकने वाले इंटिग्रेशन और विज्ञापन फ़ॉर्मैट
Chartboost के लिए AdMob मीडिएशन अडैप्टर में ये सुविधाएं हैं:
इंटिग्रेशन | |
---|---|
बिडिंग | |
झरना | |
फ़ॉर्मैट | |
बैनर | |
मध्यवर्ती | |
इनाम दिया गया |
ज़रूरी शर्तें
- Google Mobile Ads SDK का सबसे नया वर्शन
- Flutter 3.7.0 या इसके बाद का वर्शन
- Android पर डिप्लॉय करने के लिए
- Android एपीआई लेवल 21 या उसके बाद का वर्शन
- iOS पर डिप्लॉय करने के लिए
- iOS डिप्लॉयमेंट टारगेट 12.0 या उसके बाद का होना चाहिए
- Google Mobile Ads SDK के साथ कॉन्फ़िगर किया गया, काम करने वाला Flutter प्रोजेक्ट. ज़्यादा जानकारी के लिए, शुरू करें देखें.
- मीडिएशन के लिए, शुरू करने की गाइड को पूरा करें
पहला चरण: Chartboost के यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगरेशन सेट अप करना
Chartboost खाते के लिए साइन अप करें और खाते की पुष्टि होने के बाद, लॉग इन करें. इसके बाद, ऐप्लिकेशन मैनेजमेंट टैब पर जाएं.
अपना ऐप्लिकेशन बनाने के लिए, नया ऐप्लिकेशन जोड़ें बटन पर क्लिक करें.
बाकी का फ़ॉर्म भरें और ऐप्लिकेशन को स्वीकार कराने के लिए, ऐप्लिकेशन जोड़ें बटन पर क्लिक करें.
ऐप्लिकेशन बन जाने के बाद, आपको उसके डैशबोर्ड पर भेज दिया जाएगा. अपने ऐप्लिकेशन के ऐप्लिकेशन आईडी और ऐप्लिकेशन हस्ताक्षर को नोट करें.
Android
iOS
AdMob विज्ञापन यूनिट आईडी सेट अप करने के लिए, AdMob को Chartboost उपयोगकर्ता आईडी और उपयोगकर्ता हस्ताक्षर की ज़रूरत होती है. Chartboost के यूज़र इंटरफ़ेस (यूआई) पर, Chartboost मीडिएशन पर क्लिक करके, ये पैरामीटर देखे जा सकते हैं.
संसाधन > एपीआई एक्सप्लोरर टैब पर जाएं और पुष्टि सेक्शन में मौजूद अपने उपयोगकर्ता आईडी और उपयोगकर्ता हस्ताक्षर को नोट करें.
टेस्ट मोड चालू करना
अपने ऐप्लिकेशन पर टेस्ट मोड चालू करने के लिए, 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.0.0
मैन्युअल इंटिग्रेशन
Chartboost के लिए, Google Mobile Ads मीडिएशन प्लगिन का नया वर्शन डाउनलोड करें. इसके बाद, डाउनलोड की गई फ़ाइल को निकालें और निकाले गए प्लगिन फ़ोल्डर (और उसके कॉन्टेंट) को अपने 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.0.0
- शुरुआती रिलीज़.
- Chartboost के Android अडैप्टर के 9.8.1.0 वर्शन के साथ काम करने की पुष्टि की गई है
- Chartboost iOS अडैप्टर के 9.8.0.0 वर्शन के साथ काम करने की पुष्टि की गई है
- Google Mobile Ads Flutter प्लग इन के 5.2.0 वर्शन के साथ बनाया और टेस्ट किया गया.