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

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

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

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

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

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

  • Unity 4 या उसके बाद का वर्शन
  • नया Google Mobile Ads SDK
  • Android पर डिप्लॉय करने के लिए
    • Android API (एपीआई) लेवल 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 से मंज़ूरी मिलना ज़रूरी है.

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

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

Android

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

iOS

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

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

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

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

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

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

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

iOS

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