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

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

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

इंटिग्रेशन
बिडिंग	^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 डैशबोर्ड में जोड़ने के लिए, इन्वेंट्री > इन्वेंट्री सेटिंग पर क्लिक करें.

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

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

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

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

प्लेसमेंट

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

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

बिडिंग

ध्यान दें: InMobi डैशबोर्ड में बिडिंग को कॉन्फ़िगर करने का ऐक्सेस पाने के लिए, अपने खाता मैनेजर से संपर्क करें.

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

झरना

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

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

ध्यान दें: InMobi प्लेसमेंट आईडी, प्लेसमेंट के नाम के नीचे मौजूद होता है.

खाता आईडी

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

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

बिडिंग

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

झरना

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

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

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

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

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

ध्यान दें: टेस्ट मोड, सभी प्लेसमेंट के लिए डिफ़ॉल्ट रूप से बंद पर सेट रहता है. हालांकि, टेस्ट मोड को सभी ऐप्लिकेशन इंस्टेंस के प्लेसमेंट के लिए या सिर्फ़ आपके बताए गए डिवाइसों के लिए चालू किया जा सकता है.

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

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

Android

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

iOS

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

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

अहम जानकारी: पुष्टि करें कि आपके पास खाता मैनेजमेंट की अनुमति है, ताकि ईयू की सहमति और जीडीपीआर, सीपीआरए, और उपयोगकर्ता मैसेजिंग प्लैटफ़ॉर्म के लिए कॉन्फ़िगरेशन पूरा किया जा सके. ज़्यादा जानकारी के लिए, अपने खाते में उपयोगकर्ता के ऐक्सेस को मैनेज करना लेख पढ़ें.

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

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

ध्यान दें: InMobi और Google Mobile Ads SDK के साथ काम करने वाले वर्शन को इंटिग्रेट न करने पर, बिल्ड में समस्याएं आ सकती हैं.

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

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

dependencies:
  gma_mediation_inmobi: ^1.0.0

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

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

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

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

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

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

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

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

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

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

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

Android

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

iOS

SKAdNetwork इंटिग्रेशन

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

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

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

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

अहम जानकारी: ऐप्लिकेशन को रिलीज़ करने से पहले, AdMob और 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	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 की मदद से बनाया और टेस्ट किया गया है.