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

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

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

इंटिग्रेशन
बिडिंग  1
झरना
फ़ॉर्मैट
बैनर
मध्यवर्ती
इनाम दिया गया
मूल भाषा वाला  2

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

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

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

  • Google Mobile Ads SDK का नया वर्शन
  • Flutter 3.7.0 या इसके बाद का वर्शन
  • Android पर डिप्लॉय करने के लिए
    • Android एपीआई लेवल 21 या उसके बाद का वर्शन
  • iOS पर डिप्लॉय करने के लिए
    • iOS डिवाइस पर 10.0 या इसके बाद का डिप्लॉयमेंट टारगेट
  • Google Mobile Ads SDK के साथ कॉन्फ़िगर किया गया, काम करने वाला Flutter प्रोजेक्ट. ज़्यादा जानकारी के लिए, शुरू करें देखें.
  • मीडिएशन की प्रोसेस पूरी करें शुरुआती निर्देश

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

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

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

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

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

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

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

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

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

प्लेसमेंट

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

बिडिंग

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

झरना

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

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

खाता आईडी

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

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

बिडिंग

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

झरना

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

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

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

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

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

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

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

Android

निर्देशों के लिए, Android की गाइड में दूसरा चरण देखें.

iOS

निर्देशों के लिए, iOS की गाइड में दूसरा चरण देखें.

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

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

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

pub.dev की मदद से इंटिग्रेशन

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

dependencies:
  gma_mediation_inmobi: ^1.0.0

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

इसके लिए Google मोबाइल विज्ञापन मीडिएशन प्लग-इन का सबसे नया वर्शन डाउनलोड करें InMobi, डाउनलोड की गई फ़ाइल को एक्सट्रैक्ट करें और एक्सट्रैक्ट किए गए प्लगिन फ़ोल्डर को जोड़ें (और इसकी सामग्री) को आपके Flutter प्रोजेक्ट में शामिल करना होगा. फिर, अपने pubspec.yaml फ़ाइल में यह डिपेंडेंसी जोड़कर:

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

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

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

InMobi के लिए Google मोबाइल विज्ञापन मीडिएशन प्लग इन, InMobi SDK टूल को सहमति से जुड़ी जानकारी देने के लिए काम नहीं करता.

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

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

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

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

Android

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

iOS

SKAdNetwork इंटिग्रेशन

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

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

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

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

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

यह पुष्टि करने के लिए कि InMobiसे आपको टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन जांचने वाले टूल में विज्ञापन के एक सोर्स को टेस्ट करने की सुविधा चालू करें. इसके लिए, InMobi (Bidding) and InMobi (Waterfall) विज्ञापन सोर्स का इस्तेमाल करें.

वैकल्पिक चरण

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 AdMob यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगर किए गए 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 AdMob यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए InMobi सर्वर पैरामीटर मौजूद नहीं हैं या अमान्य हैं.
102 InMobi अडैप्टर, अनुरोध किए गए विज्ञापन फ़ॉर्मैट के साथ काम नहीं करता.
103 इस नेटवर्क कॉन्फ़िगरेशन के लिए, InMobi विज्ञापन पहले से लोड हो चुका है.
अन्य InMobi SDK से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, IMRequestStatus.h पर जाएं.

InMobi Flutter मीडिएशन अडैप्टर बदलाव लॉग

अगला वर्शन

  • Google Mobile Ads Flutter प्लग इन के 5.2.0 वर्शन के साथ बनाया और टेस्ट किया गया.

1.1.0

  • InMobi के Android अडैप्टर के 10.7.5.0 वर्शन के साथ काम करने की पुष्टि की गई है.
  • इस बात की पुष्टि की गई है कि InMobi iOS अडैप्टर के 10.7.5.0 वर्शन के साथ काम करता है या नहीं.
  • Google Mobile Ads Flutter प्लग इन के 5.1.0 वर्शन के साथ बनाया और टेस्ट किया गया.

1.0.0

  • शुरुआती रिलीज़.
  • InMobi Android अडैप्टर के 10.6.7.1 वर्शन के साथ काम करने की पुष्टि की गई है.
  • InMobi iOS अडैप्टर के वर्शन 10.7.2.0 के साथ काम करने की पुष्टि की गई है.
  • इसे Google Mobile Ads Flutter प्लगिन वर्शन 5.1.0 की मदद से बनाया और टेस्ट किया गया है.