हमारे प्रॉडक्ट के बारे में चर्चा करने और सुझाव/राय देने के लिए, Google विज्ञापन और मेज़रमेंट कम्यूनिटी सर्वर में Ad Manager के आधिकारिक Discord चैनल से जुड़ें.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

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

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

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

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

इंटिग्रेशन
बिडिंग
वॉटरफ़ॉल
फ़ॉर्मैट
बैनर
इंटरस्टीशियल विज्ञापन
इनाम वाले विज्ञापन
नेटिव

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

iOS डिप्लॉयमेंट का टारगेट 12.0 या इसके बाद का होना चाहिए

Google Mobile Ads SDK का नया वर्शन
मीडिएशन की सुविधा चालू करना शुरुआती निर्देश

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

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

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

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

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

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

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

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

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

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

Chartboost Mediation डैशबोर्ड

संसाधन > एपीआई एक्सप्लोरर टैब पर जाएं. इसके बाद, Authentication सेक्शन में मौजूद User ID और User Signature को नोट करें.

Chartboost API Explorer

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

Authorized Sellers for Apps app-ads.txt, IAB Tech Lab की एक पहल है. इसकी मदद से यह पक्का किया जा सकता है कि आपके ऐप्लिकेशन की विज्ञापन इन्वेंट्री सिर्फ़ वे ही चैनल बेचें जिन्हें आपने अनुमति दी है. विज्ञापन से मिलने वाले रेवेन्यू में ज़्यादा नुकसान न हो, इसके लिए आपको app-ads.txt फ़ाइल लागू करनी होगी. अगर आपने अब तक ऐसा नहीं किया है, तो Ad Manager के लिए app-ads.txt फ़ाइल बनाएं.

Chartboost के लिए app-ads.txt लागू करने के लिए, app-ads.txt देखें.

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

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

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

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

Chartboost का टेस्ट मोड

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

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

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

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

अपने Ad Manager खाते में साइन इन करें.

डिलीवरी > यील्ड ग्रुप पर जाएं और नया यील्ड ग्रुप बटन पर क्लिक करें.

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

इसके बाद, यील्ड पार्टनर जोड़ें बटन पर क्लिक करें.

अगर आपके पास Chartboost के लिए पहले से ही कोई Yield partner है, तो उसे चुना जा सकता है. इसके अलावा, नया यील्ड पार्टनर बनाएं को चुनें.

विज्ञापन नेटवर्क के तौर पर Chartboost को चुनें. इसके बाद, यूनीक नाम डालें और मीडिएशन चालू करें.

डेटा अपने-आप इकट्ठा होने की सुविधा चालू करें. इसके बाद, पिछले सेक्शन में मिला User ID और User Signature डालें.

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

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

Chartboost के यूज़र इंटरफ़ेस (यूआई) में, ऐडवांस सेटिंग पर क्लिक करके, बुनियादी सेटिंग पेज पर जाकर विज्ञापन की जगहें देखी जा सकती हैं. ज़्यादा जानकारी के लिए, Chartboost की Named Locations गाइड देखें.

इसके बाद, पेज पर सबसे नीचे सेव करें पर क्लिक करें.

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

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

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

CocoaPods का इस्तेमाल करना (सुझाया गया)

अपने प्रोजेक्ट की Podfile में यह लाइन जोड़ें:
```
pod 'GoogleMobileAdsMediationChartboost'
```
कमांड लाइन से यह निर्देश चलाएं:
```
pod install --repo-update
```

मैन्युअल इंटिग्रेशन

Chartboost SDK का नया वर्शन डाउनलोड करें. इसके बाद, अपने प्रोजेक्ट में Chartboost.framework और CHAMoatMobileAppKit.framework को लिंक करें.
बदलाव की जानकारी में दिए गए डाउनलोड लिंक से, Chartboost अडैप्टर का नया वर्शन डाउनलोड करें. इसके बाद, अपने प्रोजेक्ट में ChartboostAdapter.framework को लिंक करें.
अपने प्रोजेक्ट में ये फ़्रेमवर्क जोड़ें:
- StoreKit
- Foundation
- CoreGraphics
- WebKit
- AVFoundation
- UIKit

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

ईयू में रहने वाले उपयोगकर्ताओं की सहमति और जीडीपीआर

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

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

Swift

let dataUseConsent = CHBDataUseConsent.GDPR(CHBDataUseConsent.GDPR.Consent.nonBehavioral)
Chartboost.addDataUseConsent(dataUseConsent)

Objective-C

CHBGDPRDataUseConsent *dataUseConsent = [CHBGDPRDataUseConsent gdprConsent:CHBGDPRConsentNonBehavioral];
[Chartboost addDataUseConsent:dataUseConsent];

ज़्यादा जानकारी के लिए, Chartboost का GDPR लेख और उनके iOS Privacy Methods देखें. साथ ही, हर तरीके में दी जा सकने वाली वैल्यू देखें.

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

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

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

Swift

let dataUseConsent = CHBDataUseConsent.CCPA(CHBDataUseConsent.CCPA.Consent.optInSale)
Chartboost.addDataUseConsent(dataUseConsent)

Objective-C

CHBCCPADataUseConsent *dataUseConsent = [CHBCCPADataUseConsent ccpaConsent:CHBCCPAConsentOptInSale];
[Chartboost addDataUseConsent:dataUseConsent];

ज़्यादा जानकारी के लिए, Chartboost का CCPA लेख और उनके iOS Privacy Methods देखें. साथ ही, यह भी देखें कि हर तरीके में कौनसी वैल्यू दी जा सकती हैं.

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

SKAdNetwork इंटिग्रेशन

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

प्रोजेक्ट सेटिंग

अपने टारगेट के Build Settings में जाकर, Allow Non-modular Includes in Framework Modules को YES पर सेट करें.

अपने प्रोजेक्ट की बिल्ड सेटिंग में जाकर, डीबग और रिलीज़, दोनों के लिए 'अन्य लिंक करने वाले फ़्लैग' में -ObjC वैल्यू जोड़ें.

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

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

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

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

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

गड़बड़ी के कोड

अगर अडैप्टर को Chartboost से विज्ञापन नहीं मिलता है, तो विज्ञापन के जवाब में हुई गड़बड़ी की जानकारी देखने के लिए, यहां दिए गए क्लास में जाकर GADResponseInfo.adNetworkInfoArray का इस्तेमाल करें:

GADMAdapterChartboost
GADMediationAdapterChartboost

विज्ञापन लोड न होने पर, Chartboost अडैप्टर से मिलने वाले कोड और उनसे जुड़े मैसेज यहां दिए गए हैं:

गड़बड़ी का कोड	कारण
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 में क्लिक से जुड़ी गड़बड़ियां. ज़्यादा जानकारी के लिए, कोड देखें.