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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Chartboost का टेस्ट मोड

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

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

दूसरा चरण: Ad Manager के यूज़र इंटरफ़ेस में Chartboost की मांग सेट अप करना

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

अपने Ad Manager खाते में साइन इन करें.

डिलीवरी > यील्ड ग्रुप पर जाएं और नया यील्ड ग्रुप बटन पर क्लिक करें.

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

इसके बाद, YielPartner जोड़ें बटन पर क्लिक करें.

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

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

डेटा अपने-आप इकट्ठा होने की सुविधा चालू करें. इसके बाद, पिछले सेक्शन में मिले उपयोगकर्ता आईडी और उपयोगकर्ता के हस्ताक्षर डालें.

यील्ड पार्टनर चुनने के बाद, इंटिग्रेशन टाइप के तौर पर Mobile SDK Mediation, प्लैटफ़ॉर्म के तौर पर Android, और स्थिति के तौर पर चालू है चुनें. पिछले सेक्शन में मिले ऐप्लिकेशन आईडी, ऐप्लिकेशन हस्ताक्षर, और विज्ञापन की जगह डालें. इसके बाद, डिफ़ॉल्ट सीपीएम वैल्यू डालें.

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

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

इसके बाद, पेज पर सबसे नीचे मौजूद सेव करें पर क्लिक करें.

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

Ad Manager के यूज़र इंटरफ़ेस (यूआई) में, जीडीपीआर और अमेरिका के कानूनों के तहत विज्ञापन पार्टनर की सूची में 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.6.0")
    implementation("com.google.ads.mediation:chartboost:9.8.2.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()
}

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

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

पक्का करें कि आपने Ad Manager के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो. साथ ही, 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	Ad Manager के यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए Chartboost सर्वर पैरामीटर मौजूद नहीं हैं या अमान्य हैं.
104	Chartboost का इंटरस्टीशियल या इनाम वाला विज्ञापन दिखाने के लिए तैयार नहीं है.