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

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

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

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

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

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

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

  • Google Mobile Ads Unity Plugin का नया वर्शन.
  • Unity Editor का वर्शन 4 या इसके बाद का वर्शन.
  • [बिडिंग के लिए]: बिडिंग में, विज्ञापन के सभी फ़ॉर्मैट इंटिग्रेट करने के लिए, InMobi 4.5.0 या इसके बाद के वर्शन के लिए, Google Mobile Ads मीडिएशन प्लगिन का इस्तेमाल करें (नए वर्शन का सुझाव दिया जाता है).
  • Android पर डिप्लॉय करने के लिए
    • Android एपीआई लेवल 24 या इसके बाद का वर्शन.
  • iOS पर डिप्लॉय करने के लिए
    • iOS डिप्लॉयमेंट का टारगेट 10.0 या इसके बाद का वर्शन होना चाहिए.
  • Google Mobile Ads Unity Plugin के साथ कॉन्फ़िगर किया गया ऐसा Unity प्रोजेक्ट जिस पर काम किया जा सकता हो. ज़्यादा जानकारी के लिए, Google Mobile Ads Unity Plugin सेट अप करना लेख पढ़ें.
  • मीडिएशन सेट अप करें.

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

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

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

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

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

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

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

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

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

    प्लेसमेंट

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

    बिडिंग

    विज्ञापन यूनिट का टाइप चुनें. इसके बाद, प्लेसमेंट का नाम डालें. साथ ही, ऑडियंस बिडिंग के लिए चालू है और 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 और अडैप्टर को इंपोर्ट करना

    OpenUPM-CLI

    अगर आपके पास OpenUPM-CLI इंस्टॉल है, तो अपने प्रोजेक्ट की रूट डायरेक्ट्री से यह कमांड चलाकर, Unity के लिए Google Mobile Ads InMobi मीडिएशन प्लग इन को अपने प्रोजेक्ट में इंस्टॉल किया जा सकता है:

    openupm add com.google.ads.mobile.mediation.inmobi

    OpenUPM

    Unity Package Manager Settings खोलने के लिए, Unity प्रोजेक्ट एडिटर में Edit > Project Settings > Package Manager चुनें.

    स्कोप की गई रजिस्ट्रियां टैब में जाकर, OpenUPM को स्कोप की गई रजिस्ट्री के तौर पर जोड़ें. इसके लिए, यह जानकारी दें:

    • नाम: OpenUPM
    • URL: https://package.openupm.com
    • स्कोप: com.google

    OpenUPM की जानकारी

    इसके बाद, Window > Package Manager पर जाकर, Unity Package Manager खोलें. इसके बाद, ड्रॉप-डाउन मेन्यू से My Registries चुनें.

    Unity Registries

    Google Mobile Ads InMobi Mediation पैकेज चुनें और Install पर क्लिक करें.

    OpenUPM से इंस्टॉल करना

    Unity पैकेज

    बदलाव की जानकारी में दिए गए डाउनलोड करने के लिंक से, InMobi के लिए Google Mobile Ads मीडिएशन प्लगिन का नया वर्शन डाउनलोड करें. इसके बाद, ZIP फ़ाइल से GoogleMobileAdsInMobiMediation.unitypackage को एक्सट्रैक्ट करें.

    अपने Unity प्रोजेक्ट एडिटर में, Assets > Import Package > Custom Package को चुनें. इसके बाद, डाउनलोड की गई GoogleMobileAdsInMobiMediation.unitypackage फ़ाइल को ढूंढें. पक्का करें कि सभी फ़ाइलें चुनी गई हों. इसके बाद, इंपोर्ट करें पर क्लिक करें.

    Unity से इंपोर्ट करना

    इसके बाद, ऐसेट > External Dependency Manager > Android Resolver > Force Resolve को चुनें. एक्सटर्नल डिपेंडेंसी मैनेजर लाइब्रेरी, डिपेंडेंसी रिज़ॉल्यूशन को शुरू से पूरा करेगी. साथ ही, एलान की गई डिपेंडेंसी को आपके Unity ऐप्लिकेशन की Assets/Plugins/Android डायरेक्ट्री में कॉपी करेगी.

    समस्या को ज़बरदस्ती हल करना

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

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

    InMobi Unity मीडिएशन प्लगिन के वर्शन 4.6.4 से, InMobi अपने-आप जीडीपीआर के तहत सहमति से जुड़े डेटा को पढ़ता है. यह डेटा, सहमति मैनेज करने वाले उन प्लैटफ़ॉर्म से मिलता है जो Google की अतिरिक्त सहमति से जुड़ी खास जानकारी के साथ काम करते हैं. इनमें UMP SDK भी शामिल है. ज़्यादा जानकारी के लिए, Android और iOS के लिए SDK टूल को शुरू करने के बारे में InMobi का दस्तावेज़ देखें.

    अमेरिका के राज्यों के निजता कानून

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

    InMobi के लिए सीसीपीए सेटिंग चालू करने के दिशा-निर्देशों के लिए, InMobi का सीसीपीए दस्तावेज़ देखें.

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

    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" />

    आपके पास 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 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 Unity Mediation Plugin के बदलावों का लॉग

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

    वर्शन 5.3.3

    वर्शन 5.3.2

    वर्शन 5.3.1

    वर्शन 5.3.0

    वर्शन 5.2.0

    वर्शन 5.1.0

    वर्शन 5.0.2

    वर्शन 5.0.1

    वर्शन 5.0.0

    वर्शन 4.7.7

    वर्शन 4.7.6

    वर्शन 4.7.5

    वर्शन 4.7.4

    वर्शन 4.7.3

    वर्शन 4.7.2

    वर्शन 4.7.1

    वर्शन 4.7.0

    वर्शन 4.6.7

    वर्शन 4.6.6

    वर्शन 4.6.5

    वर्शन 4.6.4

    वर्शन 4.6.3

    वर्शन 4.6.2

    वर्शन 4.6.1

    वर्शन 4.6.0

    वर्शन 4.5.1

    वर्शन 4.5.0

    वर्शन 4.4.1

    वर्शन 4.4.0

    वर्शन 4.3.3

    वर्शन 4.3.0

    • अडैप्टर के कॉन्टेंट को GoogleMobileAds/Mediation/InMobi/ में ले जाया गया.
    • GoogleMobileAds.Mediation.InMobi का इस्तेमाल करने के लिए, अडैप्टर नेमस्पेस को फिर से व्यवस्थित किया गया है.
    • InMobi Android अडैप्टर के 10.5.4.1 वर्शन के साथ काम करता है.
    • InMobi iOS अडैप्टर के 10.5.4.0 वर्शन के साथ काम करता है.
    • इसे Google Mobile Ads Unity प्लगिन के 8.1.0 वर्शन के साथ बनाया और टेस्ट किया गया है.

    वर्शन 4.2.2

    वर्शन 4.2.1

    वर्शन 4.2.0

    वर्शन 4.1.0

    वर्शन 4.0.4

    वर्शन 4.0.3

    वर्शन 4.0.2

    वर्शन 4.0.1

    वर्शन 4.0.0

    वर्शन 3.2.0

    वर्शन 3.1.2

    वर्शन 3.1.1

    वर्शन 3.1.0

    वर्शन 3.0.3

    वर्शन 3.0.2

    वर्शन 3.0.1

    वर्शन 3.0.0

    वर्शन 2.4.0

    वर्शन 2.3.0

    • Android अडैप्टर के 7.2.9.0 वर्शन के साथ काम करता है.
    • यह iOS अडैप्टर के 7.3.2.0 वर्शन के साथ काम करता है.

    वर्शन 2.2.2

    • इनाम वाले नए एपीआई के साथ काम करने के लिए, प्लग इन को अपडेट किया गया.
    • यह Android अडैप्टर के 7.2.7.0 वर्शन के साथ काम करता है.
    • iOS अडैप्टर के 7.2.7.0 वर्शन के साथ काम करता है.

    वर्शन 2.2.1

    • यह Android अडैप्टर के 7.2.2.0 वर्शन के साथ काम करता है.
    • iOS अडैप्टर के 7.2.4.0 वर्शन के साथ काम करता है.

    वर्शन 2.2.0

    • यह Android अडैप्टर के 7.2.1.0 वर्शन के साथ काम करता है.
    • यह iOS अडैप्टर के 7.2.0.0 वर्शन के साथ काम करता है.

    वर्शन 2.1.2

    • यह Android अडैप्टर के 7.1.1.1 वर्शन के साथ काम करता है.
    • यह iOS अडैप्टर के 7.1.2.0 वर्शन के साथ काम करता है.

    वर्शन 2.1.1

    • Android अडैप्टर के 7.1.1.1 वर्शन के साथ काम करता है.
    • यह iOS अडैप्टर के 7.1.1.2 वर्शन के साथ काम करता है.

    वर्शन 2.1.0

    • यह Android अडैप्टर के 7.1.0.0 वर्शन के साथ काम करता है.
    • यह iOS अडैप्टर के 7.1.1.1 वर्शन के साथ काम करता है.
    • InMobi.UpdateGDPRConsent() तरीका जोड़ा गया.

    वर्शन 2.0.0

    • यह Android अडैप्टर के 7.0.4.0 वर्शन के साथ काम करता है.
    • यह iOS अडैप्टर के 7.1.1.0 वर्शन के साथ काम करता है.

    वर्शन 1.0.0

    • पहली रिलीज़!
    • Android अडैप्टर के 6.2.4.0 वर्शन के साथ काम करता है.
    • यह iOS अडैप्टर के 6.2.1.0 वर्शन के साथ काम करता है.