इस गाइड में बताया गया है कि GMA Next-Gen SDK का इस्तेमाल करके, AdMob मीडिएशन (अलग-अलग नेटवर्क से विज्ञापन दिखाना) की मदद से i-mobile से विज्ञापन लोड करने और दिखाने का तरीका क्या है. इसमें वॉटरफ़ॉल इंटिग्रेशन शामिल हैं. इसमें बताया गया है कि किसी विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में i-mobile को कैसे जोड़ा जाता है. साथ ही, किसी Android ऐप्लिकेशन में i-mobile SDK और अडैप्टर को कैसे इंटिग्रेट किया जाता है.
i-mobile के डैशबोर्ड इंटरफ़ेस में लेबल, बटन, और जानकारी जैपनीज़ भाषा में दिखती है. इस गाइड में मौजूद किसी भी स्क्रीनशॉट का अनुवाद नहीं किया गया है. हालांकि, इस गाइड के ब्यौरे और निर्देशों में, लेबल और बटन का अनुवाद हिन्दी भाषा में ब्रैकेट में दिया गया है.
इस्तेमाल किए जा सकने वाले इंटिग्रेशन और विज्ञापन फ़ॉर्मैट
i-mobile के लिए मीडिएशन अडैप्टर में ये सुविधाएं उपलब्ध हैं:
| इंटिग्रेशन | |
|---|---|
| बिडिंग | |
| वॉटरफ़ॉल | |
| फ़ॉर्मैट | |
| बैनर वाले विज्ञापन | |
| इंटरस्टीशियल विज्ञापन | |
| इनाम वाले विज्ञापन | |
| मूल भाषा वाला | |
ज़रूरी शर्तें
जारी रखने से पहले, इनकी पुष्टि करें:
- Android एपीआई लेवल 24 या इसके बाद का वर्शन.
GMA Next-Gen SDK का नया वर्शन.
पहला चरण: i-mobile के यूआई में कॉन्फ़िगरेशन सेट अप करना
अपने i-mobile खाते में साइन अप या लॉग इन करें.
サイト/アプリ管理 (साइट/ऐप्लिकेशन मैनेजमेंट) टैब और अपने ऐप्लिकेशन के प्लैटफ़ॉर्म के बटन पर क्लिक करके i-mobile डैशबोर्ड में अपना ऐप्लिकेशन जोड़ें.
फ़ॉर्म भरें और 新規登録 (साइन अप करें) बटन पर क्लिक करें.
नया विज्ञापन स्पॉट बनाने के लिए, サイト/アプリ管理 (साइट/ऐप्लिकेशन मैनेजमेंट) टैब में जाकर अपना ऐप्लिकेशन चुनें.
広告スポット管理 (विज्ञापन स्पॉट मैनेजमेंट) टैब पर जाएं और 新規広告スポット (नया विज्ञापन स्पॉट) बटन पर क्लिक करें.
इसके बाद, 広告スポット名 (विज्ञापन स्पॉट का नाम), 広告スポットサイズ (विज्ञापन स्पॉट का साइज़), और अन्य जानकारी देकर फ़ॉर्म भरें. इसके बाद, 新規登録 (साइन अप करें) बटन पर क्लिक करें.
आपका नया विज्ञापन स्पॉट तैयार है. इसके इंटिग्रेशन की जानकारी देखने के लिए, アプリ設定取得 (ऐप्लिकेशन की सेटिंग देखें) बटन पर क्लिक करें.
パブリッシャーआईडी (पब्लिशर आईडी), メディアआईडी (मीडिया आईडी), और スポットआईडी (स्पॉट आईडी) को नोट करें. आपको इन पैरामीटर की ज़रूरत AdMob के यूज़र इंटरफ़ेस में मीडिएशन के लिए i-mobile को कॉन्फ़िगर करते समय होगी.
app-ads.txt फ़ाइल अपडेट करना
ऐप्लिकेशन के लिए, अनुमति वाले सेलर (app-ads.txt), IAB Tech Lab की एक पहल है. इसकी मदद से यह पक्का किया जा सकता है कि आपके ऐप्लिकेशन की विज्ञापन इन्वेंट्री सिर्फ़ वे चैनल बेचें जिन्हें आपने अनुमति दी है. विज्ञापन से मिलने वाले रेवेन्यू में ज़्यादा नुकसान न हो, इसके लिए आपको app-ads.txt फ़ाइल लागू करनी होगी.
अगर आपने अब तक ऐसा नहीं किया है, तो
अपने ऐप्लिकेशन के लिए app-ads.txt फ़ाइल सेट अप करें.
i-mobile के लिए app-ads.txt लागू करने के लिए, उनके अक्सर पूछे जाने वाले सवाल देखें.
दूसरा चरण: AdMob के यूआई में i-mobile की डिमांड सेट अप करना
अपनी विज्ञापन यूनिट के लिए मीडिएशन सेटिंग कॉन्फ़िगर करना
आपको अपनी विज्ञापन यूनिट के लिए, मीडिएशन कॉन्फ़िगरेशन में i-mobile को जोड़ना होगा.
सबसे पहले, अपने AdMob खाते में साइन इन करें. इसके बाद, मीडिएशन टैब पर जाएं. अगर आपको किसी मौजूदा मीडिएशन ग्रुप में बदलाव करना है, तो उस मीडिएशन ग्रुप के नाम पर क्लिक करके उसमें बदलाव करें. इसके बाद, i-mobile को विज्ञापन सोर्स के तौर पर जोड़ें पर जाएं.
नया मीडिएशन ग्रुप बनाने के लिए, मीडिएशन ग्रुप बनाएं को चुनें.

विज्ञापन फ़ॉर्मैट और प्लैटफ़ॉर्म की जानकारी डालें. इसके बाद, जारी रखें पर क्लिक करें.

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

इस मीडिएशन ग्रुप को अपनी मौजूदा AdMob विज्ञापन यूनिट में से एक या इससे ज़्यादा विज्ञापन यूनिट से जोड़ें. इसके बाद, हो गया पर क्लिक करें.

अब आपको विज्ञापन यूनिट का कार्ड दिखेगा. इसमें आपको वे विज्ञापन यूनिट दिखेंगी जिन्हें आपने चुना था:

i-mobile को विज्ञापन सोर्स के तौर पर जोड़ना
विज्ञापन सोर्स सेक्शन में मौजूद, वॉटरफ़ॉल कार्ड में जाकर, विज्ञापन सोर्स जोड़ें को चुनें.
i-mobile को चुनें और ऑप्टिमाइज़ करें स्विच को चालू करें. i-mobile के लिए विज्ञापन सोर्स ऑप्टिमाइज़ेशन सेट अप करने के लिए, पिछले सेक्शन में मिला लॉगिन नेम और एपीआई पासवर्ड डालें. इसके बाद, i-mobile के लिए ईसीपीएम वैल्यू डालें और जारी रखें पर क्लिक करें.

अगर आपने i-mobile के लिए पहले से कोई मैपिंग की हुई है, तो उसे चुना जा सकता है. अगर ऐसा नहीं है, तो मैपिंग जोड़ें पर क्लिक करें.

इसके बाद, पिछले सेक्शन में मिला पब्लिशर आईडी, मीडिया आईडी, और स्पॉट आईडी डालें. इसके बाद, हो गया पर क्लिक करें.

तीसरा चरण: i-mobile SDK और अडैप्टर को इंपोर्ट करना
Android Studio इंटिग्रेशन (सुझाया गया)
अपने प्रोजेक्ट-लेवल की settings.gradle.kts फ़ाइल में, ये रिपॉज़िटरी जोड़ें:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile.github.io/adnw-sdk-android")
}
}
}
अपने ऐप्लिकेशन-लेवल की gradle फ़ाइल में, लागू करने से जुड़ी ये डिपेंडेंसी और कॉन्फ़िगरेशन जोड़ें:
Kotlin
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0") implementation("com.google.ads.mediation:imobile:2.3.2.5") } configurations.configureEach { exclude(group = "com.google.android.gms", module = "play-services-ads") exclude(group = "com.google.android.gms", module = "play-services-ads-lite") }
ग्रूवी
dependencies { implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0' implementation 'com.google.ads.mediation:imobile:2.3.2.5' } configurations.configureEach { exclude group: 'com.google.android.gms', module: 'play-services-ads' exclude group: 'com.google.android.gms', module: 'play-services-ads-lite' }
मैन्युअल इंटिग्रेशन
i-mobile SDK का नया वर्शन डाउनलोड करें. इसके बाद,
sdkफ़ोल्डर में मौजूदandroid-ad-sdk.aarको एक्सट्रैक्ट करें और उसे अपने प्रोजेक्ट में जोड़ें.Google की Maven रिपॉज़िटरी में, i-mobile अडैप्टर आर्टफ़ैक्ट पर जाएं. नया वर्शन चुनें, i-mobile अडैप्टर की
.aarफ़ाइल डाउनलोड करें, और उसे अपने प्रोजेक्ट में जोड़ें.
चौथा चरण: ज़रूरी कोड जोड़ना
गतिविधि के संदर्भ के साथ विज्ञापन लोड करना
बैनर, इंटरस्टीशियल, इनाम वाले, और नेटिव विज्ञापन फ़ॉर्मैट लोड करते समय, Activity कॉन्टेक्स्ट पास करें.गतिविधि के कॉन्टेक्स्ट के बिना, विज्ञापन लोड होने की प्रोसेस पूरी नहीं होगी.
पांचवां चरण: लागू किए गए बदलावों की जांच करना
टेस्ट विज्ञापनों को चालू करना
पक्का करें कि आपने AdMob के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो. i-mobile, टेस्टिंग के लिए टेस्ट स्पॉट आईडी, मीडिया आईडी, और पब्लिशर आईडी उपलब्ध कराता है. इन्हें यहां देखा जा सकता है.
टेस्ट विज्ञापनों की पुष्टि करना
यह पुष्टि करने के लिए कि आपको i-mobile से टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन जांचने वाले टूल में i-mobile (वॉटरफ़ॉल) विज्ञापन सोर्स का इस्तेमाल करके, विज्ञापन के किसी एक सोर्स को टेस्ट करना चालू करें.
वैकल्पिक चरण
नेटिव विज्ञापनों का इस्तेमाल करना
विज्ञापन रेंडरिंग
i-mobile अडैप्टर,
NativeAd
के लिए,
नेटिव ऐड ऐडवांस के फ़ील्ड की जानकारी
भरता है.
| फ़ील्ड | i-mobile अडैप्टर में हमेशा शामिल की जाने वाली ऐसेट |
|---|---|
| हेडलाइन | |
| इमेज | |
| Body | |
| ऐप्लिकेशन का आइकॉन | 1 |
| कॉल-टू-ऐक्शन | |
| स्टार रेटिंग | |
| स्टोर | |
| कीमत |
1 नेटिव विज्ञापनों के लिए, i-mobile SDK टूल, ऐप्लिकेशन आइकॉन ऐसेट उपलब्ध नहीं कराता. इसके बजाय, i-mobile अडैप्टर, ऐप्लिकेशन के आइकॉन को पारदर्शी इमेज से भर देता है.
गड़बड़ी के कोड
अगर अडैप्टर को i-mobile से विज्ञापन नहीं मिलता है, तो पब्लिशर, विज्ञापन के जवाब में हुई गड़बड़ी की जानकारी देखने के लिए, इनमें से किसी क्लास के हिसाब से ResponseInfo.getAdSourceResponses() का इस्तेमाल कर सकते हैं:
| फ़ॉर्मैट | क्लास का नाम |
|---|---|
| बैनर | com.google.ads.mediation.imobile.IMobileAdapter |
| इंटरस्टीशियल | com.google.ads.mediation.imobile.IMobileAdapter |
| नेटिव | com.google.ads.mediation.imobile.IMobileMediationAdapter |
विज्ञापन लोड न होने पर, i-mobile अडैप्टर से मिलने वाले कोड और उनसे जुड़े मैसेज यहां दिए गए हैं:
| गड़बड़ी का कोड | कारण |
|---|---|
| 0-99 | i-mobile SDK टूल से गड़बड़ी का मैसेज मिला. ज़्यादा जानकारी के लिए, कोड देखें. |
| 101 | i-mobile को विज्ञापन लोड करने के लिए, Activity कॉन्टेक्स्ट की ज़रूरत होती है. |
| 102 | AdMob के यूज़र इंटरफ़ेस में कॉन्फ़िगर किए गए i-mobile सर्वर पैरामीटर मौजूद नहीं हैं या मान्य नहीं हैं. |
| 103 | जिस विज्ञापन साइज़ का अनुरोध किया गया है वह i-mobile के साथ काम करने वाले बैनर के साइज़ से मेल नहीं खाता है. |
| 104 | i-mobile के नेटिव विज्ञापन लोड होने की प्रोसेस पूरी होने के कॉलबैक ने, नेटिव विज्ञापनों की खाली सूची दिखाई. |
| 105 | अनुरोध में उम्र से जुड़ी पाबंदी के आधार पर विज्ञापन दिखाने की सेटिंग थी. हालांकि, i-mobile SDK को उम्र से जुड़ी पाबंदी के सिग्नल नहीं मिल सकते |
i-mobile Android मीडिएशन अडैप्टर के बदलावों का लॉग
अगला वर्शन
InitializationCompleteCallback.onInitializationFailed(AdError)एपीआई का इस्तेमाल करने के लिए, अडैप्टर को अपडेट किया गया.- Android के ज़रूरी एपीआई लेवल को 24 पर अपडेट किया गया है.
- उस समस्या को ठीक किया गया है जिसकी वजह से इंटरस्टीशियल विज्ञापन लोड होने और प्रज़ेंटेशन कॉलबैक को फ़ॉरवर्ड नहीं किया जा रहा था. ऐसा इसलिए हो रहा था, क्योंकि i-mobile SDK टूल के साथ एक खाली लिसनर रजिस्टर किया गया था.
वर्शन 2.3.2.5
- अडैप्टर की Kotlin डिपेंडेंसी को 1.9.0 पर पिन करें. यह GMA NextGen SDK के साथ काम करने वाला Kotlin का सबसे पुराना वर्शन है.
- विज्ञापन शुरू करने और विज्ञापन लोड करने के अनुरोधों के दौरान, उम्र से जुड़ी पाबंदी की वजह से फ़ेल होने वाली ब्रांच पर, फ़ॉल-थ्रू व्यवहार को ठीक किया गया.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 25.4.0.
- Google Mobile Ads Next-Gen SDK का वर्शन 1.4.0.
- i-mobile SDK का वर्शन 2.3.2.
वर्शन 2.3.2.4
- जब नया
AgeRestrictedTreatment,CHILDपर सेट हो, तब i-mobile SDK के लिए, उम्र से जुड़ी पाबंदी वाले अनुरोधों को फ़िल्टर करें.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 25.4.0.
- Google Mobile Ads Next-Gen SDK का वर्शन 1.2.0.
- i-mobile SDK का वर्शन 2.3.2.
वर्शन 2.3.2.3
- i-mobile SDK के लिए, उम्र से जुड़ी पाबंदी वाले अनुरोधों को फ़िल्टर करें. ऐसा इसलिए, क्योंकि इसे उम्र से जुड़ी पाबंदी वाले सिग्नल नहीं मिल सकते.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 25.1.0.
- Google Mobile Ads Next-Gen SDK का वर्शन 1.1.0.
- i-mobile SDK का वर्शन 2.3.2.
वर्शन 2.3.2.2
- GMA Next-Gen SDK की डिपेंडेंसी के साथ अडैप्टर बनाने के लिए, प्रॉपर्टी जोड़ी गई.
- बैनर, इंटरस्टीशियल, और नेटिव विज्ञापनों को पुराने एपीआई से नए एपीआई पर माइग्रेट किया गया.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 25.1.0.
- i-mobile SDK का वर्शन 2.3.2.
वर्शन 2.3.2.1
- Android एपीआई लेवल को कम से कम 23 पर अपडेट किया गया.
- Google Mobile Ads SDK के ज़रूरी वर्शन को 24.0.0 पर अपडेट किया गया है.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 24.0.0.
- i-mobile SDK का वर्शन 2.3.2.
वर्शन 2.3.2.0
- i-mobile SDK के v2.3.2 के साथ काम करने की पुष्टि की गई है.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 23.1.0.
- i-mobile SDK का वर्शन 2.3.2.
वर्शन 2.3.1.2
- Google Mobile Ads SDK के ज़रूरी वर्शन को 23.0.0 पर अपडेट किया गया है.
- i-mobile SDK के v2.3.1 के साथ काम करने की पुष्टि की गई है.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 23.0.0.
- i-mobile SDK टूल का वर्शन 2.3.1.
वर्शन 2.3.1.1
- नई
VersionInfoक्लास का इस्तेमाल करने के लिए, अडैप्टर को अपडेट किया गया. - Google Mobile Ads SDK के ज़रूरी वर्शन को 22.0.0 पर अपडेट किया गया है.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 22.0.0.
- i-mobile SDK टूल का वर्शन 2.3.1.
वर्शन 2.3.1.0
- i-mobile SDK के v2.3.1 के साथ काम करने की पुष्टि की गई है.
- Google Mobile Ads SDK के ज़रूरी वर्शन को 21.5.0 पर अपडेट किया गया है.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 21.5.0.
- i-mobile SDK टूल का वर्शन 2.3.1.
वर्शन 2.3.0.0
- i-mobile SDK टूल के v2.3.0 के साथ काम करने की पुष्टि की गई है.
- Google Mobile Ads SDK के ज़रूरी वर्शन को 21.3.0 पर अपडेट किया गया है.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 21.3.0.
- i-mobile SDK का वर्शन 2.3.0.
वर्शन 2.0.23.1
compileSdkVersionऔरtargetSdkVersionको एपीआई 31 पर अपडेट किया गया.- Google Mobile Ads SDK के ज़रूरी वर्शन को 21.0.0 पर अपडेट किया गया है.
- Android के ज़रूरी एपीआई लेवल को 19 पर अपडेट किया गया है.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 21.0.0.
- IMobile SDK टूल का वर्शन 2.0.23.
वर्शन 2.0.23.0
- i-mobile SDK टूल के v2.0.23 के साथ काम करने की पुष्टि की गई है.
- Google Mobile Ads SDK के ज़रूरी वर्शन को 20.5.0 पर अपडेट किया गया है.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 20.5.0.
- IMobile SDK टूल का वर्शन 2.0.23.
वर्शन 2.0.22.2
- स्टैंडर्ड अडैप्टर के गड़बड़ी के कोड और मैसेज जोड़े गए.
- Google Mobile Ads SDK के ज़रूरी वर्शन को 20.1.0 पर अपडेट किया गया है.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 20.1.0.
- IMobile SDK का वर्शन 2.0.22.
वर्शन 2.0.22.1
- Google Mobile Ads SDK के ज़रूरी वर्शन को 20.0.0 पर अपडेट किया गया है.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 20.0.0.
- IMobile SDK का वर्शन 2.0.22.
वर्शन 2.0.22.0
- i-mobile SDK के वर्शन 2.0.22 के साथ काम करने की पुष्टि की गई.
- इनलाइन अडैप्टिव बैनर के अनुरोधों के साथ काम करने के लिए, अडैप्टर को अपडेट किया गया.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 19.1.0.
- IMobile SDK का वर्शन 2.0.22.
वर्शन 2.0.21.0
- i-mobile SDK v2.0.21 के साथ काम करने की पुष्टि की गई है.
- Google Mobile Ads SDK के ज़रूरी वर्शन को 19.1.0 पर अपडेट किया गया है.
- अडैप्टिव बैनर विज्ञापनों को स्केल करने की सुविधा जोड़ी गई.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 19.1.0.
- IMobile SDK का वर्शन 2.0.21.
वर्शन 2.0.20.2
- बैनर विज्ञापन के अलग-अलग साइज़ के लिए सहायता जोड़ी गई.
- Google Mobile Ads SDK के ज़रूरी वर्शन को 18.3.0 पर अपडेट किया गया है.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 18.3.0.
- IMobile SDK टूल का वर्शन 2.0.20.
वर्शन 2.0.20.1
- अडैप्टर अब शून्य के अलावा,
mediaContentआसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) दिखाता है.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 18.2.0.
- IMobile SDK टूल का वर्शन 2.0.20.
वर्शन 2.0.20.0
- शुरुआती रिलीज़!
- बैनर, इंटरस्टीशियल, और नेटिव विज्ञापनों के लिए सहायता जोड़ी गई.