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

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

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

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

i-mobile के लिए मीडिएशन अडैप्टर में ये सुविधाएं उपलब्ध हैं:

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

• Android का एपीआई लेवल 23 या इसके बाद का वर्शन

• Google Mobile Ads SDK का नया वर्शन

• मीडिएशन की सुविधा चालू करना शुरुआती निर्देश

पहला चरण: i-mobile के यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगरेशन सेट अप करना

अपने i-mobile खाते में साइन अप करें या लॉग इन करें.

サイト／アプリ管理 (Site/Application Management) टैब पर क्लिक करके, i-mobile डैशबोर्ड में अपना ऐप्लिकेशन जोड़ें. इसके बाद, अपने ऐप्लिकेशन के प्लैटफ़ॉर्म के लिए दिए गए बटन पर क्लिक करें.

फ़ॉर्म भरें और 新規登録 (Sign up) बटन पर क्लिक करें.

नया विज्ञापन स्लॉट बनाने के लिए, サイト／アプリ管理 (साइट/ऐप्लिकेशन मैनेजमेंट) टैब में जाकर, अपना ऐप्लिकेशन चुनें.

広告スポット管理 (Ad Spot Management) टैब पर जाएं. इसके बाद, 新規広告スポット (New Ad Spot) बटन पर क्लिक करें.

इसके बाद, 広告スポット名 (विज्ञापन स्पॉट का नाम), 広告スポットサイズ (विज्ञापन स्पॉट का साइज़) और अन्य जानकारी देकर फ़ॉर्म भरें. इसके बाद, 新規登録 (Sign up) बटन पर क्लिक करें.

आपका नया विज्ञापन स्लॉट तैयार है. इसके इंटिग्रेशन की जानकारी देखने के लिए, アプリ設定取得 (Get App settings) बटन पर क्लिक करें.

パブリッシャーID (Publisher ID), メディアID (Media ID), और スポットID (Spot ID) नोट करें. AdMob के यूज़र इंटरफ़ेस में मीडिएशन के लिए i-mobile को कॉन्फ़िगर करते समय, आपको बाद में इन पैरामीटर की ज़रूरत होगी.

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

Authorized Sellers for Apps 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 SDK और अडैप्टर इंपोर्ट करना

Android Studio इंटिग्रेशन (सुझाया गया)

अपने प्रोजेक्ट-लेवल की settings.gradle.kts फ़ाइल में, यहां दी गई रिपॉज़िटरी जोड़ें:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://imobile.github.io/adnw-sdk-android")
    }
  }
}

इसके बाद, अपने ऐप्लिकेशन-लेवल की build.gradle.kts फ़ाइल में, ये लागू करने से जुड़ी डिपेंडेंसी और कॉन्फ़िगरेशन जोड़ें. i-mobile SDK और अडैप्टर के नए वर्शन का इस्तेमाल करें:

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.4.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.1")
}

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

1. i-mobile SDK का नया वर्शन डाउनलोड करें. इसके बाद, sdk फ़ोल्डर में मौजूद android-ad-sdk.aar को एक्सट्रैक्ट करें और उसे अपने प्रोजेक्ट में जोड़ें.

2. Google की Maven Repository पर, i-mobile adapter artifacts पर जाएं. नवीनतम वर्शन चुनें. इसके बाद, i-mobile अडैप्टर की .aar फ़ाइल डाउनलोड करें और उसे अपने प्रोजेक्ट में जोड़ें.

चौथा चरण: ज़रूरी कोड जोड़ना

गतिविधि के संदर्भ के साथ विज्ञापन लोड करना

बैनर, इंटरस्टीशियल, इनाम वाले, और नेटिव विज्ञापन फ़ॉर्मैट लोड करते समय Activity कॉन्टेक्स्ट पास करें.गतिविधि के कॉन्टेक्स्ट के बिना, विज्ञापन लोड नहीं होगा.

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

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

पक्का करें कि आपने AdMob के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो. i-mobile, टेस्टिंग के लिए Spot ID, Media ID, और Publisher ID उपलब्ध कराता है. इन्हें यहां देखा जा सकता है.

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

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

वैकल्पिक चरण

नेटिव विज्ञापनों का इस्तेमाल करना

विज्ञापन रेंडरिंग

i-mobile अडैप्टर, NativeAd के लिए, नेटिव विज्ञापन के ऐडवांस फ़ील्ड के बारे में यहां दी गई जानकारी भरता है.

¹ नेटिव विज्ञापनों के लिए, i-mobile SDK ऐप्लिकेशन आइकॉन ऐसेट उपलब्ध नहीं कराता है. इसके बजाय, i-mobile अडैप्टर, ऐप्लिकेशन के आइकॉन को पारदर्शी इमेज से भरता है.

गड़बड़ी के कोड

अगर अडैप्टर को i-mobile से कोई विज्ञापन नहीं मिलता है, तो पब्लिशर विज्ञापन रिस्पॉन्स से जुड़ी गड़बड़ी की जांच कर सकते हैं. इसके लिए, उन्हें इन क्लास में जाकर ResponseInfo.getAdapterResponses() का इस्तेमाल करना होगा:

विज्ञापन लोड न होने पर, i-mobile अडैप्टर से मिलने वाले कोड और उनसे जुड़े मैसेज यहां दिए गए हैं:

i-mobile Android Mediation Adapter के बदलावों का लॉग

वर्शन 2.3.2.1

• Android के लिए ज़रूरी एपीआई लेवल को 23 पर अपडेट किया गया है.
• Google Mobile Ads SDK के ज़रूरी वर्शन को 24.0.0 पर अपडेट किया गया है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 24.0.0.
• IMobile SDK टूल का वर्शन 2.3.2.

वर्शन 2.3.2.0

• i-mobile SDK v2.3.2 के साथ काम करने की पुष्टि की गई.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 23.1.0.
• IMobile 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.
• IMobile SDK टूल का वर्शन 2.3.1.

वर्शन 2.3.1.1

• नई VersionInfo क्लास का इस्तेमाल करने के लिए, अडैप्टर को अपडेट किया गया.
• Google Mobile Ads SDK के ज़रूरी वर्शन को 22.0.0 पर अपडेट किया गया है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 22.0.0.
• IMobile 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.
• IMobile SDK टूल का वर्शन 2.3.1.

वर्शन 2.3.0.0

• i-mobile SDK के 2.3.0 वर्शन के साथ काम करने की पुष्टि की गई है.
• Google Mobile Ads SDK के ज़रूरी वर्शन को 21.3.0 पर अपडेट किया गया है.

इसे इनके साथ बनाया और टेस्ट किया गया है:

• Google Mobile Ads SDK का वर्शन 21.3.0.
• IMobile 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 v2.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

• Adapter अब शून्य से अलग mediaContent आसपेक्ट रेशियो दिखाता है.

इनके साथ मिलकर बनाया और टेस्ट किया गया

• Google Mobile Ads SDK का वर्शन 18.2.0.
• IMobile SDK का वर्शन 2.0.20.

वर्शन 2.0.20.0

• शुरुआती रिलीज़!
• बैनर, इंटरस्टीशियल, और नेटिव विज्ञापनों के लिए सहायता जोड़ी गई.