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

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

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

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

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

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

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

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

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

  • Android का एपीआई लेवल 23 या इसके बाद का वर्शन हो.

पहला चरण: 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 को जीडीपीआर और अमेरिका के राज्यों में लागू कानूनों के तहत विज्ञापन पार्टनरों की सूची में जोड़ना

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

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

अपने प्रोजेक्ट-लेवल की settings.gradle.kts फ़ाइल में, ये रिपॉज़िटरी जोड़ें:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://verve.jfrog.io/artifactory/verve-gradle-release")
    }
  }
}

इसके बाद, अपने ऐप्लिकेशन-लेवल की build.gradle.kts फ़ाइल में, ये लागू करने से जुड़ी डिपेंडेंसी और कॉन्फ़िगरेशन जोड़ें. Verve HyBid SDK और अडैप्टर के नए वर्शन का इस्तेमाल करें:

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.4.0")
    implementation("com.google.ads.mediation:verve:3.9.1.0")
}

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

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

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

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

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

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

Java

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING);

Kotlin

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING)

US_PRIVACY_STRING की जगह, अमेरिका के राज्यों के निजता कानून के तहत दी गई सहमति की स्ट्रिंग डालें.

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

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

Verve HyBid SDK इंटिग्रेशन के लिए, किसी अतिरिक्त कोड की ज़रूरत नहीं होती.

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

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

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

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

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

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

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

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

net.pubnative.lite.sdk
com.google.ads.mediation.verve

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

गड़बड़ी का कोड डोमेन वजह
101 जिस विज्ञापन साइज़ का अनुरोध किया गया है वह Verve HyBid SDK के साथ काम करने वाले बैनर साइज़ से मेल नहीं खाता है.
102 net.pubnative.lite.sdk Verve HyBid में गड़बड़ी - विज्ञापन लोड नहीं किया जा सका.
103 com.google.ads.mediation.verve फ़ुलस्क्रीन मोड में दिखने वाला कोई विज्ञापन दिखाने की कोशिश की गई, जो मौजूद नहीं है.
104 com.google.ads.mediation.verve MobileAds.getRequestConfiguration() से पता चलता है कि उपयोगकर्ता कोई बच्चा है. Verve को हटा दिया जाएगा.

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

वर्शन 3.9.1.0

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

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

  • Google Mobile Ads SDK का वर्शन 25.4.0.
  • Google Mobile Ads Next-Gen SDK का वर्शन 1.3.1.
  • Verve HyBid SDK का वर्शन 3.9.1.

वर्शन 3.9.0.0

  • जब नया AgeRestrictedTreatment CHILD पर सेट हो, तब Verve SDK के लिए, उम्र से जुड़ी पाबंदी वाले अनुरोधों को फ़िल्टर करें.
  • Verve HyBid SDK के 3.9.0 वर्शन के साथ काम करने की पुष्टि की गई है.

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

  • Google Mobile Ads SDK का वर्शन 25.4.0.
  • Google Mobile Ads Next-Gen SDK का वर्शन 1.2.1.
  • Verve HyBid SDK का वर्शन 3.9.0.

वर्शन 3.8.2.0

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

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

  • Google Mobile Ads SDK का वर्शन 25.3.0.
  • Google Mobile Ads Next-Gen SDK का वर्शन 1.2.1.
  • Verve HyBid SDK का वर्शन 3.8.2.

वर्शन 3.8.1.1

  • VerveNativeAd के लिए, कॉन्टेंट की जानकारी पर क्लिक करने और सामान्य विज्ञापन पर क्लिक करने के बीच अंतर करने के लिए, क्लिक किए जा सकने वाले व्यू को फ़िल्टर करें.

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

  • Google Mobile Ads SDK का वर्शन 25.2.0.
  • Google Mobile Ads Next-Gen SDK का वर्शन 1.0.1.
  • Verve HyBid SDK का वर्शन 3.8.1.

वर्शन 3.8.1.0

  • GMA Next-Gen SDK डिपेंडेंसी के साथ अडैप्टर बनाने के लिए, प्रॉपर्टी जोड़ी गई.
  • Verve HyBid SDK के 3.8.1 वर्शन के साथ काम करने की पुष्टि की गई है.

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

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

वर्शन 3.7.1.1

  • सिग्नल इकट्ठा न हो पाने की समस्या को हल करने के लिए, Verve अडैप्टर से बैनर के साइज़ की जांच करने की सुविधा हटा दी गई है.

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

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

वर्शन 3.7.1.0

  • शुरुआती रिलीज़.
  • Verve HyBid SDK के 3.7.1 वर्शन के साथ काम करने की पुष्टि की गई है.

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

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