इस गाइड में बताया गया है कि वॉटरफ़ॉल इंटिग्रेशन को शामिल करते हुए, मीडिएशन का इस्तेमाल करके, 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 खाते के लिए साइन अप करें और अपने खाते की पुष्टि होने के बाद, लॉग इन करें. इसके बाद, ऐप्लिकेशन मैनेजमेंट टैब पर जाएं.
अपना ऐप्लिकेशन बनाने के लिए, नया ऐप्लिकेशन जोड़ें बटन पर क्लिक करें.
फ़ॉर्म का बाकी हिस्सा भरें और अपने ऐप्लिकेशन को सेटअप करने के लिए, ऐप्लिकेशन जोड़ें बटन पर क्लिक करें.
ऐप्लिकेशन बनाने के बाद, आपको उसके डैशबोर्ड पर भेज दिया जाएगा. अपने ऐप्लिकेशन के ऐप्लिकेशन आईडी और ऐप्लिकेशन हस्ताक्षर को ध्यान में रखें.
Android
iOS
AdMob आपके विज्ञापन यूनिट का आईडी सेट अप करने के लिए, Chartboost यूज़र आईडी और उपयोगकर्ता के हस्ताक्षर होना ज़रूरी है. AdMob 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
- Chartboost Android अडैप्टर के 9.6.0.0 वर्शन पर काम करता है.
- Chartboost iOS अडैप्टर वर्शन 9.6.0.0 पर काम करता है.
- Google Mobile Ads Unity प्लगिन के वर्शन 8.6.0 से बनाया और टेस्ट किया गया.
वर्शन 4.4.0
- Chartboost Android अडैप्टर के 9.5.0.0 वर्शन पर काम करता है.
- Chartboost iOS अडैप्टर वर्शन 9.5.1.0 पर काम करता है.
- Google Mobile Ads Unity प्लगिन के वर्शन 8.5.3 की मदद से बनाया और टेस्ट किया गया.
वर्शन 4.3.0
- Chartboost Android अडैप्टर के 9.4.0.0 वर्शन पर काम करता है.
- Chartboost iOS अडैप्टर वर्शन 9.4.0.0 पर काम करता है.
- Google Mobile Ads Unity प्लगिन के वर्शन 8.5.0 से बनाया और टेस्ट किया गया.
वर्शन 4.2.0
- Chartboost Android अडैप्टर के 9.3.0.0 वर्शन पर काम करता है.
- Chartboost iOS अडैप्टर वर्शन 9.3.0.0 पर काम करता है.
- Google Mobile Ads Unity प्लगिन के वर्शन 8.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
- Chartboost Android अडैप्टर के 9.2.0.0 वर्शन पर काम करता है.
- Chartboost iOS अडैप्टर वर्शन 9.2.0.0 पर काम करता है.
- Google Mobile Ads Unity प्लगिन के वर्शन 7.4.1 की मदद से बनाया और टेस्ट किया गया.
वर्शन 4.0.0
- Chartboost Android अडैप्टर के 9.1.1.0 वर्शन पर काम करता है.
- Chartboost iOS अडैप्टर वर्शन 9.1.0.0 पर काम करता है.
- Google Mobile Ads Unity प्लगिन के वर्शन 7.3.0 से बनाया और टेस्ट किया गया.
वर्शन 3.5.1
- Chartboost Android अडैप्टर के 8.4.3.1 वर्शन पर काम करता है.
- Chartboost iOS अडैप्टर के 8.5.0.2 वर्शन पर काम करता है.
- Google Mobile Ads Unity प्लगिन के वर्शन 7.0.2 की मदद से बनाया और टेस्ट किया गया.
वर्शन 3.5.0
- Chartboost Android अडैप्टर के 8.4.2.0 वर्शन पर काम करता है.
- Chartboost iOS अडैप्टर के 8.5.0.2 वर्शन पर काम करता है.
- Google Mobile Ads Unity प्लगिन के वर्शन 7.0.0 से बनाया और टेस्ट किया गया.
वर्शन 3.4.1
- Chartboost Android अडैप्टर के 8.3.1.0 वर्शन पर काम करता है.
- Chartboost iOS अडैप्टर के 8.5.0.2 वर्शन पर काम करता है.
- Google Mobile Ads Unity प्लगिन के वर्शन 7.0.0 से बनाया और टेस्ट किया गया.
वर्शन 3.4.0
- Chartboost Android अडैप्टर के 8.3.0.0 वर्शन पर काम करता है.
- Chartboost iOS अडैप्टर के 8.5.0.1.0 वर्शन पर काम करता है.
वर्शन 3.3.1
- Chartboost Android अडैप्टर के 8.2.1.0 वर्शन पर काम करता है.
- Chartboost iOS अडैप्टर के 8.4.1.1 वर्शन पर काम करता है.
वर्शन 3.3.0
- Chartboost Android अडैप्टर वर्शन 8.2.0.0 का इस्तेमाल करता है.
- Chartboost iOS अडैप्टर वर्शन 8.4.0.0 पर काम करता है.
वर्शन 3.2.0
- Chartboost Android अडैप्टर के 8.1.0.0 वर्शन पर काम करता है.
- Chartboost iOS अडैप्टर वर्शन 8.3.1.0 पर काम करता है.
वर्शन 3.1.0
RestrictDataCollection()
तरीके कोChartboost
क्लास से हटाया गया.- Chartboost में जीडीपीआर और सीसीपीए की जानकारी पास करने के लिए,
AddDataUseConsent()
हेल्पर तरीके जोड़े गए. - Chartboost Android अडैप्टर के 8.1.0.0 वर्शन पर काम करता है.
- Chartboost iOS अडैप्टर वर्शन 8.2.0.0 पर काम करता है.
वर्शन 3.0.1
- Chartboost Android अडैप्टर वर्शन 8.0.3.1 का इस्तेमाल करता है.
- Chartboost iOS अडैप्टर वर्शन 8.1.0.1 पर काम करता है.
वर्शन 3.0.0
- Chartboost Android अडैप्टर के 8.0.2.0 वर्शन पर काम करता है.
- Chartboost iOS अडैप्टर वर्शन 8.1.0.0 पर काम करता है.
वर्शन 2.0.1
- Chartboost Android अडैप्टर वर्शन 7.5.0.1 का इस्तेमाल करता है.
- Chartboost iOS अडैप्टर वर्शन 8.0.4.0 पर काम करता है.
वर्शन 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 वर्शन पर काम करता है.