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

प्लैटफ़ॉर्म चुनें: Android (बीटा) Android iOS Unity Flutter

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

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

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

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

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

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

• नया GMA Next-Gen SDK.

• मीडिएशन की प्रोसेस पूरी करने के शुरुआती निर्देश Get started guide.

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

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

ऐप्लिकेशन की कुंजी ढूंढना

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

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

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

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

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

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

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

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

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

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

Mintegral की रिपोर्टिंग एपीआई कुंजी ढूंढना

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

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

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

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

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

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

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

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

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

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

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

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

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

बिडिंग

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

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



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



अगर आपने Mintegral को पहले से विज्ञापन सोर्स के तौर पर जोड़ा हुआ है, तो उसे चुना जा सकता है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें पर क्लिक करें.



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

वॉटरफ़ॉल

विज्ञापन सोर्स सेक्शन में मौजूद वॉटरफ़ॉल कार्ड में जाकर, विज्ञापन सोर्स जोड़ें को चुनें.

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



अगर आपने Mintegral को पहले से विज्ञापन सोर्स के तौर पर जोड़ा हुआ है, तो उसे चुना जा सकता है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें पर क्लिक करें.

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

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

AdMob के यूज़र इंटरफ़ेस (यूआई) में, यूरोप और अमेरिका के राज्यों के कानूनों के तहत विज्ञापन पार्टनर की सूची में 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 फ़ाइल में, ये लागू करने से जुड़ी डिपेंडेंसी और कॉन्फ़िगरेशन जोड़ें:

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

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.25.0-beta01'
    implementation 'com.google.ads.mediation:mintegral:17.0.91.0'
}

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

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

1. Mintegral SDK को शामिल करने के लिए, Android के लिए Mintegral SDK पर जाएं.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

वैकल्पिक चरण

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

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

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

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

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

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

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

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

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

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