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

प्लैटफ़ॉर्म चुनें: Android (बीटा वर्शन) नई सुविधा Android iOS Unity Flutter

इस गाइड में, 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 डिप्लॉयमेंट का टारगेट 12.0 या इसके बाद का वर्शन होना चाहिए
  • Google Mobile Ads Flutter Plugin के साथ कॉन्फ़िगर किया गया ऐसा Flutter प्रोजेक्ट जिस पर काम किया जा सकता हो. ज़्यादा जानकारी के लिए, शुरू करें लेख पढ़ें.
  • मीडिएशन की प्रोसेस पूरी करें शुरुआती निर्देश

पहला चरण: Chartboost के यूआई में कॉन्फ़िगरेशन सेट अप करना

Chartboost खाते के लिए साइन अप करें. इसके बाद, खाते की पुष्टि हो जाने पर लॉग इन करें. इसके बाद, ऐप्लिकेशन मैनेजमेंट टैब पर जाएं.

Chartboost apps dashboard

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

Apps Management

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

New app form

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

Android

ऐप्लिकेशन सेटिंग

iOS

ऐप्लिकेशन सेटिंग

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

Chartboost mediation dashboard

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

Chartboost API Explorer

app-ads.txt फ़ाइल अपडेट करना

ऐप्लिकेशन के लिए, अनुमति वाले सेलर (app-ads.txt), IAB Tech Lab की एक पहल है. इसकी मदद से यह पक्का किया जा सकता है कि आपके ऐप्लिकेशन की विज्ञापन इन्वेंट्री सिर्फ़ वे चैनल बेचें जिन्हें आपने अनुमति दी है. विज्ञापन से मिलने वाले रेवेन्यू में ज़्यादा नुकसान न हो, इसके लिए आपको app-ads.txt फ़ाइल लागू करनी होगी. अगर आपने अब तक ऐसा नहीं किया है, तो अपने ऐप्लिकेशन के लिए app-ads.txt फ़ाइल सेट अप करें.

Chartboost के लिए app-ads.txt लागू करने के लिए, app-ads.txt देखें.

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

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

Android

Edit app settings

iOS

Edit app settings

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

Chartboost test mode

टेस्ट मोड चालू होने के बाद, पहले बनाए गए विज्ञापन यूनिट आईडी का इस्तेमाल करके विज्ञापनों का अनुरोध किया जा सकता है. इसके बाद, आपको 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 mediation प्लगिन में Chartboost.AddDataUseConsent() तरीका शामिल है. नीचे दिए गए सैंपल कोड में, डेटा इस्तेमाल करने की सहमति को NonBehavioral पर सेट किया गया है. अगर आपको इस तरीके का इस्तेमाल करना है, तो हमारा सुझाव है कि आप Google Mobile Ads Flutter Plugin का इस्तेमाल करके विज्ञापन अनुरोध करने से पहले ऐसा करें.

using GoogleMobileAds.Api.Mediation.Chartboost;
// ...

Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);

अमेरिका के राज्यों के निजता कानून

अमेरिका के राज्यों के निजता कानूनों के मुताबिक, उपयोगकर्ताओं को अपनी "निजी जानकारी" (जैसा कि कानून में परिभाषित है) की "बिक्री" से ऑप्ट आउट करने का अधिकार मिलना चाहिए. ऑप्ट आउट का विकल्प देने के लिए, "बिक्री करने वाले" पक्ष को अपने होम पेज पर "मेरी निजी जानकारी न बेचें" का लिंक प्रमुखता से दिखाना होगा. अमेरिका के राज्यों के निजता कानूनों का पालन करने से जुड़ी गाइड में, Google के विज्ञापन दिखाने के लिए सीमित डेटा प्रोसेसिंग मोड को चालू करने की सुविधा मिलती है. हालांकि, Google आपकी मीडिएशन चेन में मौजूद हर विज्ञापन नेटवर्क पर इस सेटिंग को लागू नहीं कर सकता. इसलिए, आपको मीडिएशन चेन में मौजूद हर उस विज्ञापन नेटवर्क कंपनी की पहचान करनी होगी जो निजी जानकारी की बिक्री में हिस्सा ले सकती है. साथ ही, आपको यह पक्का करने के लिए कि निजता कानून का पालन किया जा रहा है, उन सभी नेटवर्क से मिले दिशा-निर्देशों का पालन करना होगा.

Chartboost के वर्शन 3.1.0 के लिए Google Mobile Ads mediation प्लगिन में 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 के दस्तावेज़ पढ़ें.

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

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

पक्का करें कि आपने 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

वर्शन 1.3.2

वर्शन 1.3.1

वर्शन 1.3.0

वर्शन 1.2.1

वर्शन 1.2.0

वर्शन 1.1.0

वर्शन 1.0.2

वर्शन 1.0.1

वर्शन 1.0.0