इस पेज का अनुवाद Cloud Translation API से किया गया है.

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

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

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

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

इंटिग्रेशन
बिडिंग	¹
झरना
फ़ॉर्मैट
बैनर
मध्यवर्ती
इनाम दिया गया
मूल भाषा वाला	²

¹ बिडिंग इंटिग्रेशन, ओपन बीटा वर्शन में है.

² सिर्फ़ वॉटरफ़ॉल मीडिएशन के लिए काम करता है.

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

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

Google Mobile Ads SDK का सबसे नया वर्शन
मीडिएशन की प्रोसेस पूरी करें शुरुआती निर्देशों की गाइड

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

InMobi खाते के लिए साइन अप करें. खाता बनाते समय, Google की ओपन बिडिंग के साथ InMobi SSP का इस्तेमाल करें विकल्प से सही का निशान हटाएं.

खाते की पुष्टि हो जाने के बाद, लॉग इन करें.

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

अपने ऐप्लिकेशन को InMobi के डैशबोर्ड में जोड़ने के लिए, इन्वेंट्री > इन्वेंट्री सेटिंग पर क्लिक करें.

इन्वेंट्री जोड़ें पर क्लिक करें. इसके बाद, ड्रॉप-डाउन मेन्यू से मोबाइल ऐप्लिकेशन चैनल चुनें.

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

अगर आपका ऐप्लिकेशन पब्लिश नहीं किया गया है, तो मैन्युअल तरीके से लिंक करें पर क्लिक करें और ज़रूरी जानकारी डालें. जारी रखें पर क्लिक करें.

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

प्लेसमेंट

इन्वेंट्री सेट अप करने के बाद, सिस्टम आपको प्लेसमेंट बनाने के वर्कफ़्लो पर रीडायरेक्ट कर देता है.

विज्ञापन यूनिट का टाइप चुनें. इसके बाद, प्लेसमेंट का नाम डालें. इसके बाद, ऑडियंस बिडिंग के लिए बंद करें चुनें और बाकी फ़ॉर्म भरें. इसके बाद, प्लेसमेंट बनाएं पर क्लिक करें.

प्लेसमेंट बनाने के बाद, उसकी जानकारी दिखती है. प्लेसमेंट आईडी को नोट करें. इसका इस्तेमाल, Ad Manager विज्ञापन यूनिट को सेट अप करने के लिए किया जाएगा.

खाता आईडी

आपका InMobi खाता आईडी, वित्त > पेमेंट सेटिंग > पेमेंट की जानकारी में उपलब्ध है.

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

मेरा खाता > खाता सेटिंग पर जाएं. एपीआई पासकोड टैब पर जाएं और एपीआई पासकोड जनरेट करें पर क्लिक करें.

उस उपयोगकर्ता का ईमेल चुनें जिसके लिए पासकोड की ज़रूरत है और एपीआई पासकोड जनरेट करें पर क्लिक करें. एपीआई कुंजी और उपयोगकर्ता नाम/लॉगिन नाम वाली एक फ़ाइल जनरेट होगी.

खाते का पब्लिशर एडमिन ही सभी उपयोगकर्ताओं के लिए एपीआई पासकोड जनरेट कर सकता है. अगर आपको पहले जनरेट की गई एपीआई कुंजी याद नहीं है, तो एपीआई कुंजी टैब पर अपने मेल पर कर्सर घुमाकर, अपनी एपीआई कुंजी रीसेट करें.

टेस्ट मोड चालू करना

सभी लाइव इंप्रेशन या सिर्फ़ कुछ टेस्ट डिवाइसों पर अपने प्लेसमेंट के लिए, टेस्ट मोड चालू करें.

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

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

कंपनियों में InMobi जोड़ना

बिडिंग

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

झरना

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

विज्ञापन नेटवर्क के तौर पर InMobi चुनें. इसके बाद, कोई यूनीक नाम डालें और मीडिएशन चालू करें. डेटा अपने-आप इकट्ठा होने की सुविधा चालू करें. इसके बाद, पिछले सेक्शन में मिले उपयोगकर्ता नाम और एपीआई पासकोड डालें.

इसके बाद, अपना उपयोगकर्ता नाम डालें और सेव करें पर क्लिक करें.

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

बिडिंग

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

झरना

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

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

बिडिंग

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

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

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

जारी रखें पर क्लिक करें.

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

झरना

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

विज्ञापन यूनिट मैपिंग को कॉन्फ़िगर करना

बिडिंग

डिलीवरी > बिड करने वाले पर जाएं. इसके बाद, SDK बिडिंग टैब में जाकर, InMobi के लिए कंपनी चुनें.

विज्ञापन यूनिट मैपिंग टैब पर जाएं और नई विज्ञापन यूनिट मैपिंग पर क्लिक करें.

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

झरना

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

नीचे की ओर स्क्रोल करें और नतीजों से जुड़े विज्ञापन दिखाने वाले पार्टनर जोड़ें पर क्लिक करें.

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

पिछले सेक्शन में मिले खाता आईडी और प्लेसमेंट आईडी के साथ-साथ डिफ़ॉल्ट सीपीएम की वैल्यू डालें. सेव करें पर क्लिक करें.

ध्यान दें: डेटा अपने-आप इकट्ठा होने में कुछ दिन लगते हैं. इसके बाद ही, किसी मीडिएशन नेटवर्क के लिए डाइनैमिक सीपीएम वैल्यू का सटीक हिसाब लगाया जा सकता है. eCPM का हिसाब लगाने के बाद, यह आपकी ओर से अपने-आप अपडेट हो जाता है.

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

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

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

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

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:inmobi:10.8.0.0")
}

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

InMobi Android SDK टूल डाउनलोड करें और libs फ़ोल्डर में मौजूद InMobiSDK.aar फ़ाइल को निकालें. इसके बाद, उसे अपने प्रोजेक्ट में जोड़ें.
Google के Maven Repository पर, InMobi अडैप्टर आर्टफ़ैक्ट पर जाएं. नया वर्शन चुनें, InMobi एडेप्टर की .aar फ़ाइल डाउनलोड करें, और उसे अपने प्रोजेक्ट में जोड़ें.
InMobi को अन्य डिपेंडेंसी भी शामिल करनी होंगी. ज़्यादा जानकारी के लिए, कृपया InMobi का दस्तावेज़ देखें.

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

ईयू (यूरोपीय संघ) की सहमति और जीडीपीआर

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

7.1.0.0 वर्शन में, InMobi अडैप्टर ने InMobiConsent क्लास में InMobiConsentclass that lets you pass consent information to InMobi. The following sample code callsupdateGDPRConsent()`` जोड़ा है. अगर आपको यह तरीका आज़माना है, तो हमारा सुझाव है कि आप Google Mobile Ads SDK की मदद से विज्ञापनों का अनुरोध करने से पहले ऐसा करें.

Java

import com.inmobi.sdk.InMobiSdk;
import com.google.ads.mediation.inmobi.InMobiConsent;
// ...

JSONObject consentObject = new JSONObject();
try {
  consentObject.put(InMobiSdk.IM_GDPR_CONSENT_AVAILABLE, true);
  consentObject.put("gdpr", "1");
} catch (JSONException exception) {
  exception.printStackTrace();
}

InMobiConsent.updateGDPRConsent(consentObject);

Kotlin

import com.inmobi.sdk.InMobiSdk
import com.google.ads.mediation.inmobi.InMobiConsent
// ...

val consentObject = JSONObject()
try {
  consentObject.put(InMobiSdk.IM_GDPR_CONSENT_AVAILABLE, true)
  consentObject.put("gdpr", "1")
} catch (exception: JSONException) {
  exception.printStackTrace()
}

InMobiConsent.updateGDPRConsent(consentObject)

इस सहमति ऑब्जेक्ट में, InMobi जिन संभावित कुंजियों और वैल्यू को स्वीकार करता है उनके बारे में ज़्यादा जानने के लिए, InMobi के जीडीपीआर लागू करने की जानकारी देखें.

अमेरिका के निजता कानून

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

10.5.7.1, इन वर्शन में, InMobi अडैप्टर ने शेयर की गई प्राथमिकताओं से IAB की अमेरिका की निजता स्ट्रिंग को पढ़ने की सुविधा जोड़ी है. शेयर की गई सेटिंग में, अमेरिका की निजता स्ट्रिंग सेट करने के लिए, अमेरिका के निजता कानूनों के दस्तावेज़ में दिए गए निर्देशों का पालन करें.

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

पांचवां चरण: अतिरिक्त कोड की ज़रूरत है

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

छठा चरण: लागू करने की जांच करना

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

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

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

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

वैकल्पिक चरण

अनुमतियां

बेहतर परफ़ॉर्मेंस के लिए, InMobi का सुझाव है कि आप अपने ऐप्लिकेशन की AndroidManifest.xml फ़ाइल में, नीचे दी गई वैकल्पिक अनुमतियां जोड़ें.

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />

नेटवर्क के हिसाब से पैरामीटर

InMobi अडैप्टर, अनुरोध के लिए अतिरिक्त पैरामीटर के साथ काम करता है. इन्हें Android बंडल के तौर पर अडैप्टर को पास किया जा सकता है. अडैप्टर, बंडल में ये कुंजियां खोजता है:

अनुरोध पैरामीटर और वैल्यू
`InMobiNetworkKeys.AGE_GROUP` उपयोगकर्ता का उम्र समूह.	`InMobiNetworkValues.BELOW_18` `InMobiNetworkValues.BETWEEN_18_AND_24` `InMobiNetworkValues.BETWEEN_25_AND_29` `InMobiNetworkValues.BETWEEN_30_AND_34` `InMobiNetworkValues.BETWEEN_35_AND_44` `InMobiNetworkValues.BETWEEN_45_AND_54` `InMobiNetworkValues.BETWEEN_55_AND_65` `InMobiNetworkValues.ABOVE_65`
`InMobiNetworkKeys.EDUCATION` उपयोगकर्ता की शिक्षा का स्तर.	`InMobiNetworkValues.EDUCATION_HIGHSCHOOLORLESS` `InMobiNetworkValues.EDUCATION_COLLEGEORGRADUATE` `InMobiNetworkValues.EDUCATION_POSTGRADUATEORABOVE`
`InMobiNetworkKeys.AGE`	स्ट्रिंग. उपयोगकर्ता की उम्र
`InMobiNetworkKeys.POSTAL_CODE`	स्ट्रिंग. उपयोगकर्ता का पिन कोड (आम तौर पर पांच अंकों का)
`InMobiNetworkKeys.AREA_CODE`	स्ट्रिंग. उपयोगकर्ता का एरिया कोड (टेलीफ़ोन नंबर का हिस्सा)
`InMobiNetworkKeys.LANGUAGE`	स्ट्रिंग. उपयोगकर्ता की मातृभाषा (अगर पता हो).
`InMobiNetworkKeys.CITY`	स्ट्रिंग. उपयोगकर्ता का शहर
`InMobiNetworkKeys.STATE`	स्ट्रिंग. उपयोगकर्ता की स्थिति
`InMobiNetworkKeys.COUNTRY`	स्ट्रिंग. उपयोगकर्ता का देश
`InMobiNetworkKeys.LOGLEVEL` InMobi SDK टूल के लिए लॉग लेवल सेट करता है.	`InMobiNetworkValues.LOGLEVEL_NONE` `InMobiNetworkValues.LOGLEVEL_DEBUG` `InMobiNetworkValues.LOGLEVEL_ERROR`

विज्ञापन अनुरोध के इन पैरामीटर को सेट करने का कोड उदाहरण यहां दिया गया है:

Java

Bundle extras = new Bundle();
extras.putString(InMobiNetworkKeys.AGE_GROUP, InMobiNetworkValues.BETWEEN_35_AND_54);
extras.putString(InMobiNetworkKeys.AREA_CODE, "12345");

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(InMobiAdapter.class, extras)
   .build();

Kotlin

val extras = Bundle()
extras.putString(InMobiNetworkKeys.AGE_GROUP, InMobiNetworkValues.BETWEEN_35_AND_54)
extras.putString(InMobiNetworkKeys.AREA_CODE, "12345")

val request = AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(InMobiAdapter::class.java, extras)
   .build()

नेटिव विज्ञापनों का इस्तेमाल करना

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

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

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

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

इंप्रेशन और क्लिक ट्रैकिंग

Google Mobile Ads SDK, इंप्रेशन और क्लिक ट्रैकिंग के लिए InMobi SDK के कॉलबैक का इस्तेमाल करता है. इसलिए, दोनों डैशबोर्ड की रिपोर्ट में बहुत कम या कोई अंतर नहीं होना चाहिए.

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

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

com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter

जब कोई विज्ञापन लोड नहीं होता है, तो InMobi अडैप्टर से ये कोड और मैसेज मिलते हैं:

गड़बड़ी का कोड	कारण
0-99	InMobi SDK टूल से जुड़ी गड़बड़ियां. ज़्यादा जानकारी के लिए कोड देखें.
100	Ad Manager यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए InMobi सर्वर पैरामीटर मौजूद नहीं हैं या अमान्य हैं.
101	InMobi SDK टूल को शुरू नहीं किया जा सका.
102	अनुरोध किया गया विज्ञापन साइज़, InMobi के साथ काम करने वाले बैनर साइज़ से मेल नहीं खाता.
103	विज्ञापन अनुरोध, यूनिफ़ाइड नेटिव विज्ञापन अनुरोध नहीं है.
104	InMobi SDK टूल को शुरू किए बिना, InMobi विज्ञापन का अनुरोध करने की कोशिश की गई. सिद्धांत रूप से, ऐसा कभी नहीं होना चाहिए, क्योंकि अडैप्टर, InMobi विज्ञापनों का अनुरोध करने से पहले, InMobi SDK टूल को शुरू करता है.
105	InMobi का विज्ञापन अभी दिखाने के लिए तैयार नहीं है.
106	InMobi, विज्ञापन नहीं दिखा सका.
107	InMobi ने ऐसा नेटिव विज्ञापन दिखाया है जिसमें ज़रूरी एसेट मौजूद नहीं है.
108	InMobi की नेटिव विज्ञापन इमेज एसेट में गलत यूआरएल है.
109	अडैप्टर, InMobi की नेटिव विज्ञापन इमेज ऐसेट डाउनलोड नहीं कर सका.