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

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

इस गाइड में बताया गया है कि मीडिएशन का इस्तेमाल करके, Chartboost से विज्ञापन लोड करने और उन्हें दिखाने के लिए, GMA Next Gen SDK का इस्तेमाल कैसे किया जाता है. इसमें वॉटरफ़ॉल इंटिग्रेशन के बारे में भी बताया गया है. इसमें बताया गया है कि विज्ञापन इकाई के मध्यस्थता कॉन्फ़िगरेशन में चार्टबूस्ट को कैसे जोड़ा जाए, और चार्टबूस्ट SDK और एडाप्टर को एंड्रॉइड ऐप में कैसे एकीकृत किया जाए.

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

चार्टबूस्ट के लिए मध्यस्थता एडाप्टर में निम्नलिखित क्षमताएं हैं:

इंटिग्रेशन
बिडिंग
वॉटरफ़ॉल
फ़ॉर्मैट
बैनर
इंटरस्टीशियल विज्ञापन
इनाम वाले विज्ञापन
नेटिव

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

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

GMA Next Gen SDK का नया वर्शन
मीडिएशन की प्रोसेस पूरी करें शुरुआती निर्देश

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

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

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

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

ऐप्लिकेशन मैनेज करना

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

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

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

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

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

Chartboost Mediation डैशबोर्ड

संसाधन > एपीआई एक्सप्लोरर टैब पर जाएं. इसके बाद, Authentication सेक्शन में मौजूद User ID और User Signature को नोट करें.

Chartboost API Explorer

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

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

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

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

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

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

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

Chartboost का टेस्ट मोड

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

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

दूसरा चरण: Ad Manager के यूआई में Chartboost की डिमांड सेट अप करना

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

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

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

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

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

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

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

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

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

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

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

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

GDPR और अमेरिका के निजता से जुड़े कानूनों के तहत, विज्ञापन पार्टनर की सूची में 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.libraries.ads.mobile.sdk:ads-mobile-sdk:0.21.0-beta01")
    implementation("com.google.ads.mediation:chartboost:9.10.1.0")
}

configurations {
    all {
        exclude(group = "com.google.android.gms", module = "play-services-ads")
        exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
    }
}

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

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

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

ईयू में रहने वाले उपयोगकर्ताओं की सहमति और जीडीपीआर

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

Chartboost ने SDK टूल के वर्शन 8.1.0 में, addDataUseConsent() तरीका जोड़ा है. नीचे दिए गए सैंपल कोड में, डेटा के इस्तेमाल की सहमति को NON_BEHAVIORAL पर सेट किया गया है. अगर आपको इस तरीके का इस्तेमाल करना है, तो हमारा सुझाव है कि GMA Next Gen 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 Privacy Methods देखें. साथ ही, हर तरीके में दी जा सकने वाली वैल्यू देखें.

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

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

Chartboost ने SDK टूल के वर्शन 8.1.0 में, addDataUseConsent() तरीका जोड़ा है. नीचे दिए गए सैंपल कोड में, डेटा के इस्तेमाल की सहमति को OPT_IN_SALE पर सेट किया गया है. अगर आपको इस तरीके को कॉल करना है, तो हमारा सुझाव है कि आप GMA Next Gen 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 Privacy Methods देखें. साथ ही, हर तरीके में दी जा सकने वाली वैल्यू देखें.

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

गतिविधि के कॉन्फ़िगरेशन में हुए बदलावों को अपडेट करना

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

android:configChanges="keyboardHidden|orientation|screenSize"

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

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

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

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

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

वैकल्पिक चरण

अनुमतियां

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

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

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

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

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	चार्टबूस्ट इंटरस्टीशियल या पुरस्कृत विज्ञापन प्रदर्शित होने के लिए तैयार नहीं है.