এই নির্দেশিকাটি আপনাকে দেখাবে কিভাবে GMA Next-Gen SDK ব্যবহার করে মিডিয়েশনের মাধ্যমে maio থেকে বিজ্ঞাপন লোড ও প্রদর্শন করা যায়, যেখানে ওয়াটারফল ইন্টিগ্রেশনও অন্তর্ভুক্ত রয়েছে। এতে আলোচনা করা হয়েছে কিভাবে একটি অ্যাড ইউনিটের মিডিয়েশন কনফিগারেশনে maio যোগ করতে হয় এবং কিভাবে maio SDK ও অ্যাডাপ্টারকে একটি অ্যান্ড্রয়েড অ্যাপে ইন্টিগ্রেট করতে হয়।
maio-এর ড্যাশবোর্ড ইন্টারফেসে লেবেল, বাটন এবং বিবরণের জন্য জাপানি টেক্সট ব্যবহার করা হয়, এবং এই গাইডের স্ক্রিনশটগুলো অনুবাদ করা হয়নি। তবে, এই গাইডের বিবরণ এবং নির্দেশাবলীতে লেবেল ও বাটনগুলোকে তাদের ইংরেজি প্রতিশব্দ দিয়ে উল্লেখ করা হয়েছে। উদাহরণস্বরূপ, "URL スキーム"-এর অর্থ হলো "URL Scheme"।
সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফরম্যাট
maio-এর মিডিয়েশন অ্যাডাপ্টারটির নিম্নলিখিত সক্ষমতাগুলো রয়েছে:
| একীকরণ | |
|---|---|
| নিলাম | |
| জলপ্রপাত | |
| ফর্ম্যাট | |
| ব্যানার | |
| ইন্টারস্টিশিয়াল | |
| পুরস্কৃত | |
| স্থানীয় | |
প্রয়োজনীয়তা
- অ্যান্ড্রয়েড এপিআই লেভেল ২৪ বা তার বেশি
- maio SDK 1.0.7 বা উচ্চতর
সর্বশেষ GMA Next-Gen SDK ।
মধ্যস্থতা শুরুর নির্দেশিকাটি সম্পূর্ণ করুন।
ধাপ ১: maio UI-তে কনফিগারেশন সেট আপ করুন
প্রথমে, আপনার মাইও অ্যাকাউন্টে সাইন আপ বা লগ ইন করুন । বাম সাইডবারে থাকা অ্যাপ্লিকেশন ম্যানেজমেন্ট বোতামে ক্লিক করুন এবং নতুন অ্যাপে ক্লিক করুন।

আপনার পছন্দের বিজ্ঞাপনের ধরন অনুযায়ী ট্যাবটি নির্বাচন করুন।
ইন্টারস্টিশিয়াল
আপনার অ্যাপের নাম লিখুন, প্ল্যাটফর্ম নির্বাচন করুন এবং আপনার অ্যাপ ইউআরএল (URL) দিন। বিজ্ঞাপনের ধরণ হিসেবে ভিডিও ইন্টারস্টিশিয়াল নির্বাচন করুন এবং তারপর আপডেট (Update) বোতামে ক্লিক করুন।

পুরস্কৃত
আপনার অ্যাপের নাম লিখুন, প্ল্যাটফর্ম নির্বাচন করুন এবং আপনার অ্যাপ ইউআরএল (URL) দিন। বিজ্ঞাপনের ধরণ হিসেবে ভিডিও রিওয়ার্ডস (Video Rewards) নির্বাচন করুন, এবং তারপর আপডেট (Update) বোতামে ক্লিক করুন।

অ্যাপ্লিকেশন ম্যানেজমেন্ট পেজে মিডিয়া আইডি-টি লিখে রাখুন। পরবর্তী বিভাগে আপনার অ্যাড ম্যানেজার অ্যাড ইউনিট সেট আপ করার জন্য এটি প্রয়োজন হবে।

জোন ম্যানেজমেন্ট পেজে জোন আইডি-টি লিখে রাখুন। পরবর্তী অংশে আপনার অ্যাড ম্যানেজার অ্যাড ইউনিট সেট আপ করার জন্যও এটির প্রয়োজন হবে।


ধাপ ২: অ্যাড ম্যানেজার UI-তে মেইল ডিমান্ড সেট আপ করুন।
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন।
আপনার অ্যাড ম্যানেজার অ্যাকাউন্টে সাইন ইন করুন।
ডেলিভারি > ইল্ড গ্রুপস- এ যান এবং নিউ ইল্ড গ্রুপ বোতামে ক্লিক করুন।

আপনার ইয়েল্ড গ্রুপের জন্য একটি অনন্য নাম লিখুন, স্ট্যাটাস ‘অ্যাক্টিভ’ -এ সেট করুন, আপনার অ্যাড ফরম্যাট নির্বাচন করুন এবং ইনভেন্টরি টাইপ ‘মোবাইল অ্যাপ’- এ সেট করুন। টার্গেটিং > ইনভেন্টরি বিভাগের অধীনে, ইনভেন্টরি এবং মোবাইল অ্যাপ্লিকেশনের মধ্য থেকে সেই অ্যাড ইউনিটটি নির্বাচন করুন যেটিতে আপনি মিডিয়েশন যোগ করতে চান।
এরপর, 'Add yield partner' বাটনটিতে ক্লিক করুন।

আপনার যদি maio-এর জন্য আগে থেকেই কোনো Yield partner থাকে, তাহলে আপনি তাকে নির্বাচন করতে পারেন। অন্যথায়, 'Create a new yield partner ' নির্বাচন করুন।
অ্যাড নেটওয়ার্ক হিসেবে maio নির্বাচন করুন, একটি অনন্য নাম লিখুন এবং মিডিয়েশন সক্রিয় করুন।
স্বয়ংক্রিয় ডেটা সংগ্রহ চালু করুন এবং পূর্ববর্তী বিভাগে প্রাপ্ত API ID ও API KEY প্রবেশ করান।

Yield পার্টনার নির্বাচন করা হয়ে গেলে, ইন্টিগ্রেশন টাইপ হিসেবে Mobile SDK Mediation , প্ল্যাটফর্ম হিসেবে Android এবং স্ট্যাটাস হিসেবে Active বেছে নিন। পূর্ববর্তী বিভাগে প্রাপ্ত Media ID এবং Zone ID প্রবেশ করান। তারপর, একটি ডিফল্ট CPM মান প্রবেশ করান।

কাজ শেষ হলে পৃষ্ঠার নীচে থাকা সেভ বাটনে ক্লিক করুন।
ধাপ ৩: maio SDK এবং অ্যাডাপ্টার ইম্পোর্ট করুন
অ্যান্ড্রয়েড স্টুডিও ইন্টিগ্রেশন (প্রস্তাবিত)
আপনার প্রোজেক্ট-স্তরের settings.gradle.kts ফাইলে নিম্নলিখিত রিপোজিটরিগুলো যোগ করুন:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile-maio.github.io/maven")
}
}
}
আপনার অ্যাপ-লেভেলের গ্রেডল ফাইলে নিম্নলিখিত ইমপ্লিমেন্টেশন ডিপেন্ডেন্সি এবং কনফিগারেশনগুলো যোগ করুন:
কোটলিন
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 অ্যান্ড্রয়েড এসডিকে -র সর্বশেষ সংস্করণটি ডাউনলোড করে আপনার প্রজেক্টে যুক্ত করুন।
- গুগলের মেভেন রিপোজিটরিতে থাকা maio অ্যাডাপ্টার আর্টিফ্যাক্টস -এ যান। সর্বশেষ সংস্করণটি নির্বাচন করুন, maio অ্যাডাপ্টারের `.aar` ফাইলটি ডাউনলোড করুন এবং আপনার প্রোজেক্টে যোগ করুন।
ধাপ ৪: প্রয়োজনীয় কোড যোগ করুন
maio অ্যান্ড্রয়েড ইন্টিগ্রেশনের জন্য কোনো অতিরিক্ত কোডের প্রয়োজন নেই।
ধাপ ৫: আপনার বাস্তবায়ন পরীক্ষা করুন
টেস্ট বিজ্ঞাপন সক্রিয় করুন
আপনার টেস্ট ডিভাইসটি অ্যাড ম্যানেজারের জন্য রেজিস্টার করা নিশ্চিত করুন।
যেসব পাবলিশার GMA Next-Gen SDK এর ১১.৬.০ বা তার উচ্চতর সংস্করণ ব্যবহার করছেন, তারা অনুরোধ করার সময় টেস্ট ডিভাইস হিসেবে নিবন্ধিত ফোন এবং ট্যাবলেটে maio থেকে স্বয়ংক্রিয়ভাবে টেস্ট বিজ্ঞাপন পাবেন।
পরীক্ষামূলক বিজ্ঞাপন যাচাই করুন
আপনি maio থেকে টেস্ট অ্যাড পাচ্ছেন কিনা তা যাচাই করতে, ad inspector-এ maio (Waterfall) অ্যাড সোর্স(গুলি) ব্যবহার করে সিঙ্গেল অ্যাড সোর্স টেস্টিং সক্ষম করুন।
ত্রুটি কোড
যদি অ্যাডাপ্টার maio থেকে কোনো বিজ্ঞাপন গ্রহণ করতে ব্যর্থ হয়, তাহলে পাবলিশাররা নিম্নলিখিত ক্লাসগুলির অধীনে ResponseInfo.getAdSourceResponses() ব্যবহার করে বিজ্ঞাপনের প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটিটি পরীক্ষা করতে পারেন:
| ফর্ম্যাট | ক্লাসের নাম |
|---|---|
| ইন্টারস্টিশিয়াল | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
| পুরস্কৃত | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
যখন কোনো বিজ্ঞাপন লোড হতে ব্যর্থ হয়, তখন maio অ্যাডাপ্টার কর্তৃক প্রদর্শিত কোড এবং সংশ্লিষ্ট বার্তাগুলো নিচে দেওয়া হলো:
| ত্রুটি কোড | কারণ |
|---|---|
| ০-১০ | maio একটি SDK-নির্দিষ্ট ত্রুটি দেখিয়েছে। আরও বিস্তারিত জানতে কোড এবং maio-এর ডকুমেন্টেশন দেখুন। |
| ১০১ | Maio-তে কোনো বিজ্ঞাপন উপলব্ধ নেই। |
| ১০২ | অবৈধ সার্ভার প্যারামিটার (যেমন প্লেসমেন্ট আইডি অনুপস্থিত)। |
| ১০৩ | বিজ্ঞাপন লোড করতে ব্যবহৃত কনটেক্সটটি একটি `Activity` ইনস্ট্যান্স ছিল না। |