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

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

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

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

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

इंटिग्रेशन
बिडिंग
वॉटरफ़ॉल
फ़ॉर्मैट
बैनर
मध्यवर्ती
इनाम दिया गया
नेटिव लेआउट

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

  • Android API का लेवल 19 या उसके बाद वाला वर्शन
  • maio SDK टूल 1.0.7 या इसके बाद वाला वर्शन

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

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

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

मध्यवर्ती

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

इनाम दिया गया

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

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

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

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

दूसरा चरण: यूज़र इंटरफ़ेस (यूआई) में Ad Manager maio की डिमांड सेट अप करना

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

अपने Ad Manager खाते में साइन इन करें.

डिलीवरी > यील्ड ग्रुप पर जाएं और नया यील्ड ग्रुप बटन पर क्लिक करें.

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

इसके बाद, ईल्ड पार्टनर जोड़ें बटन पर क्लिक करें.

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

विज्ञापन नेटवर्क के तौर पर maio चुनें और यूनीक नाम डालें. साथ ही, मीडिएशन की सुविधा चालू करें.

अपने-आप डेटा इकट्ठा होने की सुविधा को चालू करें और पिछले सेक्शन में मौजूद API ID and API KEY को डालें.

यील्ड पार्टनर चुनने के बाद, इंटिग्रेशन टाइप के तौर पर मोबाइल SDK टूल मीडिएशन, प्लैटफ़ॉर्म के तौर पर Android, और स्टेटस के तौर पर ऐक्टिव चुनें. पिछले सेक्शन में दिए गए Media ID and Zone ID कोड को डालें. इसके बाद, डिफ़ॉल्ट सीपीएम वैल्यू डालें.

इसके बाद, पेज पर सबसे नीचे सेव करें पर क्लिक करें.

तीसरा चरण: maio SDK टूल और अडैप्टर इंपोर्ट करना

प्रोजेक्ट-लेवल की 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:23.0.0")
    implementation("com.google.ads.mediation:maio:1.1.16.2")
}

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

  • maio Android SDK का सबसे नया वर्शन डाउनलोड करें और उसे अपने प्रोजेक्ट में जोड़ें.
  • Google की मेवन रिपॉज़िटरी पर maio अडैप्टर आर्टफ़ैक्ट पर जाएं. सबसे नया वर्शन चुनें, maio अडैप्टर की `.aar' फ़ाइल डाउनलोड करें, और उसे अपने प्रोजेक्ट में जोड़ें.

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

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

पांचवां चरण: लागू होने की जांच करना

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

पक्का करें कि आपने Ad Manager.

Google Mobile Ads SDK के 11.6.0 या इसके बाद के वर्शन का इस्तेमाल करने वाले पब्लिशर को अनुरोध करते समय, टेस्ट डिवाइस के तौर पर रजिस्टर किए गए फ़ोन और टैबलेट पर, maio से टेस्ट विज्ञापन अपने-आप मिलेंगे.

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

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

गड़बड़ी कोड

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

फ़ॉर्मैट कक्षा का नाम
मध्यवर्ती jp.maio.sdk.android.mediation.admob.adapter.Interstitial
इनाम दिया गया jp.maio.sdk.android.mediation.admob.adapter.Rewarded

यहां कुछ कोड और उनसे जुड़े मैसेज दिए गए हैं, जिन्हें maio अडैप्टर का इस्तेमाल करके अपलोड किया जाता है. ऐसा किसी विज्ञापन के लोड न हो पाने पर होता है:

गड़बड़ी का कोड वजह
0-10 maio ने SDK टूल से जुड़ी कोई गड़बड़ी दिखाई. ज़्यादा जानकारी के लिए, कोड और maio के दस्तावेज़ देखें.
101 Maio में कोई विज्ञापन उपलब्ध नहीं है.
102 अमान्य सर्वर पैरामीटर (उदाहरण के लिए, प्लेसमेंट आईडी मौजूद नहीं है).
103 विज्ञापन लोड करने के लिए इस्तेमाल किया जाने वाला कॉन्टेक्स्ट, `गतिविधि` का इंस्टेंस नहीं है.
0-10 maio ने SDK टूल से जुड़ी कोई गड़बड़ी दिखाई. ज़्यादा जानकारी के लिए, maio का कोड देखें.
101 maio पर अभी कोई विज्ञापन उपलब्ध नहीं है.
102 अमान्य सर्वर पैरामीटर (उदाहरण के लिए, प्लेसमेंट आईडी मौजूद नहीं है).
103 maio अडैप्टर, अनुरोध किए जा रहे विज्ञापन फ़ॉर्मैट के साथ काम नहीं करता.
104 इस नेटवर्क कॉन्फ़िगरेशन के लिए एक विज्ञापन पहले से लोड है.

maio Android मीडिएशन अडैप्टर चेंजलॉग

अगला वर्शन

  • Google Mobile Ads SDK के कम से कम ज़रूरी वर्शन को 22.4.0 पर अपडेट किया गया.

वर्शन 1.1.16.2

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

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

  • Google मोबाइल विज्ञापन 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 मोबाइल विज्ञापन SDK का 21.0.0 वर्शन.
  • Maio SDK टूल का वर्शन 1.1.16.

वर्शन 1.1.16.0

  • मैओ की अन्य गड़बड़ियों को कैप्चर करने के लिए, गड़बड़ी कोड अपडेट किए गए.
  • पुष्टि की गई है कि यह डिवाइस 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

  • इनाम वाले नए एपीआई के साथ काम करने के लिए, अडैप्टर को अपडेट किया गया.
  • 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

  • अडैप्टर को अपडेट किए गए इनीशियलाइज़ फ़ंक्शन के साथ अपडेट किया गया.

वर्शन 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

  • उस समस्या को ठीक कर दिया गया है जिसकी वजह से विज्ञापन लोड नहीं हो पाने की वजह से NullPointerअपवाद हो सकते हैं.

वर्शन 1.0.7.0

  • AdRequest में टेस्ट डिवाइस आईडी जोड़कर, टेस्ट मोड चालू करने की सुविधा जोड़ी गई.
  • पुष्टि की गई है कि यह डिवाइस maio SDK टूल के 1.0.7 वर्शन के साथ काम करता है.

वर्शन 1.0.6.0

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