AdMob मीडिएशन के साथ Verve HyBid SDK को इंटिग्रेट करना

प्लैटफ़ॉर्म चुनें: Android iOS Android (लेगसी)

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

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

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

इंटिग्रेशन
बिडिंग	^1
वॉटरफ़ॉल
फ़ॉर्मैट
बैनर वाले विज्ञापन
मध्यवर्ती
पुरस्कृत मध्यवर्ती
इनाम दिया गया
मूल भाषा वाला

¹ बिडिंग इंटिग्रेशन, ऐल्फ़ा वर्शन में है. ऐक्सेस पाने के लिए, अपने खाता मैनेजर से संपर्क करें.

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

आगे बढ़ने से पहले, यह पक्का करें कि:

• iOS डिप्लॉयमेंट का टारगेट 13.0 या इसके बाद का वर्शन हो.

• Google Mobile Ads SDK का नया वर्शन हो.

• AdMob मीडिएशन सेट अप किया गया हो.

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

कॉन्फ़िगरेशन सेट अप करने के लिए, Verve से संपर्क करें.

दूसरा चरण: AdMob के यूज़र इंटरफ़ेस (यूआई) में Verve HyBid SDK की डिमांड सेट अप करना

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

आपको अपनी विज्ञापन यूनिट के लिए, मीडिएशन कॉन्फ़िगरेशन में Verve HyBid SDK जोड़ना होगा.

सबसे पहले, अपने AdMob खाते में साइन इन करें. इसके बाद, मीडिएशन टैब पर जाएं. अगर आपको किसी मौजूदा मीडिएशन ग्रुप में बदलाव करना है, तो उस मीडिएशन ग्रुप के नाम पर क्लिक करके उसमें बदलाव करें. इसके बाद, Verve HyBid SDK को विज्ञापन सोर्स के तौर पर जोड़ें पर जाएं.

नया मीडिएशन ग्रुप बनाने के लिए, मीडिएशन ग्रुप बनाएं को चुनें.

विज्ञापन फ़ॉर्मैट और प्लैटफ़ॉर्म की जानकारी डालें. इसके बाद, जारी रखें पर क्लिक करें.

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

इस मीडिएशन ग्रुप को अपनी मौजूदा AdMob विज्ञापन यूनिट में से एक या इससे ज़्यादा विज्ञापन यूनिट से जोड़ें. इसके बाद, हो गया पर क्लिक करें.

अब आपको विज्ञापन यूनिट का कार्ड दिखेगा. इसमें आपको वे विज्ञापन यूनिट दिखेंगी जिन्हें आपने चुना था:

Verve HyBid SDK को विज्ञापन सोर्स के तौर पर जोड़ना

विज्ञापन सोर्स सेक्शन में मौजूद, बिडिंग कार्ड में जाकर, विज्ञापन सोर्स जोड़ें को चुनें. इसके बाद, Verve HyBid SDK को चुनें.

पार्टनरशिप के कानूनी समझौते पर हस्ताक्षर करने का तरीका पर क्लिक करें और बिडिंग पार्टनरशिप सेट अप करें Verve HyBid SDK के साथ.



**स्वीकार करें और सहमति दें** पर क्लिक करें. इसके बाद, **जारी रखें** पर क्लिक करें.



अगर आपने Verve HyBid SDK के लिए पहले से कोई मैपिंग की हुई है, उसे चुना जा सकता है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें पर क्लिक करें.



इसके बाद, पिछले सेक्शन में मिले ज़ोन आईडी और ऐप्लिकेशन टोकन डालें. इसके बाद, हो गया पर क्लिक करें.

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

अहम जानकारी: पक्का करें कि आपके पास खाते के मैनेजमेंट की अनुमति हो, ताकि आप ई101}यू उपयोगकर्ता की सहमति और जीडीपीआर, अमेरिका के राज्यों में लागू कानूनों, और User Messaging Platform के लिए कॉन्फ़िगरेशन पूरा कर सकें. ज़्यादा जानकारी के लिए, अपने खाते में उपयोगकर्ता के ऐक्सेस को मैनेज करना लेख पढ़ें.

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

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

ध्यान दें: साथ काम करने वाले Verve HyBid SDK और Google Mobile Ads SDK वर्शन इंटिग्रेट न होने पर, बिल्ड से जुड़ी समस्याएं आ सकती हैं.

Swift Package Manager का इस्तेमाल करना

आगे बढ़ने से पहले, पक्का करें कि आपके पास अडैप्टर का कम से कम 3.8.0.0 वर्शन हो.

अपने प्रोजेक्ट में पैकेज की डिपेंडेंसी जोड़ने के लिए, यह तरीका अपनाएं:

1. Xcode में, फ़ाइल > पैकेज की डिपेंडेंसी जोड़ें... पर जाएं.

2. दिखने वाले प्रॉम्प्ट में, इस पैकेज का यूआरएल खोजें:

   https://github.com/googleads/googleads-mobile-ios-mediation-verve.git
   

3. डिपेंडेंसी का नियम में, ब्रांच को चुनें.

4. टेक्स्ट फ़ील्ड में, main डालें.

CocoaPods का इस्तेमाल करना

• अपने प्रोजेक्ट की Podfile में यह लाइन जोड़ें:

  pod 'GoogleMobileAdsMediationVerve'
  

• कमांड लाइन से यह चलाएं:

  pod install --repo-update

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

• Verve iOS SDK का नया वर्शन डाउनलोड करें और अपने प्रोजेक्ट में VerveSDK.framework को लिंक करें.

• बदलाव की जानकारी में दिए गए डाउनलोड लिंक से, Verve अडैप्टर का नया वर्शन डाउनलोड करें. इसके बाद, अपने प्रोजेक्ट में Changelogको लिंक VerveAdapter.framework करें.

• अपने प्रोजेक्ट में ये फ़्रेमवर्क जोड़ें:

  • AdSupport
  • AVFoundation
  • CoreGraphics
  • CoreMedia
  • CoreTelephony
  • StoreKit
  • SystemConfiguration
  • UIKit
  • WebKit
  • libz.tbd

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

ईयू उपयोगकर्ता की सहमति से जुड़ी नीति और जीडीपीआर

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

Verve HyBid SDK, जीडीपीआर के तहत दी गई सहमति को अपने-आप पढ़ लेता है. यह सहमति, सहमति मैनेजमेंट प्लैटफ़ॉर्म सेट करते हैं. इनमें UMP SDK भी शामिल है. ज़्यादा जानकारी के लिए, जीडीपीआर टीसीएफ का पालन करना देखें.

अमेरिका के राज्यों के निजता कानून

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

Verve HyBid SDK, किसी तरीके की मदद से निजता सेटिंग को मैनेज करने की सुविधा देता है. यहां दिए गए सैंपल कोड में, सहमति की यह जानकारी Verve HyBid SDK को भेजी जाती है. अगर सहमति की जानकारी, Verve HyBid SDK को मैन्युअल तरीके से भेजी जाती है, तो हमारा सुझाव है कि Google Mobile Ads SDKके ज़रिए विज्ञापन का अनुरोध करने से पहले, उदाहरण में दिए गए कोड का इस्तेमाल करें.

Swift

HyBidUserDataManager.sharedInstance().setIABUSPrivacyString(usPrivacyString)
VerveMediationSwiftSnippets.swift

usPrivacyString की जगह, अमेरिका के निजता कानून के मुताबिक स्ट्रिंग डालें.

Objective-C

[[HyBidUserDataManager sharedInstance] setIABUSPrivacyString:kUSPrivacyString];
VerveMediationObjectiveCSnippets.m

kUSPrivacyString की जगह, अमेरिका के निजता कानून के मुताबिक स्ट्रिंग डालें.

ज़्यादा जानकारी के लिए, सीसीपीए का पालन करने से जुड़े Verve HyBid SDK के निजता दस्तावेज़ देखें .

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

SKAdNetwork लागू करना

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

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

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

पक्का करें कि आपने AdMob के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो.

**अहम जानकारी:** अपने ऐप्लिकेशन को रिलीज़ करने से पहले, AdMob और Verve HyBid SDK के लिए टेस्ट मोड बंद करें.

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

यह पुष्टि करने के लिए कि आपको Verve HyBid SDK से टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन के किसी एक सोर्स को टेस्ट करना चालू करें विज्ञापन जांचने वाले टूल में Verve (बिडिंग) विज्ञापन सोर्स का इस्तेमाल करके.

अतिरिक्त कॉन्फ़िगरेशन के लिए, Verve HyBid SDK का दस्तावेज़ पढ़ें.

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

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

GADMAdapterVerve
GADMAdapterVerveRewardBasedVideoAd
GADMediationAdapterVerve

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

गड़बड़ी का कोड	कारण
100 से 106	Verve HyBid SDK से गड़बड़ी का मैसेज मिला.
101	ऐप्लिकेशन टोकन मौजूद नहीं है.
102	उपयोगकर्ता कोई बच्चा है.
103	Verve HyBid SDK शुरू नहीं हो सका.
104	विज्ञापन का कॉन्फ़िगरेशन अमान्य है.
105	बैनर का साइज़, ज़रूरी शर्तों के मुताबिक नहीं है.
106	फ़ुल स्क्रीन विज्ञापन दिखाने के लिए तैयार नहीं है.
115	विज्ञापन यूनिट आईडी मौजूद नहीं है. विज्ञापन लोड नहीं किया जा सकता.
116	विज्ञापन तैयार नहीं है. विज्ञापन नहीं दिखाया जा सकता.

Verve iOS मीडिएशन अडैप्टर के बदलावों की जानकारी

वर्शन 3.9.0.0

• Google Mobile Ads iOS SDK के ज़रूरी वर्शन को 13.3 पर अपडेट किया गया है, ताकि छोटे वर्शन इस्तेमाल किए जा सकें.
• HyBid SDK के 3.9.0 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 13.6.0.
• HyBid SDK का वर्शन 3.9.0.

वर्शन 3.8.1.1

• जब नया ageRestrictedTreatment , GADAgeRestrictedTreatmentChild पर सेट किया जाता है, तब Verve SDK के लिए, उम्र से जुड़ी पाबंदी वाले अनुरोधों को फ़िल्टर किया जाता है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 13.4.0.
• HyBid SDK का वर्शन 3.8.1.

वर्शन 3.8.1.0

• HyBid SDK के 3.8.1 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 13.4.0.
• HyBid SDK का वर्शन 3.8.1.

वर्शन 3.8.0.0

• सिग्नल कलेक्शन में होने वाली गड़बड़ियों और विज्ञापन लोड न होने की समस्याओं को हल करने के लिए, अडैप्टर से बैनर के साइज़ की जांच करने की सुविधा हटा दी गई है.
• HyBid SDK के 3.8.0 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 13.2.0.
• HyBid SDK का वर्शन 3.8.0.

वर्शन 3.7.1.3

• Google Mobile Ads SDK की डिपेंडेंसी को वर्शन 13.0.0 पर अपडेट किया गया है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 13.0.0.
• HyBid SDK का वर्शन 3.7.1.

वर्शन 3.7.1.2

• CocoaPods के लिए, iOS के ज़रूरी वर्शन को 13.0 पर अपडेट किया गया है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 13.0.0.
• HyBid SDK का वर्शन 3.7.1.

वर्शन 3.7.1.1

• पहली बार रिलीज़ होने की तारीख!
• यह बिडिंग बैनर, इंटरस्टीशियल, इनाम वाले, इनाम वाला इंटरस्टीशियल, और नेटिव विज्ञापन फ़ॉर्मैट के साथ काम करता है.
• HyBid SDK के 3.7.1 वर्शन के साथ काम करने की पुष्टि की गई है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 12.13.0.
• HyBid SDK का वर्शन 3.7.1.