इस गाइड में बताया गया है कि मीडिएशन का इस्तेमाल करके, Google Mobile Ads SDK की मदद से maio के विज्ञापन कैसे लोड और दिखाए जा सकते हैं. इसमें वॉटरफ़ॉल इंटिग्रेशन के बारे में भी बताया गया है. इसमें बताया गया है कि किसी विज्ञापन यूनिट के मीडिएशन कॉन्फ़िगरेशन में maio को कैसे जोड़ा जाए. साथ ही, Android ऐप्लिकेशन में maio SDK और अडैप्टर को कैसे इंटिग्रेट किया जाए.
maio के डैशबोर्ड इंटरफ़ेस में लेबल, बटन, और जानकारी जैपनीज़ भाषा में दिखती है. इस गाइड में मौजूद किसी भी स्क्रीनशॉट का अनुवाद नहीं किया गया है. हालांकि, इस गाइड के ब्यौरे और निर्देशों में, लेबल और बटन के नाम अंग्रेज़ी में दिए गए हैं. उदाहरण के लिए,"URL スキーム," "URL Scheme" है.
इस्तेमाल किए जा सकने वाले इंटिग्रेशन और विज्ञापन फ़ॉर्मैट
maio के लिए मीडिएशन अडैप्टर में ये सुविधाएं उपलब्ध हैं:
इंटिग्रेशन | |
---|---|
बिडिंग | |
वॉटरफ़ॉल | |
फ़ॉर्मैट | |
बैनर | |
इंटरस्टीशियल विज्ञापन | |
इनाम वाले विज्ञापन | |
नेटिव |
ज़रूरी शर्तें
- Android का एपीआई लेवल 23 या इसके बाद का वर्शन
- maio SDK 1.0.7 या इसके बाद का वर्शन
Google Mobile Ads SDK का नया वर्शन.
मीडिएशन की प्रोसेस पूरी करें शुरुआती निर्देश.
पहला चरण: maio के यूआई में कॉन्फ़िगरेशन सेट अप करना
सबसे पहले, अपने maio खाते में साइन अप करें या लॉग इन करें. बाईं ओर मौजूद साइडबार में, ऐप्लिकेशन मैनेजमेंट बटन पर क्लिक करें. इसके बाद, नया ऐप्लिकेशन पर क्लिक करें.
अपनी पसंद के विज्ञापन टाइप से जुड़ा टैब चुनें.
मध्यवर्ती
अपने ऐप्लिकेशन का नाम डालें. इसके बाद, प्लैटफ़ॉर्म चुनें और अपने ऐप्लिकेशन का यूआरएल डालें. विज्ञापन टाइप के तौर पर वीडियो इंटरस्टीशियल चुनें. इसके बाद, अपडेट करें पर क्लिक करें.
इनाम दिया गया
अपने ऐप्लिकेशन का नाम डालें. इसके बाद, प्लैटफ़ॉर्म चुनें और अपने ऐप्लिकेशन का यूआरएल डालें. विज्ञापन टाइप के तौर पर वीडियो इनाम चुनें. इसके बाद, अपडेट करें पर क्लिक करें.
ऐप्लिकेशन मैनेजमेंट पेज पर, मीडिया आईडी नोट करें. अगले सेक्शन में, Ad Manager विज्ञापन यूनिट सेट अप करने के लिए इसकी ज़रूरत होती है.
ज़ोन मैनेजमेंट पेज पर, ज़ोन आईडी नोट करें. अगले सेक्शन में, Ad Manager विज्ञापन यूनिट को सेट अप करने के लिए भी इसकी ज़रूरत होगी.
दूसरा चरण: Ad Manager के यूज़र इंटरफ़ेस (यूआई) में maio की डिमांड सेट अप करना
अपनी विज्ञापन यूनिट के लिए मीडिएशन की सेटिंग कॉन्फ़िगर करना
अपने Ad Manager खाते में साइन इन करें.
डिलीवरी > यील्ड ग्रुप पर जाएं और नया यील्ड ग्रुप बटन पर क्लिक करें.
अपने यील्ड ग्रुप के लिए कोई यूनीक नाम डालें. इसके बाद, स्थिति को चालू है पर सेट करें. अपना विज्ञापन फ़ॉर्मैट चुनें और इन्वेंट्री टाइप को मोबाइल ऐप्लिकेशन पर सेट करें. टारगेटिंग > इन्वेंट्री सेक्शन में जाकर, इन्वेंट्री और मोबाइल ऐप्लिकेशन में जाकर, उस विज्ञापन यूनिट को चुनें जिसमें आपको मीडिएशन जोड़ना है.
इसके बाद, यील्ड पार्टनर जोड़ें बटन पर क्लिक करें.
अगर आपके पास पहले से ही maio के लिए Yield partner है, तो उसे चुना जा सकता है. इसके अलावा, नया यील्ड पार्टनर बनाएं को चुनें.
विज्ञापन नेटवर्क के तौर पर maio को चुनें. इसके बाद, कोई यूनीक नाम डालें और मीडिएशन चालू करें.
डेटा अपने-आप इकट्ठा होने की सुविधा चालू करें. इसके बाद, पिछले सेक्शन में मिला एपीआई आईडी और एपीआई पासकोड डालें.
यील्ड पार्टनर चुनने के बाद, इंटिग्रेशन टाइप के तौर पर मोबाइल SDK मीडिएशन, प्लैटफ़ॉर्म के तौर पर Android, और स्टेटस के तौर पर चालू है चुनें. पिछले सेक्शन में मिला मीडिया आईडी और ज़ोन आईडी डालें. इसके बाद, डिफ़ॉल्ट सीपीएम वैल्यू डालें.
इसके बाद, पेज पर सबसे नीचे सेव करें पर क्लिक करें.
तीसरा चरण: maio SDK और अडैप्टर इंपोर्ट करना
Android Studio इंटिग्रेशन (सुझाया गया)
अपने प्रोजेक्ट-लेवल की settings.gradle.kts
फ़ाइल में, ये रिपॉज़िटरी जोड़ें:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile-maio.github.io/maven")
}
}
}
इसके बाद, अपने ऐप्लिकेशन-लेवल की build.gradle.kts
फ़ाइल में, ये लागू करने से जुड़ी डिपेंडेंसी और कॉन्फ़िगरेशन जोड़ें. maio SDK और अडैप्टर के नए वर्शन का इस्तेमाल करें:
dependencies {
implementation("com.google.android.gms:play-services-ads:24.5.0")
implementation("com.google.ads.mediation:maio:2.0.5.0")
}
मैन्युअल इंटिग्रेशन
- maio Android SDK का नया वर्शन डाउनलोड करें और इसे अपने प्रोजेक्ट में जोड़ें.
- Google की मेवन रिपॉज़िटरी पर, maio अडैप्टर के आर्टफ़ैक्ट पर जाएं. नया वर्शन चुनें. इसके बाद, maio अडैप्टर की `.aar' फ़ाइल डाउनलोड करें और उसे अपने प्रोजेक्ट में जोड़ें.
चौथा चरण: ज़रूरी कोड जोड़ना
maio Android इंटिग्रेशन के लिए, किसी और कोड की ज़रूरत नहीं होती.
पांचवां चरण: लागू किए गए बदलावों की जांच करना
टेस्ट विज्ञापनों को चालू करना
पक्का करें कि आपने Ad Manager के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो.
Google Mobile Ads SDK के 11.6.0 या इसके बाद के वर्शन का इस्तेमाल करने वाले पब्लिशर को, अनुरोध करने पर टेस्ट डिवाइसों के तौर पर रजिस्टर किए गए फ़ोन और टैबलेट पर, maio से टेस्ट विज्ञापन अपने-आप मिलेंगे.
टेस्ट विज्ञापनों की पुष्टि करना
यह पुष्टि करने के लिए कि आपको maio से टेस्ट विज्ञापन मिल रहे हैं, विज्ञापन जांचने वाले टूल में maio (वॉटरफ़ॉल) विज्ञापन सोर्स का इस्तेमाल करके, विज्ञापन के किसी एक सोर्स को टेस्ट करना चालू करें.
गड़बड़ी के कोड
अगर अडैप्टर को maio से कोई विज्ञापन नहीं मिलता है, तो पब्लिशर विज्ञापन के जवाब में मौजूद गड़बड़ी की जानकारी देख सकते हैं. इसके लिए, उन्हें इन क्लास में जाकर ResponseInfo.getAdapterResponses()
का इस्तेमाल करना होगा:
फ़ॉर्मैट | कक्षा का नाम |
---|---|
मध्यवर्ती | 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` इंस्टेंस नहीं था. |
maio Android Mediation Adapter के बदलावों का लॉग
वर्शन 2.0.5.0
- maio SDK के 2.0.5 वर्शन के साथ काम करने की पुष्टि की गई है.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 24.4.0.
- Maio SDK टूल का वर्शन 2.0.5.0.
वर्शन 2.0.4.0
- maio SDK टूल के 2.0.4 वर्शन के साथ काम करने की पुष्टि की गई है.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 24.3.0.
- Maio SDK टूल का वर्शन 2.0.4.0.
वर्शन 2.0.3.1
- Android के लिए ज़रूरी एपीआई लेवल को 23 पर अपडेट किया गया है.
- Google Mobile Ads SDK के ज़रूरी वर्शन को 24.0.0 पर अपडेट किया गया है.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 24.0.0.
- Maio SDK टूल का वर्शन 2.0.3.0.
वर्शन 2.0.3.0
- maio SDK टूल के वर्शन 2.0.3.0 के साथ काम करने की पुष्टि की गई है.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 23.6.0.
- Maio SDK टूल का वर्शन 2.0.3.0.
वर्शन 1.1.16.3
- Google Mobile Ads SDK के ज़रूरी वर्शन को 23.0.0 पर अपडेट किया गया है.
- maio SDK टूल के 1.1.16 वर्शन के साथ काम करने की पुष्टि की गई.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 23.0.0.
- Maio SDK का वर्शन 1.1.16.
वर्शन 1.1.16.2
- नई
VersionInfo
क्लास का इस्तेमाल करने के लिए, अडैप्टर को अपडेट किया गया. - Google Mobile Ads SDK के ज़रूरी वर्शन को 22.0.0 पर अपडेट किया गया है.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 22.0.0.
- Maio SDK का वर्शन 1.1.16.
वर्शन 1.1.16.1
compileSdkVersion
औरtargetSdkVersion
को एपीआई लेवल 31 पर अपडेट किया गया.- Google Mobile Ads SDK के ज़रूरी वर्शन को 21.0.0 पर अपडेट किया गया है.
- Android के लिए ज़रूरी एपीआई लेवल को 19 पर अपडेट किया गया है.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 21.0.0.
- Maio SDK का वर्शन 1.1.16.
वर्शन 1.1.16.0
- maio से जुड़ी अन्य गड़बड़ियों को कैप्चर करने के लिए, गड़बड़ी के कोड अपडेट किए गए.
- maio SDK टूल के 1.1.16 वर्शन के साथ काम करने की पुष्टि की गई.
- Google Mobile Ads SDK के ज़रूरी वर्शन को 20.4.0 पर अपडेट किया गया है.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 20.4.0.
- Maio SDK का वर्शन 1.1.16.
वर्शन 1.1.15.0
- maio SDK टूल के वर्शन 1.1.15 के साथ काम करने की पुष्टि की गई है.
- Google Mobile Ads SDK के ज़रूरी वर्शन को 20.0.0 पर अपडेट किया गया है.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 20.0.0.
- Maio SDK टूल का वर्शन 1.1.15.
वर्शन 1.1.14.0
- अडैप्टर से जुड़ी गड़बड़ियों के स्टैंडर्ड कोड और मैसेज जोड़े गए.
- maio SDK टूल के 1.1.14 वर्शन के साथ काम करने की पुष्टि की गई.
- Google Mobile Ads SDK के ज़रूरी वर्शन को 19.8.0 पर अपडेट किया गया है.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 19.8.0.
- Maio SDK टूल का वर्शन 1.1.14.
वर्शन 1.1.13.0
- maio SDK टूल के 1.1.13 वर्शन के साथ काम करने की पुष्टि की गई.
- Google Mobile Ads SDK के ज़रूरी वर्शन को 19.5.0 पर अपडेट किया गया है.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 19.5.0.
- Maio SDK टूल का वर्शन 1.1.13.
वर्शन 1.1.12.0
- Google Mobile Ads SDK के ज़रूरी वर्शन को 19.4.0 पर अपडेट किया गया है.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 19.4.0.
- Maio SDK टूल का वर्शन 1.1.12.
वर्शन 1.1.11.1
- टाइमआउट को सीमित करने के लिए, अगर maio के पास दिखाने के लिए कोई विज्ञापन तैयार नहीं है, तो विज्ञापन दिखाने के अनुरोध को तुरंत अस्वीकार कर दिया जाएगा.
- Google Mobile Ads SDK के ज़रूरी वर्शन को 19.1.0 पर अपडेट किया गया है.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 19.1.0.
- Maio SDK टूल का वर्शन 1.1.11.
वर्शन 1.1.11.0
- maio SDK टूल के 1.1.11 वर्शन के साथ काम करने की पुष्टि की गई है.
- Google Mobile Ads SDK के ज़रूरी वर्शन को 18.3.0 पर अपडेट किया गया है.
इसे इनके साथ बनाया और टेस्ट किया गया है:
- Google Mobile Ads SDK का वर्शन 18.3.0.
- Maio SDK टूल का वर्शन 1.1.11.
वर्शन 1.1.10.0
- maio SDK टूल के वर्शन 1.1.10 के साथ काम करने की पुष्टि की गई है.
- Google Mobile Ads SDK के ज़रूरी वर्शन को 18.2.0 पर अपडेट किया गया है.
वर्शन 1.1.8.0
- maio SDK टूल के वर्शन 1.1.8 के साथ काम करने की पुष्टि की गई.
- Google Mobile Ads SDK के ज़रूरी वर्शन को 18.1.0 पर अपडेट किया गया है.
वर्शन 1.1.7.0
- गड़बड़ियां ठीक की गईं.
- maio SDK टूल के 1.1.7 वर्शन के साथ काम करने की पुष्टि की गई.
वर्शन 1.1.6.1
- नए Rewarded API के साथ काम करने के लिए अडैप्टर को अपडेट किया गया.
- Google Mobile Ads SDK के ज़रूरी वर्शन को 17.2.0 पर अपडेट किया गया है.
वर्शन 1.1.6.0
- maio SDK टूल के 1.1.6 वर्शन के साथ काम करने की पुष्टि की गई.
वर्शन 1.1.5.0
- maio SDK टूल के वर्शन 1.1.5 के साथ काम करने की पुष्टि की गई.
वर्शन 1.1.4.0
- maio SDK के 1.1.4 वर्शन के साथ काम करने की पुष्टि की गई है.
वर्शन 1.1.3.1
- अडैप्टर को सिंगलटन के बजाय इंस्टेंस क्लास के साथ काम करने के लिए अपडेट किया गया.
वर्शन 1.1.3.0
- maio SDK टूल के 1.1.3 वर्शन के साथ काम करने की पुष्टि की गई है.
वर्शन 1.1.2.1
- अपडेट किए गए initialize फ़ंक्शन के साथ अडैप्टर को अपडेट किया गया.
वर्शन 1.1.2.0
- इसकी पुष्टि हो गई है कि यह maio SDK टूल के वर्शन 1.1.2 के साथ काम करता है.
वर्शन 1.1.1.1
onRewardedVideoComplete()
विज्ञापन इवेंट को चालू करने के लिए, अडैप्टर को अपडेट किया गया.
वर्शन 1.1.1.0
- maio SDK टूल के 1.1.1 वर्शन के साथ काम करने की पुष्टि की गई है.
वर्शन 1.1.0.0
- maio SDK टूल के वर्शन 1.1.0 के साथ काम करने की पुष्टि की गई है.
वर्शन 1.0.8.0
- maio SDK टूल के 1.0.8 वर्शन के साथ काम करने की पुष्टि की गई है.
वर्शन 1.0.7.1
- उस समस्या को ठीक कर दिया गया है जिसकी वजह से विज्ञापन लोड न होने पर NullPointerException हो सकता था.
वर्शन 1.0.7.0
AdRequest
में टेस्ट डिवाइस आईडी जोड़कर, टेस्ट मोड चालू करने की सुविधा जोड़ी गई.- maio SDK टूल के 1.0.7 वर्शन के साथ काम करने की पुष्टि की गई है.
वर्शन 1.0.6.0
- पहली बार रिलीज़ किया गया!
- इंटरस्टीशियल और इनाम वाले वीडियो विज्ञापनों के लिए सहायता जोड़ी गई.