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

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

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

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

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

¹ बिडिंग इंटिग्रेशन की सुविधा, ओपन बीटा वर्शन में उपलब्ध है.

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

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

[बिडिंग के लिए]: बिडिंग में सभी काम करने वाले विज्ञापन फ़ॉर्मैट को इंटिग्रेट करने के लिए, Mintegral अडैप्टर 16.5.91.1 या इससे ज़्यादा (सबसे नया वर्शन इस्तेमाल करने का सुझाव दिया जाता है) का इस्तेमाल करें

GMA Next-Gen SDK पर अपलोड हुआ नया वीडियो.
मीडिएशन की प्रोसेस पूरी करने के लिए, शुरुआती निर्देश देखें.

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

अपने Mintegral खाते में साइन अप करें या लॉग इन करें.

ऐप्लिकेशन पासकोड ढूंढना

ऐप्लिकेशन की सेटिंग टैब पर जाएं और ऐप्लिकेशन का मुख्य कोड नोट करें.

नया ऐप्लिकेशन जोड़ना

ऐप्लिकेशन की सेटिंग टैब में जाकर, ऐप्लिकेशन जोड़ें बटन पर क्लिक करें.

प्लैटफ़ॉर्म चुनें और बाकी का फ़ॉर्म भरें. इसके बाद, सेव करें पर क्लिक करें.

अपने ऐप्लिकेशन के ऐप्लिकेशन आईडी को नोट करें.

विज्ञापन प्लेसमेंट बनाना

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

प्लेसमेंट का नाम और विज्ञापन का फ़ॉर्मैट डालें.

बिडिंग टाइप के तौर पर हेडर बिडिंग चुनें. बाकी का फ़ॉर्म भरें और सेव करें पर क्लिक करें.

विज्ञापन प्लेसमेंट बनाने के बाद, प्लेसमेंट आईडी नोट कर लें.

1 विज्ञापन यूनिट ड्रॉप-डाउन पर क्लिक करें और विज्ञापन यूनिट आईडी को नोट करें.

Mintegral Reporting API पासकोड ढूंढना

बिडिंग

बिडिंग इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.

झरना

Ad Manager विज्ञापन यूनिट आईडी सेट अप करने के लिए, आपके पास Mintegral Reporting API Key होना ज़रूरी है. खाता > एपीआई टूल पर जाएं. अपने Skey और Secret को नोट करें.

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

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

Mintegral के लिए app-ads.txt लागू करने के बारे में जानने के लिए, विज्ञापन से जुड़ी धोखाधड़ी से बचने में app-ads.txt कैसे मदद कर सकता है लेख पढ़ें.

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

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

'कंपनियां' सेक्शन में Mintegral को जोड़ना

बिडिंग

बिडिंग इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.

वॉटरफ़ॉल

एडमिन > कंपनियां पर जाएं. इसके बाद, सभी कंपनियां टैब में मौजूद, नई कंपनी बटन पर क्लिक करें. विज्ञापन नेटवर्क चुनें.

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

आपको उपयोगकर्ता नाम या पासवर्ड डालने की ज़रूरत नहीं है. बदलाव पूरा होने पर, सेव करें पर क्लिक करें.

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

बिडिंग

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

वॉटरफ़ॉल

वॉटरफ़ॉल इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.

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

बिडिंग

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

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

वॉटरफ़ॉल

वॉटरफ़ॉल इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.

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

बिडिंग

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

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

वॉटरफ़ॉल

वॉटरफ़ॉल इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.

Mintegral बिडिंग को कॉन्फ़िगर करना

बिडिंग

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

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

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

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

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

वॉटरफ़ॉल

वॉटरफ़ॉल इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.

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

बिडिंग

Mintegral के लिए कंपनी चुनें.

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

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

झरना

डिलीवरी > यील्ड ग्रुप पर जाएं. इसके बाद, नया यील्ड ग्रुप बटन पर क्लिक करें. अपना मोबाइल ऐप्लिकेशन चुनें.

नीचे की ओर स्क्रोल करें और यील्ड पार्टनर जोड़ें पर क्लिक करें.

पिछले सेक्शन में, Mintegral के लिए बनाई गई कंपनी चुनें. इंटिग्रेशन टाइप के तौर पर मोबाइल एसडीके मीडिएशन, प्लैटफ़ॉर्म के तौर पर Android, और स्टेटस के तौर पर चालू है को चुनें.

पिछले सेक्शन में मिली ऐप्लिकेशन कुंजी, ऐप्लिकेशन आईडी, प्लेसमेंट आईडी, और विज्ञापन यूनिट आईडी डालें. साथ ही, डिफ़ॉल्ट सीपीएम की वैल्यू डालें. सेव करें पर क्लिक करें.

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

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

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

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

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

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea")
    }
  }
}

ऐप्लिकेशन-लेवल की gradle फ़ाइल में, ये implementation dependencies और कॉन्फ़िगरेशन जोड़ें:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.23.0-beta01")
    implementation("com.google.ads.mediation:mintegral:17.0.61.1")
}

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

ग्रूवी

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.23.0-beta01'
    implementation 'com.google.ads.mediation:mintegral:17.0.61.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

Mintegral SDK को शामिल करने के लिए, Android के लिए Mintegral SDK पर जाएं.
Google की Maven रिपॉज़िटरी पर, Mintegral अडैप्टर के आर्टफ़ैक्ट पर जाएं. नया वर्शन चुनें. इसके बाद, Mintegral अडैप्टर की .aar फ़ाइल डाउनलोड करें और उसे अपने प्रोजेक्ट में जोड़ें.

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

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

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

Mintegral SDK में setConsentStatus तरीका शामिल है. इससे Mintegral SDK को सहमति की जानकारी दी जा सकती है.

यहां दिए गए सैंपल कोड में, Mintegral SDK को सहमति की जानकारी देने का तरीका बताया गया है. आपको इन विकल्पों को सेट करना होगा. इसके बाद ही, GMA Next-Gen SDK को शुरू करें, ताकि ये विकल्प Mintegral SDK को सही तरीके से फ़ॉरवर्ड किए जा सकें.

Java

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK sdk = MBridgeSDKFactory.getMBridgeSDK();
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON);

Kotlin

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

var sdk = MBridgeSDKFactory.getMBridgeSDK()
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON)

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

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

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

Mintegral SDK में setDoNotTrackStatus तरीका शामिल है. इससे Mintegral SDK को सहमति की जानकारी दी जाती है.

यहां दिए गए सैंपल कोड में, Mintegral SDK को सहमति की जानकारी देने का तरीका बताया गया है. अगर आपको इस तरीके का इस्तेमाल करना है, तो इसे GMA Next-Gen SDK को शुरू करने के बाद कॉल करें. हालांकि, GMA Next-Gen SDK के ज़रिए विज्ञापनों का अनुरोध करने से पहले ऐसा करें.

Java

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK();
mBridgeSDK.setDoNotTrackStatus(false);

Kotlin

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

var mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK()
mBridgeSDK.setDoNotTrackStatus(false)

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

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

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

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

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

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

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

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

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

वैकल्पिक चरण

CCPA के तहत विज्ञापन पार्टनर की सूची में Mintegral को जोड़ना

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

नेटिव विज्ञापन

विज्ञापन रेंडरिंग

Mintegral अडैप्टर, अपने नेटिव विज्ञापनों को NativeAd ऑब्जेक्ट के तौर पर दिखाता है. यह NativeAd के लिए, इन फ़ील्ड की वैल्यू भरता है.

फ़ील्ड	Mintegral अडैप्टर से हमेशा शामिल की जाने वाली ऐसेट
हेडलाइन
इमेज	1
मुख्य भाग
आइकॉन
कॉल-टू-ऐक्शन
स्टार रेटिंग
स्टोर
कीमत
विज्ञापन देने वाला

¹ Mintegral अडैप्टर, अपने नेटिव विज्ञापनों के लिए मुख्य इमेज ऐसेट का डायरेक्ट ऐक्सेस नहीं देता है. इसके बजाय, अडैप्टर MediaView को वीडियो या इमेज से भरता है.

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

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

com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter

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

गड़बड़ी का कोड	डोमेन	वजह
101	com.google.ads.mediation.mintegral	सर्वर के अमान्य पैरामीटर (जैसे, ऐप्लिकेशन आईडी या प्लेसमेंट आईडी मौजूद नहीं है).
102	com.google.ads.mediation.mintegral	विज्ञापन का अनुरोध किया गया साइज़, Mintegral के साथ काम करने वाले बैनर के साइज़ से मेल नहीं खाता.
103	com.google.ads.mediation.mintegral	बिड रिस्पॉन्स मौजूद नहीं है या अमान्य है.
104	com.google.ads.mediation.mintegral	Mintegral SDK टूल से, कोई विज्ञापन उपलब्ध नहीं होने की गड़बड़ी का मैसेज मिला.