इस पेज का अनुवाद Cloud Translation API से किया गया है.

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

इस गाइड में, Google Mobile Ads SDK टूल का इस्तेमाल करके, Chartboost से विज्ञापन लोड करने और दिखाने का तरीका बताया गया है. इसके लिए, AdMob मीडिएशन, वॉटरफ़ॉल इंटिग्रेशन का इस्तेमाल किया जाता है. इसमें, विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में Chartboost को जोड़ने का तरीका बताया गया है. साथ ही, Chartboost SDK टूल और अडैप्टर को Android ऐप्लिकेशन में इंटिग्रेट करने का तरीका भी बताया गया है.

इस्तेमाल किए जा सकने वाले इंटिग्रेशन और विज्ञापन फ़ॉर्मैट

Chartboost के लिए मीडिएशन अडैप्टर में ये सुविधाएं होती हैं:

इंटिग्रेशन
बिडिंग
झरना
फ़ॉर्मैट
बैनर
मध्यवर्ती
इनाम दिया गया
मूल भाषा वाला

ज़रूरी शर्तें

Android एपीआई लेवल 21 या उसके बाद का वर्शन

Google Mobile Ads SDK का सबसे नया वर्शन
मीडिएशन की प्रोसेस पूरी करें शुरुआती निर्देशों की गाइड

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

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

Chartboost ऐप्लिकेशन का डैशबोर्ड

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

ऐप्लिकेशन मैनेजमेंट

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

नए ऐप्लिकेशन का फ़ॉर्म

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

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

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

Chartboost मीडिएशन डैशबोर्ड

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

Chartboost API एक्सप्लोरर

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

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

ऐप्लिकेशन की सेटिंग में बदलाव करना

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

Chartboost टेस्ट मोड

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

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

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

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

आपको अपनी विज्ञापन यूनिट के लिए, मीडिएशन कॉन्फ़िगरेशन में Chartboost जोड़ना होगा.

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

नया मीडिएशन ग्रुप बनाने के लिए, मीडिएशन ग्रुप बनाएं को चुनें.

विज्ञापन फ़ॉर्मैट और प्लैटफ़ॉर्म डालें. इसके बाद, जारी रखें पर क्लिक करें.

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

इस मीडिएशन ग्रुप को अपनी एक या उससे ज़्यादा मौजूदा AdMob विज्ञापन यूनिट से जोड़ें. इसके बाद, हो गया पर क्लिक करें.

अब आपको विज्ञापन यूनिट कार्ड दिखेगा, जिसमें आपने जो विज्ञापन यूनिट चुनी हैं वे दिखेंगी:

Chartboost को विज्ञापन स्रोत के तौर पर जोड़ना

विज्ञापन स्रोत सेक्शन में, वॉटरफ़ॉल कार्ड में जाकर, विज्ञापन स्रोत जोड़ें को चुनें. इसके बाद, Chartboost चुनें.

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

अगर आपके पास पहले से ही Chartboost के लिए मैपिंग है, तो उसे चुना जा सकता है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें पर क्लिक करें.

इसके बाद, पिछले सेक्शन में मिले ऐप्लिकेशन आईडी, ऐप्लिकेशन हस्ताक्षर, और विज्ञापन की जगह डालें. इसके बाद, हो गया पर क्लिक करें.

Chartboost विज्ञापन दिखाने की जगहें (नाम वाली जगहें), आपके ऐप्लिकेशन में मौजूद उस जगह के नाम होते हैं जहां आपको विज्ञापन दिखाना है. AdMob, सेटिंग में बताई गई जगह पर अनुरोध भेजता है. अनुरोध भेजे जाने के बाद, Chartboost रिपोर्टिंग के मकसद से, जगह की जानकारी को अपने प्लैटफ़ॉर्म पर जोड़ देता है. उपयोगकर्ता, अपने गेम में विज्ञापन दिखाने की नई जगहों को Chartboost प्लैटफ़ॉर्म पर भी बना सकते हैं.

Chartboost के यूज़र इंटरफ़ेस (यूआई) में, ऐडवांस सेटिंग पर क्लिक करके, बुनियादी सेटिंग पेज पर विज्ञापन की जगहें देखी जा सकती हैं. ज़्यादा जानकारी के लिए, Chartboost की [Named Locations](//docs.chartboost.com/en/monetization/publishing/ad-locations/) वाली गाइड देखें.
Chartboost को विज्ञापन स्रोत के तौर पर जोड़ने के लिए, आखिर में हो गया पर क्लिक करें. इसके बाद, सेव करें पर क्लिक करें.

ध्यान दें: विज्ञापन स्रोत के ऑप्टिमाइज़ेशन में कुछ दिन लगते हैं, ताकि किसी मीडिएशन नेटवर्क के लिए eCPM का सटीक हिसाब लगाया जा सके. इस दौरान, विज्ञापन सोर्स के ऑप्टिमाइज़ेशन की स्थिति PENDING है. इसलिए, आपको नेटवर्क के लिए eCPM वैल्यू को मैन्युअल तरीके से सेट करना होगा. eCPM का हिसाब लगाने के बाद, विज्ञापन स्रोत आपकी ओर से eCPM को अपने-आप अपडेट करना शुरू कर देता है.

जीडीपीआर और अमेरिका के कानूनों के तहत विज्ञापन पार्टनर की सूची में Chartboost जोड़ें

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

तीसरा चरण: Chartboost SDK टूल और अडैप्टर इंपोर्ट करना

Android Studio इंटिग्रेशन (सुझाया गया)

प्रोजेक्ट-लेवल की settings.gradle.kts फ़ाइल में, ये रिपॉज़िटरी जोड़ें:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://cboost.jfrog.io/artifactory/chartboost-ads/")
    }
  }
}

इसके बाद, अपने ऐप्लिकेशन-लेवल की build.gradle.kts फ़ाइल में, लागू करने से जुड़ी ये डिपेंडेंसी और कॉन्फ़िगरेशन जोड़ें. Chartboost SDK टूल और अडैप्टर के सबसे नए वर्शन का इस्तेमाल करें:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:chartboost:9.8.0.0")
}

मैन्युअल इंटिग्रेशन

Maven Central से, Chartboost SDK टूल के सबसे नए वर्शन की .aar फ़ाइल डाउनलोड करें और उसे अपने प्रोजेक्ट में जोड़ें.
Google के Maven Repository पर, Chartboost अडैप्टर आर्टफ़ैक्ट पर जाएं. नया वर्शन चुनें, Chartboost एडेप्टर की .aar फ़ाइल डाउनलोड करें, और उसे अपने प्रोजेक्ट में जोड़ें.

चौथा चरण: Chartboost SDK टूल पर निजता सेटिंग लागू करना

ईयू (यूरोपीय संघ) की सहमति और जीडीपीआर

Google की ईयू उपयोगकर्ता की सहमति से जुड़ी नीति के तहत, आपको यह पक्का करना होगा कि डिवाइस आइडेंटिफ़ायर और निजी डेटा के इस्तेमाल के बारे में, यूरोपियन इकनॉमिक एरिया (ईईए) में रहने वाले उपयोगकर्ताओं को कुछ जानकारी दी गई हो और उनसे सहमति ली गई हो. इस नीति में, ईयू के ई-निजता निर्देश और जनरल डेटा प्रोटेक्शन रेगुलेशन (जीडीपीआर) की ज़रूरी शर्तों के बारे में बताया गया है. सहमति मांगते समय, आपको अपनी मीडिएशन चेन में मौजूद हर उस विज्ञापन नेटवर्क की पहचान करनी होगी जो निजी डेटा इकट्ठा कर सकता है, पा सकता है या इस्तेमाल कर सकता है. साथ ही, आपको हर नेटवर्क के इस्तेमाल के बारे में जानकारी देनी होगी. फ़िलहाल, Google ऐसे नेटवर्क पर उपयोगकर्ता की सहमति के विकल्प को अपने-आप पास नहीं कर सकता.

SDK टूल के 8.1.0 वर्शन में, Chartboost ने addDataUseConsent() तरीका जोड़ा है. यहां दिया गया सैंपल कोड, डेटा के इस्तेमाल की सहमति को NON_BEHAVIORAL पर सेट करता है. अगर आपको यह तरीका आज़माना है, तो हमारा सुझाव है कि आप Google Mobile Ads SDK टूल की मदद से विज्ञापनों का अनुरोध करने से पहले ऐसा करें.

Java

DataUseConsent dataUseConsent = new GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL);
Chartboost.addDataUseConsent(context, dataUseConsent);

Kotlin

val dataUseConsent = GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL)
Chartboost.addDataUseConsent(context, dataUseConsent)

ज़्यादा जानकारी और हर तरीके में दी जा सकने वाली वैल्यू के लिए, Chartboost का जीडीपीआर लेख और Android निजता के तरीके देखें.

अमेरिका के निजता कानून

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

SDK टूल के 8.1.0 वर्शन में, Chartboost ने addDataUseConsent() तरीका जोड़ा है. यहां दिया गया सैंपल कोड, डेटा के इस्तेमाल की सहमति को OPT_IN_SALE पर सेट करता है. अगर आपको यह तरीका आज़माना है, तो हमारा सुझाव है कि आप Google Mobile Ads SDK की मदद से विज्ञापनों का अनुरोध करने से पहले ऐसा करें.

Java

DataUseConsent dataUseConsent = new CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE);
Chartboost.addDataUseConsent(context, dataUseConsent);

Kotlin

val dataUseConsent = CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE)
Chartboost.addDataUseConsent(context, dataUseConsent)

ज़्यादा जानकारी और हर तरीके में दी जा सकने वाली वैल्यू के लिए, Chartboost का सीसीपीए लेख और Android निजता के तरीके देखें.

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

AndroidManifest में बदलाव करना

अन्य एलिमेंट

AndroidManifest.xml फ़ाइल में मौजूद हर उस गतिविधि में यह एट्रिब्यूट जोड़ें जो Chartboost विज्ञापन दिखाएगी और अलग-अलग ओरिएंटेशन (स्क्रीन की दिशा) के साथ काम करेगी:

android:configChanges="keyboardHidden|orientation|screenSize"

लाइफ़साइकल इवेंट

Chartboost के सुझाव के मुताबिक, अपनी गतिविधि के लाइफ़साइकल के उन सभी इवेंट में यह कोड जोड़ें जिनमें Chartboost के विज्ञापन दिखाए जाएंगे.

Java

import com.chartboost.sdk.Chartboost;
// ...

@Override
public void onBackPressed() {
    // If an interstitial is on screen, close it.
    if (Chartboost.onBackPressed()) {
        return;
    } else {
        super.onBackPressed();
    }
}

Kotlin

import com.chartboost.sdk.Chartboost
// ...

@Override
fun onBackPressed() {
    // If an interstitial is on screen, close it.
    if (Chartboost.onBackPressed())
        return
    else
        super.onBackPressed()
}

छठा चरण: लागू करने की जांच करना

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

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

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

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

वैकल्पिक चरण

अनुमतियां

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

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

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

अगर अडैप्टर को Chartboost से कोई विज्ञापन नहीं मिलता है, तो विज्ञापन के जवाब से जुड़ी गड़बड़ी की जानकारी देखी जा सकती है. इसके लिए, इन क्लास में ResponseInfo.getAdapterResponses() का इस्तेमाल करें:

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

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

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