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

मीडिएशन के साथ चार्टबूस्ट जोड़ें

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

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

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

इंटिग्रेशन
बिडिंग
वॉटरफ़ॉल
फ़ॉर्मैट
बैनर
मध्यवर्ती
इनाम दिया गया
नेटिव लेआउट

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Chartboost एपीआई एक्सप्लोरर

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

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

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

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

चार्टबूस्ट टेस्ट मोड

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

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

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

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

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

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

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

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

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

विज्ञापन नेटवर्क के तौर पर Chartboost चुनें और यूनीक नाम डालें. साथ ही, मीडिएशन की सुविधा चालू करें.

अपने-आप डेटा इकट्ठा होने की सुविधा को चालू करें और पिछले सेक्शन में मौजूद User ID and User Signature को डालें.

यील्ड पार्टनर चुनने के बाद, इंटिग्रेशन टाइप के तौर पर मोबाइल SDK टूल मीडिएशन, प्लैटफ़ॉर्म के तौर पर Android, और स्टेटस के तौर पर ऐक्टिव चुनें. पिछले सेक्शन में दिए गए App ID, App Signature and Ad Location कोड को डालें. इसके बाद, डिफ़ॉल्ट सीपीएम वैल्यू डालें.

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

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

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

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

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

तीसरा चरण: 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.0.0")
    implementation("com.google.ads.mediation:chartboost:9.6.1.0")
}

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

Maven Central से Chartboost SDK टूल के नए वर्शन की .aar फ़ाइल डाउनलोड करें और उसे अपने प्रोजेक्ट में जोड़ें.
Google की मेवन रिपॉज़िटरी में 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()
}

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

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

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

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

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

वैकल्पिक चरण

अनुमतियां

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

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

गड़बड़ी कोड

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

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

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

गड़बड़ी का कोड	वजह
0-99	Chartboost SDK टूल में कोई गड़बड़ी मिली है. ज़्यादा जानकारी के लिए, Chartboost के दस्तावेज़ देखें.
101	अनुरोध किए गए विज्ञापन का साइज़, Chartboost के साथ काम करने वाले बैनर साइज़ से मैच नहीं करता.
102	Chartboost एक बार में हर जगह के लिए, सिर्फ़ एक विज्ञापन लोड कर सकता है.
103	यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगर किए गए Chartboost सर्वर के Ad Manager पैरामीटर, मौजूद नहीं हैं या अमान्य हैं.
104	Chartboost का पेज पर अचानक दिखने वाला या इनाम वाला विज्ञापन, दिखाए जाने के लिए तैयार नहीं है.
101	यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगर किए गए Chartboost सर्वर के Ad Manager पैरामीटर, मौजूद नहीं हैं या अमान्य हैं.
102	Chartboost SDK टूल को शुरू करने में गड़बड़ी हुई है.
103	Chartboost विज्ञापन को शो के समय कैश मेमोरी में सेव नहीं किया जाता.
104	अनुरोध किए गए विज्ञापन का साइज़, Chartboost के साथ काम करने वाले बैनर साइज़ से मैच नहीं करता.
105	डिवाइस का ओएस वर्शन, Chartboost SDK टूल के उस ओएस वर्शन से पहले का वर्शन है जो डिवाइस पर काम करता है.
200-299	Chartboost SDK टूल की कैश मेमोरी से जुड़ी गड़बड़ियां. ज़्यादा जानकारी के लिए, कोड देखें.
300-399	Chartboost SDK टूल में गड़बड़ियां दिखाई गई हैं. ज़्यादा जानकारी के लिए, कोड देखें.
400-499	Chartboost SDK टूल की क्लिक से जुड़ी गड़बड़ियां. ज़्यादा जानकारी के लिए, कोड देखें.