इस गाइड में, मीडिएशन का इस्तेमाल करके, InMobi से विज्ञापन लोड करने और दिखाने के लिए, Google Mobile Ads SDK टूल का इस्तेमाल करने का तरीका बताया गया है. इसमें वॉटरफ़ॉल और बिडिंग इंटिग्रेशन, दोनों के बारे में बताया गया है. इसमें, विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में InMobi को जोड़ने का तरीका बताया गया है. साथ ही, Flutter ऐप्लिकेशन में InMobi SDK टूल और अडैप्टर को इंटिग्रेट करने का तरीका भी बताया गया है.
इस्तेमाल किए जा सकने वाले इंटिग्रेशन और विज्ञापन फ़ॉर्मैट
1 बिडिंग इंटिग्रेशन, ओपन बीटा वर्शन में है.
2 सिर्फ़ वॉटरफ़ॉल मीडिएशन के लिए काम करता है.
ज़रूरी शर्तें
- Google Mobile Ads SDK का सबसे नया वर्शन
- Flutter 3.7.0 या इसके बाद का वर्शन
- [बिडिंग के लिए]: बिडिंग में काम करने वाले सभी विज्ञापन फ़ॉर्मैट को इंटिग्रेट करने के लिए, InMobi 4.5.0 या इसके बाद के वर्शन के लिए Google Mobile Ads मीडिएशन प्लग इन का इस्तेमाल करें (नया वर्शन इस्तेमाल करने का सुझाव दिया जाता है)
- Android पर डिप्लॉय करने के लिए
- Android एपीआई लेवल 21 या उसके बाद का वर्शन
- iOS पर डिप्लॉय करने के लिए
- iOS डिप्लॉयमेंट टारगेट 10.0 या इसके बाद का होना चाहिए
- Google Mobile Ads SDK के साथ कॉन्फ़िगर किया गया, काम करने वाला Flutter प्रोजेक्ट. ज़्यादा जानकारी के लिए, शुरू करें लेख पढ़ें.
- मीडिएशन की प्रोसेस पूरी करें शुरुआती निर्देशों की गाइड
पहला चरण: InMobi यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगरेशन सेट अप करना
InMobi खाते के लिए साइन अप करें. खाता बनाते समय, Google की ओपन बिडिंग के साथ InMobi एसएसपी का इस्तेमाल करें विकल्प से सही का निशान हटाएं.
खाते की पुष्टि होने के बाद, लॉग इन करें.
ऐप्लिकेशन जोड़ें
अपने ऐप्लिकेशन को InMobi के डैशबोर्ड में जोड़ने के लिए, इन्वेंट्री > इन्वेंट्री सेटिंग पर क्लिक करें.
इन्वेंट्री जोड़ें पर क्लिक करें. इसके बाद, ड्रॉप-डाउन मेन्यू से मोबाइल ऐप्लिकेशन चैनल चुनें.
खोज बार में, पब्लिश किए गए ऐप्लिकेशन स्टोर का यूआरएल टाइप करना शुरू करें. इसके बाद, अपने-आप दिखने वाले नतीजों में से ऐप्लिकेशन चुनें. जारी रखें पर क्लिक करें.
अगर आपका ऐप्लिकेशन पब्लिश नहीं किया गया है, तो मैन्युअल तरीके से लिंक करें पर क्लिक करें और ज़रूरी जानकारी डालें. जारी रखें पर क्लिक करें.
ऐप्लिकेशन और वेबसाइट के लिए नीति का पालन करने से जुड़ी सेटिंग देखें. इसके बाद, सेव करें और प्लेसमेंट बनाएं पर क्लिक करें.
प्लेसमेंट
इन्वेंट्री सेट अप करने के बाद, सिस्टम आपको प्लेसमेंट बनाने के वर्कफ़्लो पर रीडायरेक्ट कर देता है.
विज्ञापन यूनिट का टाइप चुनें. प्लेसमेंट का नाम डालें. इसके बाद, ऑडियंस बिडिंग और पार्टनर के लिए, चालू है और Google ओपन बिडिंग को चुनें. इसके बाद, बाकी फ़ॉर्म भरें. इसके बाद, प्लेसमेंट बनाएं पर क्लिक करें.
विज्ञापन यूनिट का टाइप चुनें. इसके बाद, प्लेसमेंट का नाम डालें. ऑडियंस बिडिंग के लिए, बंद करें चुनें, और बाकी फ़ॉर्म भरें. इसके बाद, प्लेसमेंट बनाएं पर क्लिक करें.
प्लेसमेंट बनाने के बाद, उसकी जानकारी दिखती है. प्लेसमेंट आईडी को नोट करें. इसका इस्तेमाल, अपनी AdMob विज्ञापन यूनिट को सेट अप करने के लिए किया जाएगा.
खाता आईडी
आपका InMobi खाता आईडी, वित्त > पेमेंट सेटिंग > पेमेंट की जानकारी में उपलब्ध है.
InMobi Reporting API पासकोड ढूंढना
बिडिंग इंटिग्रेशन के लिए, यह चरण ज़रूरी नहीं है.
मेरा खाता > खाता सेटिंग पर जाएं. एपीआई पासकोड टैब पर जाएं और एपीआई पासकोड जनरेट करें पर क्लिक करें.
उस उपयोगकर्ता का ईमेल चुनें जिसके लिए पासकोड की ज़रूरत है. इसके बाद, एपीआई पासकोड जनरेट करें पर क्लिक करें. एपीआई कुंजी और उपयोगकर्ता नाम/लॉगिन नाम वाली एक फ़ाइल जनरेट होगी.
खाते का पब्लिशर एडमिन ही सभी उपयोगकर्ताओं के लिए एपीआई पासकोड जनरेट कर सकता है. अगर आपको पहले जनरेट की गई एपीआई कुंजी याद नहीं है, तो एपीआई कुंजी टैब पर अपने ईमेल पर कर्सर घुमाकर, अपनी एपीआई कुंजी रीसेट करें.
टेस्ट मोड चालू करना
सभी लाइव इंप्रेशन या सिर्फ़ कुछ टेस्ट डिवाइसों पर अपने प्लेसमेंट के लिए, टेस्ट मोड चालू करें.
दूसरा चरण: AdMob यूज़र इंटरफ़ेस (यूआई) में InMobi की मांग सेट अप करना
अपनी विज्ञापन यूनिट के लिए मीडिएशन सेटिंग कॉन्फ़िगर करना
निर्देशों के लिए, Android के लिए बनी गाइड में दूसरा चरण देखें.
निर्देशों के लिए, iOS के लिए बनी गाइड में दूसरा चरण देखें.
जीडीपीआर और अमेरिका के कानूनों के तहत विज्ञापन पार्टनर की सूची में InMobi को जोड़ना
AdMob के यूज़र इंटरफ़ेस (यूआई) में, यूरोप और अमेरिका के कानूनों के तहत विज्ञापन पार्टनर की सूची में InMobi को जोड़ने के लिए, यूरोप के कानूनों की सेटिंग और अमेरिका के कानूनों की सेटिंग में दिया गया तरीका अपनाएं.
तीसरा चरण: InMobi SDK और अडैप्टर इंपोर्ट करना
pub.dev की मदद से इंटिग्रेशन करना
अपने पैकेज की pubspec.yaml फ़ाइल में, InMobi SDK टूल और अडैप्टर के नए वर्शन के साथ यह डिपेंडेंसी जोड़ें:
dependencies:
gma_mediation_inmobi: ^1.1.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 Mobile Ads का मीडिएशन प्लग इन, InMobi SDK टूल को सहमति की जानकारी पास करने की सुविधा नहीं देता.
पांचवां चरण: ज़रूरी अतिरिक्त कोड जोड़ना
InMobi इंटिग्रेशन के लिए, किसी अन्य कोड की ज़रूरत नहीं होती.
SKAdNetwork इंटिग्रेशन
अपने प्रोजेक्ट की Info.plist फ़ाइल में SKAdNetwork आइडेंटिफ़ायर जोड़ने के लिए, InMobi के दस्तावेज़ का पालन करें.
छठा चरण: लागू किए गए बदलावों की जांच करना
टेस्ट विज्ञापन चालू करना
पक्का करें कि आपने AdMob के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो. साथ ही, 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" />
आपके पास Plugins/Android/GoogleMobileAdsInMobiMediation/AndroidManifest.xml फ़ाइल में ये अनुमतियां जोड़ने का विकल्प है.
iOS इंटिग्रेशन के लिए, आपको कुछ और नहीं करना होगा.
गड़बड़ी के कोड
अगर अडैप्टर को InMobi से कोई विज्ञापन नहीं मिलता है, तो पब्लिशर इन क्लास के तहत ResponseInfo का इस्तेमाल करके, विज्ञापन रिस्पॉन्स से जुड़ी गड़बड़ी की जांच कर सकते हैं:
com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter
GADMAdapterInMobi
GADMediationAdapterInMobi
जब कोई विज्ञापन लोड नहीं होता है, तो InMobi अडैप्टर से ये कोड और मैसेज मिलते हैं:
| गड़बड़ी का कोड | कारण |
|---|---|
| 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 की नेटिव विज्ञापन इमेज ऐसेट डाउनलोड नहीं कर सका. |
| गड़बड़ी का कोड | कारण |
|---|---|
| 101 | AdMob यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगर किए गए InMobi सर्वर पैरामीटर मौजूद नहीं हैं या अमान्य हैं. |
| 102 | InMobi अडैप्टर, अनुरोध किए गए विज्ञापन फ़ॉर्मैट के साथ काम नहीं करता. |
| 103 | इस नेटवर्क कॉन्फ़िगरेशन के लिए, InMobi विज्ञापन पहले से लोड हो चुका है. |
| अन्य | InMobi SDK से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, IMRequestStatus.h पर जाएं. |
InMobi Flutter मीडिएशन अडैप्टर का बदलाव लॉग
1.1.0
- iOS प्लगिन अब एक स्टैटिक फ़्रेमवर्क है.
- InMobi के Android अडैप्टर के 10.8.0.0 वर्शन के साथ काम करने की पुष्टि की गई है.
- InMobi iOS अडैप्टर के वर्शन 10.8.0.0 के साथ काम करने की पुष्टि की गई है.
- Google Mobile Ads Flutter प्लग इन के 5.3.1 वर्शन के साथ बनाया और टेस्ट किया गया.
1.0.0
- शुरुआती रिलीज़.
- InMobi Android अडैप्टर के 10.6.7.1 वर्शन के साथ काम करने की पुष्टि की गई है.
- InMobi iOS अडैप्टर के वर्शन 10.7.2.0 के साथ काम करने की पुष्टि की गई है.
- Google Mobile Ads Flutter प्लग इन के 5.1.0 वर्शन के साथ बनाया और टेस्ट किया गया.