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

प्लैटफ़ॉर्म चुनें: Android नई सुविधा Android iOS Unity Flutter

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

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

इंटिग्रेशन
बिडिंग
वॉटरफ़ॉल
फ़ॉर्मैट
बैनर वाले विज्ञापन
इंटरस्टीशियल विज्ञापन
इनाम वाले विज्ञापन
नेटिव विज्ञापन

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

  • नवीनतम Google Mobile Ads Flutter Plugin
  • Flutter 3.7.0 या इसके बाद का वर्शन
  • [बिडिंग के लिए]: बिडिंग में, सभी काम करने वाले विज्ञापन फ़ॉर्मैट को इंटिग्रेट करने के लिए, InMobi के लिए Google Mobile Ads मीडिएशन प्लगिन का 4.5.0 या इसके बाद का वर्शन इस्तेमाल करें (हमारा सुझाव है कि आप नया वर्शन इस्तेमाल करें)
  • Android पर डिप्लॉय करने के लिए
    • Android का एपीआई लेवल 23 या इसके बाद का वर्शन
  • iOS पर डिप्लॉय करने के लिए
    • iOS डिप्लॉयमेंट का टारगेट 10.0 या इसके बाद का वर्शन होना चाहिए
  • Google Mobile Ads Flutter प्लगिन के साथ कॉन्फ़िगर किया गया ऐसा Flutter प्रोजेक्ट जिस पर काम किया जा सकता हो.Google Mobile Ads Flutter Plugin ज़्यादा जानकारी के लिए, सेट अप Google Mobile Ads Flutter Plugin लेख पढ़ें.
  • मीडिएशन सेट अप करना.

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

साइन अप करें InMobi खाते के लिए.

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

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

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

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

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

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

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

प्लेसमेंट

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

बिडिंग

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

वॉटरफ़ॉल

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

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

खाता आईडी

आपका InMobi खाता आईडी, फ़ाइनेंस > पेमेंट सेटिंग > पेमेंट की जानकारी में मौजूद होता है.

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

बिडिंग

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

वॉटरफ़ॉल

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

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

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

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

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

InMobi के लिए app-ads.txt लागू करने के लिए, अपनी पसंद के हिसाब से बनाया गया कोड स्निपेट जोड़ें.

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

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

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

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

Android

Android

iOS

iOS

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

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

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

pub.dev के ज़रिए इंटिग्रेशन

अपने पैकेज की pubspec.yaml फ़ाइल में, InMobi SDK और अडैप्टर के नए वर्शन के साथ यह डिपेंडेंसी जोड़ें:

dependencies:
  gma_mediation_inmobi: ^2.1.0

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

InMobi इसके बाद, अपनी pubspec.yaml फ़ाइल में प्लगिन का रेफ़रंस दें. इसके लिए, यह डिपेंडेंसी जोड़ें:

dependencies:
  gma_mediation_inmobi:
    path: path/to/local/package

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

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

InMobi Flutter मीडिएशन प्लगिन के 1.1.0 वर्शन से, InMobi, जीडीपीआर के तहत दी गई सहमति को अपने-आप पढ़ता है. यह सहमति, सहमति मैनेजमेंट प्लैटफ़ॉर्म सेट करते हैं. इन प्लैटफ़ॉर्म पर, Google की 'अतिरिक्त सहमति' की खास जानकारी काम करती है. इनमें UMP SDK भी शामिल है. ज़्यादा जानकारी के लिए, Android और iOS के लिए SDK टूल को शुरू करने के बारे में InMobi का दस्तावेज़ देखें.

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

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

InMobi के लिए Google Mobile Ads मीडिएशन प्लगिन, InMobi SDK को सहमति की जानकारी नहीं भेजता.

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

Android

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

iOS

SKAdNetwork इंटिग्रेशन

अपने प्रोजेक्ट की Info.plist फ़ाइल में SKAdNetwork आइडेंटिफ़ायर जोड़ने के लिए, InMobi's documentation पढ़ें.

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

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

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

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

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

वैकल्पिक चरण

Android

अनुमतियां

बेहतर परफ़ॉर्मेंस के लिए, 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" />

आपके पास इन अनुमतियों को Plugins/Android/GoogleMobileAdsInMobiMediation/AndroidManifest.xml फ़ाइल में जोड़ने का विकल्प होता है.

iOS

iOS इंटिग्रेशन के लिए, किसी अतिरिक्त चरण को पूरा करने की ज़रूरत नहीं है.

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

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

Android

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

iOS

GADMAdapterInMobi
GADMediationAdapterInMobi

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

Android

गड़बड़ी का कोड कारण
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 के नेटिव विज्ञापन की इमेज एसेट डाउनलोड नहीं कर सका.

iOS

गड़बड़ी का कोड वजह
101 Ad Manager के यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए InMobi सर्वर पैरामीटर मौजूद नहीं हैं या मान्य नहीं हैं.
102 InMobi अडैप्टर, विज्ञापन के उस फ़ॉर्मैट के साथ काम नहीं करता जिसके लिए अनुरोध किया गया है.
103 इस नेटवर्क कॉन्फ़िगरेशन के लिए, InMobi का एक विज्ञापन पहले से लोड है.
अन्य InMobi SDK से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, IMRequestStatus.h देखें.

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

वर्शन 2.1.0

  • Flutter के ज़रूरी वर्शन को 3.38.1 पर अपडेट किया गया.
  • Google Mobile Ads Flutter प्लगिन के 8.0.0 वर्शन के साथ काम करने के लिए अपडेट किया गया.
  • inMobi Android अडैप्टर के 11.2.0.0 वर्शन के साथ काम करता है.
  • inMobi iOS अडैप्टर के 11.2.0.0 वर्शन के साथ काम करता है.
  • Google Mobile Ads Flutter प्लगिन के 8.0.0 वर्शन के साथ बनाया और टेस्ट किया गया.

वर्शन 2.0.1

  • Flutter के ज़रूरी वर्शन को 3.35.1 पर अपडेट किया गया
  • Google Mobile Ads Flutter प्लगिन के 7.0.0 वर्शन के साथ काम करने के लिए अपडेट किया गया

वर्शन 2.0.0

वर्शन 1.1.6

वर्शन 1.1.5

वर्शन 1.1.4

वर्शन 1.1.3

वर्शन 1.1.2

वर्शन 1.1.1

वर्शन 1.1.0

वर्शन 1.0.0