बिडिंग के साथ Verve HyBid SDK को इंटिग्रेट करना

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

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

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

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

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

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

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

जारी रखने से पहले, इनकी पुष्टि करें:

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

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

• मीडिएशन सेट अप करें.

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

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

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

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

सुरक्षित तरीके से सिग्नल शेयर करने की सुविधा चालू करना

एडमिन > ग्लोबल सेटिंग पर जाएं. Ad Exchange खाते की सेटिंग टैब पर जाएं. इसके बाद, सुरक्षित सिग्नल शेयर करने की सुविधा की समीक्षा करें और इसे टॉगल करके चालू करें. सेव करें पर क्लिक करें.

बिड रिक्वेस्ट पर सुरक्षित तरीके से सिग्नल शेयर करना

इन्वेंट्री > सुरक्षित सिग्नल पर जाएं. सुरक्षित सिग्नल में जाकर, Verve HyBid SDK खोजें. इसके बाद, ऐप्लिकेशन इंटिग्रेशन चालू करें को टॉगल करके चालू करें.

सेव करें पर क्लिक करें.

एसडीके से बिडिंग के लिए सुरक्षित सिग्नल शेयरिंग की अनुमति देना

डिलीवरी > डिमांड चैनल की सेटिंग पर जाएं. डिफ़ॉल्ट सेटिंग टैब में, एसडीके से बिडिंग के लिए, सुरक्षित सिग्नल शेयर करने की अनुमति दें को टॉगल करके चालू करें.

सेव करें पर क्लिक करें.

Verve HyBid SDK से बिडिंग की सुविधा कॉन्फ़िगर करना

विज्ञापन डिलीवरी > बिड करने वाले पर जाएं. इसके बाद, एसडीके से बिडिंग पर जाएं पर क्लिक करें.

नया बिडर पर क्लिक करें.

बिडर के तौर पर Verve Group को चुनें.

बिड करने वाले इस व्यक्ति या कंपनी के लिए एसडीके से बिडिंग की सुविधा चालू करने के लिए, जारी रखें पर क्लिक करें.

हो गया पर क्लिक करें.

विज्ञापन यूनिट को मैप करने की सुविधा कॉन्फ़िगर करना

विज्ञापन डिलीवरी > बिड करने वाले पर जाएं. इसके बाद, एसडीके से बिडिंग पर जाएं पर क्लिक करें.

Verve HyBid SDK के लिए कंपनी चुनें.

विज्ञापन यूनिट की मैपिंग टैब पर जाएं. इसके बाद, नई विज्ञापन यूनिट की मैपिंग पर क्लिक करें.

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

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

आखिर में, सेव करें पर क्लिक करें.

अहम जानकारी: चुनी गई विज्ञापन यूनिट को कम से कम एक यील्ड ग्रुप से टारगेट करें.

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

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

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

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

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

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

जारी रखने से पहले, आपके पास कम से कम 3.8.0.0 वर्शन का अडैप्टर होना चाहिए.

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

1. Xcode में, File > Add Package Dependencies... पर जाएं.

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 अडैप्टर का नया वर्शन डाउनलोड करें. इसके बाद, 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 की जगह, अमेरिका में निजता से जुड़ी अपनी स्ट्रिंग डालें.

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

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

SKAdNetwork लागू करना

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

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

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

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

अहम जानकारी: अपने ऐप्लिकेशन को रिलीज़ करने से पहले, Ad Manager और 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 Mediation Adapter के बदलावों की जानकारी

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