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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Android

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

iOS

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

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

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

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

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

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

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

Android

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

iOS

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

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

Chartboost का टेस्ट मोड

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

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

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

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

Android

निर्देशों के लिए, Android.

iOS

निर्देशों के लिए, iOS.

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

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

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

OpenUPM-CLI

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

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

OpenUPM

Unity पैकेज मैनेजर की सेटिंग खोलने के लिए, अपने Unity प्रोजेक्ट एडिटर में बदलाव करें > प्रोजेक्ट सेटिंग > पैकेज मैनेजर चुनें.

दायरे वाली रजिस्ट्री टैब में, OpenUPM को इस जानकारी के साथ स्कोप वाली रजिस्ट्री के तौर पर जोड़ें:

  • नाम: OpenUPM
  • URL: https://package.openupm.com
  • दायरा: com.google

OpenUPM की जानकारी

इसके बाद, Unity Package Manager खोलने के लिए, विंडो > पैकेज मैनेजर पर जाएं. इसके बाद, ड्रॉप-डाउन मेन्यू से मेरी रजिस्ट्री चुनें.

Unity रजिस्ट्री

Google मोबाइल विज्ञापन Chartboost मीडिएशन पैकेज चुनें और इंस्टॉल करें पर क्लिक करें.

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

Unity पैकेज

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

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

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

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

ज़बरदस्ती ठीक करें

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

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

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

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

Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);

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

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

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

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

Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);

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

Android

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

iOS

SKAdNetwork इंटिग्रेशन

अपने प्रोजेक्ट की Info.plist फ़ाइल में SKAdNetwork आइडेंटिफ़ायर जोड़ने के लिए, 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 प्लग इन में हुए बदलावों का लॉग

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

  • नए 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 वर्शन के साथ काम करता है.