InMobi को AdMob मीडिएशन (अलग-अलग नेटवर्क से विज्ञापन दिखाना) के साथ इंटिग्रेट करना

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

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

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

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

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

  • Google Mobile Ads SDK for React Native का नया वर्शन.
  • React Native फ़्रेमवर्क का वर्शन 0.85.0 या इसके बाद का वर्शन.
  • Android पर डिप्लॉय करने के लिए
    • Android एपीआई लेवल 24 या इसके बाद का वर्शन.
  • iOS पर डिप्लॉय करने के लिए
    • iOS डिप्लॉयमेंट का टारगेट 10.0 या इसके बाद का वर्शन होना चाहिए.
  • Google Mobile Ads SDK for React Native के साथ कॉन्फ़िगर किया गया ऐसा React Native प्रोजेक्ट जिस पर काम किया जा सकता हो. ज़्यादा जानकारी के लिए, Google Mobile Ads SDK for React Native सेट अप करना लेख पढ़ें.
    • पक्का करें कि आपने gma-sdk-react-native फ़ोल्डर से adapters फ़ोल्डर को डाउनलोड और एक्सट्रैक्ट कर लिया हो. अगर आपके पास adapters फ़ोल्डर नहीं है, तो Google Mobile Ads SDK for React Native इंस्टॉल करें में जाकर, पहला, दूसरा, और तीसरा चरण अपनाएं.
  • AdMob मीडिएशन सेट अप करें.

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

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

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

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

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

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

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

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

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

प्लेसमेंट

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

बिडिंग

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

वॉटरफ़ॉल

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

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

खाता आईडी

आपका InMobi खाता आईडी, फ़ाइनेंस > पेमेंट सेटिंग > पेमेंट की जानकारी में मौजूद होता है.

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

बिडिंग

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

वॉटरफ़ॉल

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

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

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

app-ads.txt फ़ाइल अपडेट करना

ऐप्लिकेशन के लिए, अनुमति वाले सेलर (app-ads.txt), IAB Tech Lab की एक पहल है. इसकी मदद से यह पक्का किया जा सकता है कि आपके ऐप्लिकेशन की विज्ञापन इन्वेंट्री सिर्फ़ वे चैनल बेचें जिन्हें आपने अनुमति दी है. विज्ञापन से मिलने वाले रेवेन्यू में ज़्यादा नुकसान न हो, इसके लिए आपको app-ads.txt फ़ाइल लागू करनी होगी. अगर आपने अब तक ऐसा नहीं किया है, तो अपने ऐप्लिकेशन के लिए app-ads.txt फ़ाइल सेट अप करें.

InMobi के लिए app-ads.txt लागू करने के लिए, अपनी ज़रूरत के हिसाब से बनाया गया कोड स्निपेट जोड़ें.

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

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

दूसरा चरण: AdMob के यूआई में InMobi की डिमांड सेट अप करना

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

Android

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

iOS

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

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

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

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

अपने प्रोजेक्ट की रूट डायरेक्ट्री में, InMobi के लिए Google Mobile Ads SDK for React Native मीडिएशन अडैप्टर इंस्टॉल करें. नीचे दिए गए कदमों को पूरा करें:

  1. Google Mobile Ads SDK for React Native अडैप्टर की tar फ़ाइल को gma-sdk-react-native/adapters/inmobi/ डायरेक्ट्री से अपने प्रोजेक्ट की local_packages/ डायरेक्ट्री में कॉपी करें. अगर आपके पास adapters फ़ोल्डर नहीं है, तो ज़रूरी शर्तें देखें.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/inmobi/gma-mediation-inmobi-0.1.0.tgz local_packages/

    EXTRACT_DIR को उस डायरेक्ट्री के पाथ से बदलें जहां आपने संग्रह को एक्सट्रैक्ट किया है.

  2. अपने पसंदीदा पैकेज मैनेजर का इस्तेमाल करके, अडैप्टर पैकेज इंस्टॉल करें:

    npm

    npm install ./local_packages/gma-mediation-inmobi-0.1.0.tgz

    ऊन

    yarn add ./local_packages/gma-mediation-inmobi-0.1.0.tgz

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

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

InMobi React Native अडैप्टर का वर्शन 0.1.0 और इसके बाद के वर्शन, जीडीपीआर के तहत सहमति के सिग्नल पास करने की सुविधा देते हैं. ये सिग्नल, सहमति मैनेजमेंट प्लैटफ़ॉर्म से InMobi SDK टूल को पास किए जाते हैं. ये प्लैटफ़ॉर्म, IAB के पारदर्शिता और सहमति फ़्रेमवर्क (टीसीएफ़) के साथ इंटिग्रेट होते हैं. ज़्यादा जानकारी के लिए, जीडीपीआर देखें.

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

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

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

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

Android

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

iOS

SKAdNetwork इंटिग्रेशन

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

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

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

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

टेस्ट विज्ञापनों की पुष्टि करना

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

वैकल्पिक चरण

नेटवर्क के हिसाब से पैरामीटर

InMobi अडैप्टर, विज्ञापन दिखाने के अनुरोध में InMobiMediationExtras ऑब्जेक्ट को पास करने की सुविधा देता है, ताकि नेटवर्क के हिसाब से पैरामीटर सेट किए जा सकें. उपलब्ध पैरामीटर के बारे में ज़्यादा जानकारी के लिए, InMobi का रेफ़रंस दस्तावेज़ देखें.

यहां दिए गए सैंपल कोड से, InMobi के लिए टारगेटिंग और लॉगिंग पैरामीटर को कॉन्फ़िगर करने का तरीका पता चलता है:

import {
  InMobiMediationExtras,
  InMobiAgeGroup,
  InMobiEducation,
  InMobiLogLevel,
} from '@google/gma-mediation-inmobi';

const request = {
  // ...
  mediationExtras: [
    new InMobiMediationExtras({
      ageGroup: InMobiAgeGroup.BETWEEN_25_AND_29,
      education: InMobiEducation.COLLEGE_OR_GRADUATE,
      logLevel: InMobiLogLevel.DEBUG,
      age: 25,
      postalCode: '12345',
      areaCode: '678',
      language: 'en',
      city: 'NY',
      state: 'NY',
      country: 'US',
      interests: 'sports',
    }),
  ],
};

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

वर्शन 0.1.0

  • शुरुआती रिलीज़.