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

प्लैटफ़ॉर्म चुनें: Android iOS Unity Flutter Android (लेगसी)

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

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

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

इंटिग्रेशन
बिडिंग
वॉटरफ़ॉल
फ़ॉर्मैट
ऐप का खुलना
बैनर
इंटरस्टीशियल विज्ञापन
इनाम वाले विज्ञापन
इनाम वाला इंटरस्टीशियल विज्ञापन
मूल भाषा वाला

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

जारी रखने से पहले, इनकी पुष्टि करें:

  • Google Mobile Ads Unity Plugin का नया वर्शन.
  • Unity Editor का वर्शन 2019.4 या इसके बाद का वर्शन.
  • Android पर डिप्लॉय करने के लिए
    • Android एपीआई लेवल 24 या इसके बाद का वर्शन.
  • iOS पर डिप्लॉय करने के लिए
    • iOS डिप्लॉयमेंट का टारगेट 13.0 या इसके बाद का वर्शन होना चाहिए.
  • Google Mobile Ads Unity Plugin के साथ कॉन्फ़िगर किया गया ऐसा Unity प्रोजेक्ट जिस पर काम किया जा सकता हो. ज़्यादा जानकारी के लिए, Google Mobile Ads Unity Plugin सेट अप करना लेख पढ़ें.
  • मीडिएशन सेट अप करें.

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

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

    Chartboost apps dashboard

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

    Apps Management

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

    New app form

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

    Android

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

    iOS

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

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

    Chartboost mediation dashboard

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

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

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

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

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

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

    Android

    निर्देशों के लिए, Android के लिए दी गई गाइड में दूसरा चरण देखें.

    iOS

    निर्देशों के लिए, iOS के लिए गाइड में दिया गया दूसरा चरण देखें.

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

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

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

    OpenUPM-CLI

    अगर आपने OpenUPM-CLI इंस्टॉल किया है, तो Google Mobile Ads Chartboost Mediation Plugin for Unity को अपने प्रोजेक्ट में इंस्टॉल किया जा सकता है. इसके लिए, अपने प्रोजेक्ट की रूट डायरेक्ट्री से यह कमांड चलाएं:

    openupm add com.google.ads.mobile.mediation.chartboost

    OpenUPM

    Unity Package Manager Settings खोलने के लिए, Unity प्रोजेक्ट एडिटर में Edit > Project Settings > Package Manager चुनें.

    Scoped Registries टैब में जाकर, OpenUPM को ऐसी रजिस्ट्री के तौर पर जोड़ें जो उसके स्कोप में हो. इसके लिए, यह जानकारी डालें:

    • नाम: OpenUPM
    • URL: https://package.openupm.com
    • स्कोप: com.google

    OpenUPM की जानकारी

    इसके बाद, Window > Package Manager पर जाकर, Unity Package Manager खोलें. इसके बाद, ड्रॉप-डाउन मेन्यू से My Registries को चुनें.

    Unity Registries

    Google Mobile Ads Chartboost Mediation पैकेज चुनें और Install पर क्लिक करें.

    OpenUPM से इंस्टॉल करना

    Unity पैकेज

    बदलाव की जानकारी में दिए गए डाउनलोड करने के लिंक से, Chartboost के लिए Google Mobile Ads मीडिएशन प्लग इन का नया वर्शन डाउनलोड करें. इसके बाद, zip फ़ाइल से GoogleMobileAdsChartboostMediation.unitypackage को एक्सट्रैक्ट करें.

    अपने Unity प्रोजेक्ट एडिटर में, ऐसेट > पैकेज इंपोर्ट करें > कस्टम पैकेज को चुनें. इसके बाद, डाउनलोड की गई GoogleMobileAdsChartboostMediation.unitypackage फ़ाइल ढूंढें. पक्का करें कि सभी फ़ाइलें चुनी गई हों. इसके बाद, इंपोर्ट करें पर क्लिक करें.

    Unity से इंपोर्ट करना

    इसके बाद, ऐसेट > External Dependency Manager > Android Resolver > Force Resolve को चुनें. एक्सटर्नल डिपेंडेंसी मैनेजर लाइब्रेरी, डिपेंडेंसी रिज़ॉल्यूशन को शुरू से पूरा करेगी. साथ ही, एलान की गई डिपेंडेंसी को आपके Unity ऐप्लिकेशन की Assets/Plugins/Android डायरेक्ट्री में कॉपी करेगी.

    समस्या को ज़बरदस्ती हल करना

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

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

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

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

    नीचे दिए गए सैंपल कोड में, डेटा इस्तेमाल करने की सहमति को OptInSale पर सेट किया गया है. अगर आपको इस तरीके का इस्तेमाल करना है, तो हमारा सुझाव है कि Google Mobile Ads Unity Plugin का इस्तेमाल करके विज्ञापनों का अनुरोध करने से पहले ऐसा करें.

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

Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);

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

    Android

    Chartboost इंटिग्रेशन के लिए, किसी और कोड की ज़रूरत नहीं होती.

    iOS

    SKAdNetwork इंटिग्रेशन

    अपने प्रोजेक्ट की Info.plist फ़ाइल में SKAdNetwork आइडेंटिफ़ायर जोड़ने के लिए, Chartboost के दस्तावेज़ पढ़ें.

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

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

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

    iOS

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

    Chartboost Unity Mediation Plugin के बदलावों का लॉग

    वर्शन 4.15.1

    वर्शन 4.15.0

    वर्शन 4.14.0

    वर्शन 4.13.0

    वर्शन 4.12.1

    वर्शन 4.12.0

    वर्शन 4.11.3

    वर्शन 4.11.2

    वर्शन 4.11.1

    वर्शन 4.11.0

    वर्शन 4.10.3

    वर्शन 4.10.2

    वर्शन 4.10.1

    वर्शन 4.10.0

    वर्शन 4.9.3

    वर्शन 4.9.2

    वर्शन 4.9.1

    वर्शन 4.9.0

    वर्शन 4.8.0

    वर्शन 4.7.3

    वर्शन 4.7.2

    वर्शन 4.7.1

    वर्शन 4.7.0

    वर्शन 4.6.1

    वर्शन 4.6.0

    वर्शन 4.5.0

    वर्शन 4.4.0

    वर्शन 4.3.0

    वर्शन 4.2.0

    वर्शन 4.1.1

    • अडैप्टर के कॉन्टेंट को GoogleMobileAds/Mediation/Chartboost/ में ले जाया गया.
    • GoogleMobileAds.Mediation.Chartboost का इस्तेमाल करने के लिए, अडैप्टर नेमस्पेस को फिर से व्यवस्थित किया गया है.
    • Chartboost Android अडैप्टर के वर्शन 9.2.1.1 के साथ काम करता है.
    • Chartboost iOS अडैप्टर के वर्शन 9.2.0.0 के साथ काम करता है.
    • इसे Google Mobile Ads Unity प्लगिन के 8.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

    वर्शन 4.1.0

    वर्शन 4.0.0

    वर्शन 3.5.1

    वर्शन 3.5.0

    वर्शन 3.4.1

    वर्शन 3.4.0

    वर्शन 3.3.1

    वर्शन 3.3.0

    वर्शन 3.2.0

    वर्शन 3.1.0

    वर्शन 3.0.1

    वर्शन 3.0.0

    वर्शन 2.0.1

    वर्शन 2.0.0

    • Chartboost Android अडैप्टर के 7.5.0.0 वर्शन के साथ काम करता है.
    • Chartboost iOS अडैप्टर के 8.0.1.1 वर्शन के साथ काम करता है.

    वर्शन 1.3.0

    • इनाम वाले नए एपीआई के साथ काम करने के लिए, प्लग इन को अपडेट किया गया.
    • यह Chartboost Android अडैप्टर के 7.3.1.1 वर्शन के साथ काम करता है.
    • Chartboost iOS अडैप्टर के 7.5.0.0 वर्शन के साथ काम करता है.

    वर्शन 1.2.0

    • Chartboost Android अडैप्टर के 7.3.0.0 वर्शन के साथ काम करता है.
    • Chartboost iOS अडैप्टर के वर्शन 7.3.0.0 के साथ काम करता है.

    वर्शन 1.1.1

    • Chartboost Android अडैप्टर के 7.2.0.1 वर्शन के साथ काम करता है.
    • यह Chartboost iOS अडैप्टर के 7.2.0.1 वर्शन के साथ काम करता है.

    वर्शन 1.1.0

    • Chartboost Android SDK के 7.2.0 वर्शन के साथ काम करता है.
    • यह Chartboost iOS SDK के 7.2.0 वर्शन के साथ काम करता है.
    • Chartboost SDK के लिए, जीडीपीआर के तहत डेटा कलेक्शन से जुड़ी पाबंदियां लागू करने के लिए, Chartboost.RestrictDataCollection() तरीका जोड़ा गया.

    वर्शन 1.0.0

    • पहली रिलीज़!
    • यह Chartboost Android SDK के वर्शन 7.0.1 के साथ काम करता है.
    • यह Chartboost iOS SDK के 7.1.2 वर्शन के साथ काम करता है.