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

प्लैटफ़ॉर्म चुनें: Android iOS Unity Flutter Android (लेगसी)

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

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

इंटिग्रेशन
बिडिंग
वॉटरफ़ॉल
फ़ॉर्मैट
ऐप का खुलना
बैनर
इंटरस्टीशियल विज्ञापन
इनाम वाले विज्ञापन
इनाम वाला इंटरस्टीशियल विज्ञापन
मूल भाषा वाला

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

जारी रखने से पहले, इनकी पुष्टि करें:

  • Google Mobile Ads Flutter Plugin का नया वर्शन.
  • Flutter फ़्रेमवर्क का वर्शन 3.7.0 या इसके बाद का वर्शन.
  • Android पर डिप्लॉय करने के लिए
    • Android एपीआई लेवल 24 या इसके बाद का वर्शन.
  • iOS पर डिप्लॉय करने के लिए
    • iOS डिप्लॉयमेंट का टारगेट 10.0 या इसके बाद का वर्शन होना चाहिए.
  • Google Mobile Ads Flutter Plugin के साथ कॉन्फ़िगर किया गया ऐसा Flutter प्रोजेक्ट जिस पर काम किया जा सकता हो. ज़्यादा जानकारी के लिए, Google Mobile Ads Flutter Plugin सेट अप करना लेख पढ़ें.
  • मीडिएशन सेट अप करें.

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

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

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

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

    InMobi डैशबोर्ड में अपना ऐप्लिकेशन जोड़ने के लिए, Inventory > Inventory Settings पर क्लिक करें.

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

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

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

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

    प्लेसमेंट

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

    बिडिंग

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

    वॉटरफ़ॉल

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

    प्लेसमेंट बनाने के बाद, उसकी जानकारी दिखती है. प्लेसमेंट आईडी को नोट करें. इसका इस्तेमाल, 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.3.3

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

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

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

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

    ईयू उपयोगकर्ता की सहमति से जुड़ी 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 के दस्तावेज़ पढ़ें.

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

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

    पक्का करें कि आपने 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" />

    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 का एक विज्ञापन पहले से लोड है.
    104 InMobi नेटिव विज्ञापन, नेटिव ऐसेट के बिना दिखाया गया या ज़रूरी इमेज ऐसेट डाउनलोड नहीं हो सकीं.
    105 InMobi का विज्ञापन दिखाने के लिए तैयार नहीं है.
    106 InMobi ने खाली या शून्य बिड टोकन भेजा है.
    अन्य InMobi SDK से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, IMRequestStatus.h पर जाएं.

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

    वर्शन 2.4.0 (डेवलेपमेंट में है)

    वर्शन 2.3.3

    वर्शन 2.3.2

    वर्शन 2.3.1

    वर्शन 2.3.0

    वर्शन 2.2.0

    वर्शन 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