इस गाइड में बताया गया है कि GMA Next-Gen SDK का इस्तेमाल करके, मीडिएशन की मदद से maio से विज्ञापन लोड करने और दिखाने का तरीका क्या है. इसमें वॉटरफ़ॉल इंटिग्रेशन शामिल हैं. इसमें बताया गया है कि किसी विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में maio को कैसे जोड़ा जाता है. साथ ही, किसी Android ऐप्लिकेशन में maio SDK और अडैप्टर को कैसे इंटिग्रेट किया जाता है.
maio के डैशबोर्ड इंटरफ़ेस में लेबल, बटन, और जानकारी जैपनीज़ भाषा में दिखती है. इस गाइड में मौजूद किसी भी स्क्रीनशॉट का अनुवाद नहीं किया गया है. हालांकि, इस गाइड के ब्यौरे और निर्देशों में, लेबल और बटन के नाम अंग्रेज़ी में दिए गए हैं. उदाहरण के लिए,"URL スキーム," "URL Scheme" है.
इस्तेमाल किए जा सकने वाले इंटिग्रेशन और विज्ञापन फ़ॉर्मैट
maio के लिए मीडिएशन अडैप्टर में ये सुविधाएं उपलब्ध हैं:
| इंटिग्रेशन | |
|---|---|
| बिडिंग | |
| वॉटरफ़ॉल | |
| फ़ॉर्मैट | |
| बैनर वाले विज्ञापन | |
| इंटरस्टीशियल विज्ञापन | |
| इनाम वाले विज्ञापन | |
| नेटिव विज्ञापन | |
ज़रूरी शर्तें
- Android का एपीआई लेवल 24 या इसके बाद का वर्शन
- maio SDK 1.0.7 या इसके बाद का वर्शन
GMA Next-Gen SDK को अपडेट किया गया.
मीडिएशन की प्रोसेस पूरी करने के लिए, शुरुआती निर्देश देखें.
पहला चरण: maio के यूआई में कॉन्फ़िगरेशन सेट अप करना
सबसे पहले, अपने maio खाते में साइन अप करें या लॉग इन करें. बाईं ओर मौजूद साइडबार में, ऐप्लिकेशन मैनेजमेंट बटन पर क्लिक करें. इसके बाद, नया ऐप्लिकेशन पर क्लिक करें.
अपनी पसंद के विज्ञापन टाइप से जुड़ा टैब चुनें.
मध्यवर्ती
अपने ऐप्लिकेशन का नाम डालें. इसके बाद, प्लैटफ़ॉर्म चुनें और अपने ऐप्लिकेशन का यूआरएल डालें. विज्ञापन टाइप के तौर पर वीडियो इंटरस्टीशियल चुनें. इसके बाद, अपडेट करें पर क्लिक करें.
इनाम दिया गया
अपने ऐप्लिकेशन का नाम डालें. इसके बाद, प्लैटफ़ॉर्म चुनें और अपने ऐप्लिकेशन का यूआरएल डालें. विज्ञापन टाइप के तौर पर वीडियो इनाम चुनें. इसके बाद, अपडेट करें पर क्लिक करें.
ऐप्लिकेशन मैनेजमेंट पेज पर, मीडिया आईडी नोट करें. अगले सेक्शन में, Ad Manager विज्ञापन यूनिट सेट अप करने के लिए इसकी ज़रूरत होती है.
ज़ोन मैनेजमेंट पेज पर, ज़ोन आईडी नोट करें. अगले सेक्शन में, Ad Manager विज्ञापन यूनिट सेट अप करने के लिए भी इसकी ज़रूरत होगी.
दूसरा चरण: Ad Manager के यूज़र इंटरफ़ेस (यूआई) में maio की डिमांड सेट अप करना
अपनी विज्ञापन यूनिट के लिए मीडिएशन की सेटिंग कॉन्फ़िगर करना
अपने Ad Manager खाते में साइन इन करें.
डिलीवरी > यील्ड ग्रुप पर जाएं. इसके बाद, नया यील्ड ग्रुप बटन पर क्लिक करें.
अपने यील्ड ग्रुप के लिए कोई यूनीक नाम डालें. इसके बाद, स्थिति को चालू है पर सेट करें. साथ ही, अपना विज्ञापन फ़ॉर्मैट चुनें और इन्वेंट्री टाइप को मोबाइल ऐप्लिकेशन पर सेट करें. टारगेटिंग > इन्वेंट्री सेक्शन में जाकर, इन्वेंट्री और मोबाइल ऐप्लिकेशन में जाकर उस विज्ञापन यूनिट को चुनें जिसमें आपको मीडिएशन जोड़ना है.
इसके बाद, यील्ड पार्टनर जोड़ें बटन पर क्लिक करें.
अगर आपने maio के लिए पहले से कोई Yield partner चुना हुआ है, तो उसे चुना जा सकता है. इसके अलावा, नया यील्ड पार्टनर बनाएं को चुनें.
विज्ञापन नेटवर्क के तौर पर maio को चुनें. इसके बाद, कोई यूनीक नाम डालें और मीडिएशन चालू करें.
डेटा अपने-आप इकट्ठा होने की सुविधा चालू करें. इसके बाद, पिछले सेक्शन में मिला एपीआई आईडी और एपीआई कुंजी डालें.
यील्ड पार्टनर चुनने के बाद, इंटिग्रेशन टाइप के तौर पर मोबाइल एसडीके मीडिएशन, प्लैटफ़ॉर्म के तौर पर Android, और स्टेटस के तौर पर चालू है चुनें. पिछले सेक्शन में मिला मीडिया आईडी और ज़ोन आईडी डालें. इसके बाद, डिफ़ॉल्ट सीपीएम वैल्यू डालें.
इसके बाद, पेज पर सबसे नीचे सेव करें पर क्लिक करें.
तीसरा चरण: maio SDK और अडैप्टर को इंपोर्ट करना
Android Studio इंटिग्रेशन (सुझाया गया)
अपने प्रोजेक्ट-लेवल की settings.gradle.kts फ़ाइल में, ये रिपॉज़िटरी जोड़ें:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile-maio.github.io/maven")
}
}
}
ऐप्लिकेशन-लेवल की gradle फ़ाइल में, ये implementation dependencies और कॉन्फ़िगरेशन जोड़ें:
Kotlin
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01") implementation("com.google.ads.mediation:maio:2.0.8.1") } 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:0.25.0-beta01' implementation 'com.google.ads.mediation:maio:2.0.8.1' } configurations.configureEach { exclude group: 'com.google.android.gms', module: 'play-services-ads' exclude group: 'com.google.android.gms', module: 'play-services-ads-lite' }
मैन्युअल इंटिग्रेशन
- maio Android SDK का नया वर्शन डाउनलोड करें और इसे अपने प्रोजेक्ट में जोड़ें.
- Google की मेवन रिपॉज़िटरी पर, maio अडैप्टर के आर्टफ़ैक्ट पर जाएं. नया वर्शन चुनें. इसके बाद, maio अडैप्टर की `.aar' फ़ाइल डाउनलोड करें और उसे अपने प्रोजेक्ट में जोड़ें.
चौथा चरण: ज़रूरी कोड जोड़ना
Android ऐप्लिकेशन में maio को इंटिग्रेट करने के लिए, किसी अन्य कोड की ज़रूरत नहीं होती.
पांचवां चरण: लागू किए गए बदलावों की जांच करना
टेस्ट विज्ञापनों को चालू करना
पक्का करें कि आपने Ad Manager के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो.
GMA Next-Gen SDK के 11.6.0 या इसके बाद के वर्शन का इस्तेमाल करने वाले पब्लिशर को, अनुरोध करने पर टेस्ट डिवाइस के तौर पर रजिस्टर किए गए फ़ोन और टैबलेट पर, maio से टेस्ट विज्ञापन अपने-आप मिलेंगे.
टेस्ट विज्ञापनों की पुष्टि करना
यह पुष्टि करने के लिए कि आपको maio से टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन जांचने वाले टूल में maio (वॉटरफ़ॉल) विज्ञापन सोर्स का इस्तेमाल करके, विज्ञापन के किसी एक सोर्स को टेस्ट करना चालू करें.
गड़बड़ी के कोड
अगर अडैप्टर को maio से विज्ञापन नहीं मिलता है, तो पब्लिशर, विज्ञापन के जवाब में हुई गड़बड़ी की जानकारी देखने के लिए, इनमें से किसी क्लास के हिसाब से ResponseInfo.getAdSourceResponses() का इस्तेमाल कर सकते हैं:
| फ़ॉर्मैट | कक्षा का नाम |
|---|---|
| मध्यवर्ती | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
| इनाम दिया गया | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
विज्ञापन लोड न होने पर, maio अडैप्टर से मिलने वाले कोड और उनसे जुड़े मैसेज यहां दिए गए हैं:
| गड़बड़ी का कोड | कारण |
|---|---|
| 0-10 | maio ने एसडीके टूल से जुड़ी गड़बड़ी का मैसेज दिखाया. ज़्यादा जानकारी के लिए, कोड और maio का दस्तावेज़ देखें. |
| 101 | Maio के पास कोई विज्ञापन उपलब्ध नहीं है. |
| 102 | सर्वर के पैरामीटर अमान्य हैं. जैसे, प्लेसमेंट आईडी मौजूद नहीं है. |
| 103 | विज्ञापन लोड करने के लिए इस्तेमाल किया गया कॉन्टेक्स्ट, `Activity` इंस्टेंस नहीं था. |