मैयो को मीडिएशन के साथ इंटिग्रेट करना

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

maio के डैशबोर्ड इंटरफ़ेस में लेबल, बटन, और जानकारी जैपनीज़ भाषा में दिखती है. इस गाइड में मौजूद किसी भी स्क्रीनशॉट का अनुवाद नहीं किया गया है. हालांकि, इस गाइड के ब्यौरे और निर्देशों में, लेबल और बटन के नाम अंग्रेज़ी में दिए गए हैं. उदाहरण के लिए,"URL スキーム," "URL Scheme" है.

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

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

इंटिग्रेशन
बिडिंग
वॉटरफ़ॉल
फ़ॉर्मैट
बैनर वाले विज्ञापन
इंटरस्टीशियल विज्ञापन
इनाम वाले विज्ञापन
नेटिव विज्ञापन

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

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

maio SDK 1.0.7 या इसके बाद का वर्शन

GMA Next-Gen SDK पर अपलोड हुआ नया वीडियो.
मीडिएशन की प्रोसेस पूरी करने के लिए, शुरुआती निर्देश देखें.

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

सबसे पहले, अपने maio खाते में साइन अप करें या लॉग इन करें. बाईं ओर मौजूद साइडबार में, ऐप्लिकेशन मैनेजमेंट बटन पर क्लिक करें. इसके बाद, नया ऐप्लिकेशन पर क्लिक करें.

अपनी पसंद के विज्ञापन टाइप से जुड़ा टैब चुनें.

मध्यवर्ती

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

इनाम दिया गया

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

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

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

मीडिएशन के लिए विज्ञापन यूनिट आईडी सेट अप करने के लिए, आपको मीडिया आईडी और ज़ोन आईडी के साथ-साथ एपीआई आईडी और एपीआई पासकोड की भी ज़रूरत होगी. Reporting API पेज पर, API आईडी और एपीआई कुंजी नोट करें.

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

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

आपको अपनी विज्ञापन यूनिट के लिए, मीडिएशन कॉन्फ़िगरेशन में maio को जोड़ना होगा.

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

नया मीडिएशन ग्रुप बनाने के लिए, मीडिएशन ग्रुप बनाएं को चुनें.

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

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

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

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

maio को विज्ञापन सोर्स के तौर पर जोड़ना

विज्ञापन सोर्स सेक्शन में मौजूद, वॉटरफ़ॉल कार्ड में जाकर, विज्ञापन सोर्स जोड़ें को चुनें.

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

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

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

ध्यान दें: विज्ञापन सोर्स ऑप्टिमाइज़ेशन को, मीडिएशन नेटवर्क के लिए सटीक ईसीपीएम का हिसाब लगाने के लिए ज़रूरी डेटा इकट्ठा करने में कुछ दिन लगते हैं. इस बीच, विज्ञापन सोर्स के ऑप्टिमाइज़ेशन की स्थिति PENDING है. इसलिए, आपको नेटवर्क के लिए मैन्युअल तरीके से ईसीपीएम वैल्यू सेट करनी होगी. ईसीपीएम का हिसाब लगाने के बाद, विज्ञापन सोर्स आपकी ओर से ईसीपीएम को अपने-आप अपडेट करना शुरू कर देता है.

तीसरा चरण: 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.23.0-beta01")
    implementation("com.google.ads.mediation:maio:2.0.8.0")
}

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.23.0-beta01'
    implementation 'com.google.ads.mediation:maio:2.0.8.0'
}

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' फ़ाइल डाउनलोड करें और उसे अपने प्रोजेक्ट में जोड़ें.

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

maio Android इंटिग्रेशन के लिए, किसी अन्य कोड की ज़रूरत नहीं होती.

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

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

पक्का करें कि आपने AdMob के लिए, अपने टेस्ट डिवाइस को रजिस्टर किया हो.

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` इंस्टेंस नहीं था.