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

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

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

Chartboost के लिए AdMob मीडिएशन अडैप्टर में ये काम करते हैं:

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

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

  • Unity 4 या इसके बाद का वर्शन
  • Google Mobile Ads SDK का नया वर्शन
  • Android पर डिप्लॉय करने के लिए
    • Android का एपीआई लेवल 21 या उसके बाद का वर्शन
  • iOS पर डिप्लॉय करने के लिए
    • iOS 12.0 या इसके बाद का डिप्लॉयमेंट टारगेट
  • Google Mobile Ads SDK के साथ कॉन्फ़िगर किया गया एक चालू Unity प्रोजेक्ट. ज़्यादा जानकारी के लिए, शुरू करें पर जाएं.
  • मीडिएशन की प्रोसेस पूरी करें शुरुआती निर्देश

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

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

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

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

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

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

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

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

Android

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

iOS

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

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

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

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

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

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

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

Android

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

iOS

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

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

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

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

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

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

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

Android

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

iOS

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

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

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

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

Changelog में डाउनलोड लिंक से Chartboost के लिए Google मोबाइल विज्ञापन मीडिएशन प्लग इन का सबसे नया वर्शन डाउनलोड करें और ZIP फ़ाइल से GoogleMobileAdsChartboostMediation.unitypackage एक्सट्रैक्ट करें.

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

इसके बाद, ऐसेट > Play Services रिज़ॉल्वर > Android रिज़ॉल्वर > फ़ोर्स रिज़ॉल्व चुनें. Unity Play Services रिज़ॉल्वर लाइब्रेरी, डिपेंडेंसी रिज़ॉल्यूशन को नए सिरे से तैयार करेगी. साथ ही, तय की गई डिपेंडेंसी को आपके Unity ऐप्लिकेशन की Assets/Plugins/Android डायरेक्ट्री में कॉपी करेगी.

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

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

Chartboost के वर्शन 3.1.0 के लिए Google मोबाइल विज्ञापन मीडिएशन प्लगिन में Chartboost.AddDataUseConsent() तरीका शामिल है. नीचे दिया गया सैंपल कोड, डेटा सेट करता है. इसमें 'NonBehavioral' के लिए 'सहमति दी गई' का इस्तेमाल किया जाता है. अगर आपको इस तरीके को कॉल करना है, तो हमारा सुझाव है कि Google Mobile Ads SDK का इस्तेमाल करके विज्ञापनों का अनुरोध करने से पहले ऐसा कर लें.

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

Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);

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

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

Chartboost के वर्शन 3.1.0 के लिए Google मोबाइल विज्ञापन मीडिएशन प्लगिन में Chartboost.AddDataUseConsent() तरीका शामिल है. नीचे दिया गया सैंपल कोड, डेटा सेट करता है. इसमें 'OptInSale' के लिए 'सहमति दी गई' का इस्तेमाल किया जाता है. अगर आपको इस तरीके को कॉल करना है, तो हमारा सुझाव है कि Google Mobile Ads SDK का इस्तेमाल करके विज्ञापनों का अनुरोध करने से पहले ऐसा कर लें.

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

Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);

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

Android

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

iOS

SKAdNetwork इंटिग्रेशन

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

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

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

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

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

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

वैकल्पिक चरण

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, एक जगह पर एक बार में सिर्फ़ 1 विज्ञापन लोड कर सकता है.
103 AdMob यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगर किए गए Chartboost सर्वर पैरामीटर मौजूद नहीं हैं या अमान्य हैं.
104 Chartboost के अचानक दिखने वाला या इनाम वाला विज्ञापन, दिखाने के लिए तैयार नहीं है.

iOS

गड़बड़ी का कोड वजह
101 AdMob यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगर किए गए 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 मीडिएशन प्लगिन में बदलाव

वर्शन 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

  • नए Rewarded API के साथ काम करने के लिए, प्लगिन को अपडेट किया गया.
  • 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 के साथ काम करता है.