Chartboost को मीडिएशन के साथ इंटिग्रेट करना

इस गाइड में, मीडिएशन का इस्तेमाल करके 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 खाते के लिए साइन अप करें और खाते की पुष्टि होने के बाद, लॉग इन करें. इसके बाद, ऐप्लिकेशन मैनेजमेंट टैब पर जाएं.

अपना ऐप्लिकेशन बनाने के लिए, नया ऐप्लिकेशन जोड़ें बटन पर क्लिक करें.

बाकी फ़ॉर्म भरें और ऐप्लिकेशन को स्वीकार कराने के लिए, ऐप्लिकेशन जोड़ें बटन पर क्लिक करें.

ऐप्लिकेशन बन जाने के बाद, आपको उसके डैशबोर्ड पर भेज दिया जाएगा. अपने ऐप्लिकेशन के ऐप्लिकेशन आईडी और ऐप्लिकेशन हस्ताक्षर को नोट करें.

ध्यान दें: अपने ऐप्लिकेशन के डैशबोर्ड पर जाने के लिए, पहले दिखाए गए ऐप्लिकेशन मैनेजमेंट टैब पर जाएं और अपना ऐप्लिकेशन चुनें.

AndroidiOS

AdMob विज्ञापन यूनिट आईडी सेट अप करने के लिए, AdMob को Chartboost उपयोगकर्ता आईडी और उपयोगकर्ता हस्ताक्षर की ज़रूरत होती है. Chartboost के यूज़र इंटरफ़ेस (यूआई) पर, Chartboost मीडिएशन पर क्लिक करके, ये पैरामीटर देखे जा सकते हैं.

संसाधन > एपीआई एक्सप्लोरर टैब पर जाएं और पुष्टि सेक्शन में मौजूद अपने उपयोगकर्ता आईडी और उपयोगकर्ता हस्ताक्षर को नोट करें.

टेस्ट मोड चालू करना

अपने ऐप्लिकेशन पर टेस्ट मोड चालू करने के लिए, Chartboost यूज़र इंटरफ़ेस (यूआई) में ऐप्लिकेशन मैनेजमेंट टैब पर जाएं. इसके बाद, सूची से अपना ऐप्लिकेशन चुनें और ऐप्लिकेशन की सेटिंग में बदलाव करें पर क्लिक करें.

AndroidiOS

ऐप्लिकेशन की सेटिंग में जाकर, टेस्ट मोड को टॉगल किया जा सकता है.

टेस्ट मोड चालू होने के बाद, पहले से बनाए गए विज्ञापन यूनिट आईडी का इस्तेमाल करके विज्ञापनों का अनुरोध किया जा सकता है. साथ ही, Chartboost का टेस्ट विज्ञापन भी मिल सकता है.

Chartboost के टेस्ट विज्ञापन मिलने के बाद, आपके ऐप्लिकेशन को Chartboost के पब्लिशर ऐप्लिकेशन की समीक्षा में शामिल किया जाएगा. Chartboost पर कमाई करने के लिए, पब्लिशर ऐप्लिकेशन की समीक्षा को Chartboost से मंज़ूरी लेनी होगी.

दूसरा चरण: AdMob यूज़र इंटरफ़ेस (यूआई) में Chartboost की मांग सेट अप करना

अपनी विज्ञापन यूनिट के लिए मीडिएशन सेटिंग कॉन्फ़िगर करना

AndroidiOS

निर्देशों के लिए, Android के लिए बनी गाइड में दूसरा चरण देखें.

निर्देशों के लिए, 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);

पांचवां चरण: ज़रूरी कोड जोड़ना

AndroidiOS

Chartboost इंटिग्रेशन के लिए, किसी अन्य कोड की ज़रूरत नहीं होती.

SKAdNetwork इंटिग्रेशन

अपने प्रोजेक्ट की Info.plist फ़ाइल में SKAdNetwork आइडेंटिफ़ायर जोड़ने के लिए, Chartboost के दस्तावेज़ का पालन करें.

छठा चरण: लागू किए गए बदलावों की जांच करना

टेस्ट विज्ञापन चालू करना

पक्का करें कि आपने AdMob के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो. साथ ही, Chartboost के यूज़र इंटरफ़ेस (यूआई) में, टेस्ट मोड चालू किया हो.

अहम जानकारी: ऐप्लिकेशन को रिलीज़ करने से पहले, AdMob और Chartboost के लिए टेस्ट मोड बंद करें.

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

यह पुष्टि करने के लिए कि आपको Chartboost से टेस्ट विज्ञापन मिल रहे हैं, Chartboost (वॉटरफ़ॉल) विज्ञापन स्रोत का इस्तेमाल करके, विज्ञापन जांचने वाले टूल में विज्ञापन के किसी एक सोर्स को टेस्ट करने की सुविधा चालू करें.

वैकल्पिक चरण

AndroidiOS

अनुमतियां

बेहतर परफ़ॉर्मेंस के लिए, Chartboost का सुझाव है कि आप अपने ऐप्लिकेशन की AndroidManifest.xml फ़ाइल में, ये वैकल्पिक अनुमतियां जोड़ें:

<uses-permission android:name="android.permission.READ_PHONE_STATE" />

iOS इंटिग्रेशन के लिए, आपको कोई और चरण पूरा करने की ज़रूरत नहीं है.

गड़बड़ी के कोड

अगर अडैप्टर को Chartboost से विज्ञापन नहीं मिलता है, तो पब्लिशर इन क्लास के तहत ResponseInfo का इस्तेमाल करके, विज्ञापन रिस्पॉन्स से जुड़ी गड़बड़ी की जांच कर सकते हैं:

AndroidiOS

com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter

GADMAdapterChartboost
GADMediationAdapterChartboost

जब कोई विज्ञापन लोड नहीं होता है, तो Chartboost अडैप्टर से ये कोड और मैसेज मिलते हैं:

AndroidiOS

गड़बड़ी का कोड	कारण
0-99	Chartboost SDK टूल से गड़बड़ी का मैसेज मिला.
101	अनुरोध किया गया विज्ञापन साइज़, Chartboost के साथ काम करने वाले बैनर साइज़ से मेल नहीं खाता.
102	Chartboost, एक बार में हर जगह सिर्फ़ एक विज्ञापन लोड कर सकता है.
103	AdMob यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए Chartboost सर्वर पैरामीटर मौजूद नहीं हैं या अमान्य हैं.
104	Chartboost का इंटरस्टीशियल या इनाम वाला विज्ञापन दिखाने के लिए तैयार नहीं है.

गड़बड़ी का कोड	कारण
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 वर्शन के साथ बनाया और टेस्ट किया गया.