Google Advertising and Measurement Community सर्वर के #gma-next-gen-sdk Discord चैनल में, GMA Next-Gen SDK के बारे में अपना सुझाव/राय दें या शिकायत करें.

Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

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

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

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

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

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

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

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

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

Android का एपीआई लेवल 24 या इसके बाद का वर्शन

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

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

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

Android Studio इंटिग्रेशन (सुझाया गया)

अपने प्रोजेक्ट-लेवल की 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.libraries.ads.mobile.sdk:ads-mobile-sdk:1.2.1")
    implementation("com.google.ads.mediation:verve:3.9.0.0")
}

configurations {
    all {
        exclude(group = "com.google.android.gms", module = "play-services-ads")
        exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
    }
}

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

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

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

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

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

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

Verve HyBid SDK, किसी तरीके की मदद से निजता सेटिंग को लागू करने की सुविधा देता है. यहां दिए गए सैंपल कोड में, सहमति की यह जानकारी Verve HyBid SDK को भेजी जाती है. अगर Verve HyBid SDK को सहमति की जानकारी मैन्युअल तरीके से भेजी जाती है, तो हमारा सुझाव है कि विज्ञापन का अनुरोध करने से पहले, उदाहरण को कॉल करें GMA Next-Gen SDK.

Java

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING);VerveMediationSnippets.java

Kotlin

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING)VerveMediationSnippets.kt

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

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

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

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

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

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

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

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

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

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

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

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

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

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

गड़बड़ी का कोड	कारण
100 से 103	Verve HyBid SDK से गड़बड़ी का मैसेज मिला.
101	विज्ञापन का अनुरोध किया गया साइज़, Verve HyBid SDK के साथ काम करने वाले बैनर के साइज़ से मेल नहीं खाता.
102	ऐप्लिकेशन टोकन मौजूद नहीं है या खाली है.
103	कॉन्टेक्स्ट की वैल्यू नल है.