इस गाइड में बताया गया है कि मीडिएशन का इस्तेमाल करके, InMobi की मदद से विज्ञापन दिखाने और लोड करने के लिए, Google Mobile Ads SDK का इस्तेमाल कैसे किया जा सकता है. इसमें वॉटरफ़ॉल और बिडिंग इंटिग्रेशन, दोनों को शामिल किया जाता है. इसमें किसी विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में InMobi को जोड़ने का तरीका बताया गया है. साथ ही, InMobi SDK टूल और अडैप्टर को Flutter ऐप्लिकेशन में इंटिग्रेट करने का तरीका बताया गया है.
इस्तेमाल किए जा सकने वाले इंटिग्रेशन और विज्ञापन फ़ॉर्मैट
इंटिग्रेशन | |
---|---|
बिडिंग | 1 |
वॉटरफ़ॉल | |
फ़ॉर्मैट | |
बैनर | |
मध्यवर्ती | |
इनाम दिया गया | |
नेटिव लेआउट | 2 |
1 बिडिंग इंटिग्रेशन क्लोज़्ड बीटा वर्शन में है. ऐक्सेस का अनुरोध करने के लिए, अपने खाता मैनेजर से संपर्क करें.
2 यह सिर्फ़ वॉटरफ़ॉल मीडिएशन के साथ काम करती है.
ज़रूरी शर्तें
- नया Google Mobile Ads SDK
- Flutter 3.7.0 या इसके बाद का वर्शन
- Android पर डिप्लॉय करने के लिए
- Android API (एपीआई) लेवल 21 या उसके बाद का वर्शन
- iOS पर डिप्लॉय करने के लिए
- iOS का 10.0 या इससे ज़्यादा डिप्लॉयमेंट टारगेट
- Google मोबाइल विज्ञापन SDK की मदद से कॉन्फ़िगर किया गया Flutter एक चालू प्रोजेक्ट. ज़्यादा जानकारी के लिए, शुरू करें देखें.
- मीडिएशन को पूरा करें शुरुआती निर्देश
पहला चरण: InMobi यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगरेशन सेट अप करना
InMobi खाते के लिए साइन अप करें.
बिडिंग
Google ओपन बिडिंग के साथ InMobi SSP का इस्तेमाल करें चुनें और अपना Google पब्लिशर आईडी डालें.
झरना
वॉटरफ़ॉल इंटिग्रेशन के लिए, आपको अलग से कुछ करने की ज़रूरत नहीं है.
पुष्टि हो जाने के बाद, अपने InMobi खाते में लॉग इन करें.
ऐप्लिकेशन जोड़ें
अपने ऐप्लिकेशन को InMobi डैशबोर्ड में जोड़ने के लिए, इन्वेंट्री > इन्वेंट्री सेटिंग पर क्लिक करें.
इन्वेंट्री जोड़ें पर क्लिक करें और ड्रॉप-डाउन मेन्यू से, मोबाइल ऐप्लिकेशन चैनल चुनें.
खोज बार में, पब्लिश किए गए ऐप स्टोर का यूआरएल टाइप करें. इसके बाद, अपने-आप दिखने वाले नतीजों में से ऐप्लिकेशन चुनें. जारी रखें पर क्लिक करें.
अगर आपका ऐप्लिकेशन पब्लिश नहीं हुआ है, तो मैन्युअल तरीके से लिंक करें पर क्लिक करें और ज़रूरी जानकारी डालें. जारी रखें पर क्लिक करें.
ऐप्लिकेशन और वेबसाइट के अनुपालन की सेटिंग देखें. इसके बाद, प्लेसमेंट सेव करें और बनाएं पर क्लिक करें.
प्लेसमेंट
इन्वेंट्री सेट अप करने के बाद, सिस्टम आपको प्लेसमेंट बनाने के वर्कफ़्लो पर रीडायरेक्ट कर देता है.
बिडिंग
विज्ञापन यूनिट का टाइप चुनें. प्लेसमेंट का नाम डालें. इसके बाद, ऑडियंस बिडिंग और पार्टनर के लिए चालू करें और Google ओपन बिडिंग चुनें. इसके बाद, बाकी का फ़ॉर्म भरें. इसके बाद, प्लेसमेंट बनाएं पर क्लिक करें.
झरना
विज्ञापन यूनिट का टाइप चुनें. इसके बाद, प्लेसमेंट का नाम डालें और ऑडियंस बिडिंग के लिए बंद करें चुनें और बाकी का फ़ॉर्म भरें. इसके बाद, प्लेसमेंट बनाएं पर क्लिक करें.
प्लेसमेंट बनाने के बाद, उसका विवरण दिखाया जाता है. प्लेसमेंट आईडी पर ध्यान दें. इसका इस्तेमाल आपकीAdMob विज्ञापन यूनिट को सेट अप करने के लिए किया जाएगा.
खाता आईडी
आपका InMobi खाता आईडी, फ़ाइनेंस > पेमेंट सेटिंग > क्रेडिट/डेबिट कार्ड की जानकारी में उपलब्ध है.
InMobi रिपोर्टिंग एपीआई पासकोड का पता लगाएं
बिडिंग
बिडिंग इंटिग्रेशन के लिए यह चरण ज़रूरी नहीं है.
झरना
मेरा खाता > खाता सेटिंग पर जाएं. एपीआई पासकोड टैब पर जाएं और एपीआई पासकोड जनरेट करें पर क्लिक करें.
उस उपयोगकर्ता का ईमेल चुनें जिसके लिए कुंजी की ज़रूरत है और एपीआई पासकोड जनरेट करें पर क्लिक करें. API कुंजी और उपयोगकर्ता नाम/लॉगिन नाम वाली एक फ़ाइल जनरेट की जाएगी.
खाते का पब्लिशर एडमिन ही सभी उपयोगकर्ताओं के लिए एपीआई पासकोड जनरेट कर सकता है. अगर आपको पहले जनरेट की गई एपीआई पासकोड याद नहीं है, तो एपीआई पासकोड टैब में मौजूद अपने मेल पर कर्सर घुमाकर, अपनी एपीआई पासकोड को रीसेट करें.
टेस्ट मोड चालू करें
सभी लाइव इंप्रेशन या सिर्फ़ कुछ टेस्ट डिवाइसों पर अपने प्लेसमेंट के लिए, टेस्ट मोड चालू करें.
दूसरा चरण: AdMob यूज़र इंटरफ़ेस (यूआई) में InMobi की डिमांड सेट अप करना
अपनी विज्ञापन यूनिट के लिए मीडिएशन सेटिंग कॉन्फ़िगर करना
Android
निर्देशों के लिए, Android की गाइड में दूसरा चरण देखें.
iOS
निर्देशों के लिए, iOS की गाइड में दूसरा चरण देखें.
जीडीपीआर और अमेरिका के कानूनों के तहत, विज्ञापन पार्टनर की सूची में InMobi जोड़ें
जीडीपीआर सेटिंग और अमेरिका के कानूनों के बारे में सेटिंग में दिया गया तरीका अपनाएं, ताकि InMobi को जीडीपीआर और अमेरिका के कानूनों के बारे में बताने वाली विज्ञापन पार्टनर सूची में AdMob यूज़र इंटरफ़ेस (यूआई) जोड़ा जा सके.
तीसरा चरण: InMobi 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 मोबाइल विज्ञापन मीडिएशन प्लगिन का इस्तेमाल करके, InMobi SDK टूल को सहमति की जानकारी नहीं भेजी जा सकती है.
अमेरिका के निजता कानून
अमेरिका के निजता कानून उपयोगकर्ताओं को यह अधिकार देना ज़रूरी है कि वे अपनी "निजी जानकारी" को "बेचने" से ऑप्ट आउट कर सकें (जैसा कि कानून में उन शर्तों के बारे में बताया गया है). साथ ही, "बिक्री" पार्टी के होम पेज पर "मेरी निजी जानकारी न बेचें" लिंक से, "मेरी निजी जानकारी न बेचें" विकल्प से ऑप्ट-आउट करने का अधिकार देना ज़रूरी है. अमेरिका के निजता कानून के पालन से जुड़ी गाइड में, Google पर विज्ञापन दिखाने के लिए सीमित डेटा प्रोसेसिंग को चालू करने की सुविधा दी गई है. हालांकि, Google आपकी मीडिएशन चेन में हर विज्ञापन नेटवर्क पर यह सेटिंग लागू नहीं कर सकता. इसलिए, आपको अपनी मीडिएशन चेन में हर उस विज्ञापन नेटवर्क कंपनी की पहचान करनी होगी जो निजी जानकारी की बिक्री में हिस्सा ले सकती है. साथ ही, हर नेटवर्क के निर्देशों का पालन करना ज़रूरी है.
InMobi के लिए Google मोबाइल विज्ञापन मीडिएशन प्लगिन का इस्तेमाल करके, 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 Mobi सर्वर पैरामीटर मौजूद नहीं हैं या अमान्य हैं. |
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 Mobi सर्वर पैरामीटर मौजूद नहीं हैं या अमान्य हैं. |
102 | InMobi अडैप्टर, अनुरोध किए गए विज्ञापन फ़ॉर्मैट के साथ काम नहीं करता है. |
103 | इस नेटवर्क कॉन्फ़िगरेशन के लिए एक InMobi विज्ञापन पहले से ही लोड है. |
अन्य | InMobi SDK टूल में कोई गड़बड़ी मिली है. ज़्यादा जानकारी के लिए, IMRequestStatus.h पर जाएं. |
इनमोबी फ़्लूटर मीडिएशन एडैप्टर चेंजलॉग
1.0.0
- शुरुआती रिलीज़.
- इस बात की पुष्टि की गई है कि यह InMobi Android अडैप्टर के 10.6.7.1 वर्शन के साथ काम करता है.
- इस बात की पुष्टि कर दी गई है कि यह InMobi iOS अडैप्टर के 10.7.2.0 वर्शन के साथ काम करता है.
- Google Mobile Ads Flutter प्लगिन के 5.1.0 वर्शन से बनाया और टेस्ट किया गया.