এই নির্দেশিকাটি আপনাকে দেখাবে কিভাবে GMA Next-Gen SDK ব্যবহার করে AdMob মিডিয়েশনের মাধ্যমে 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) বোতামে ক্লিক করুন।

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

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


ধাপ ২: AdMob UI-তে maio ডিমান্ড সেট আপ করুন।
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন।
আপনার অ্যাড ইউনিটের মিডিয়েশন কনফিগারেশনে maio যোগ করতে হবে।
প্রথমে, আপনার AdMob অ্যাকাউন্টে সাইন ইন করুন। এরপর, মিডিয়েশন ট্যাবে যান। আপনার যদি আগে থেকে থাকা কোনো মিডিয়েশন গ্রুপ থাকে যা আপনি পরিবর্তন করতে চান, তবে সেটি সম্পাদনা করার জন্য সেই মিডিয়েশন গ্রুপের নামের উপর ক্লিক করুন এবং সরাসরি ' অ্যাড মাইও অ্যাজ অ্যান অ্যাড সোর্স' অংশে চলে যান।
নতুন মধ্যস্থতা গোষ্ঠী তৈরি করতে, ‘মধ্যস্থতা গোষ্ঠী তৈরি করুন’ নির্বাচন করুন।

আপনার বিজ্ঞাপনের ধরণ ও প্ল্যাটফর্ম লিখুন, তারপর 'চালিয়ে যান'-এ ক্লিক করুন।

আপনার মিডিয়েশন গ্রুপের একটি নাম দিন এবং টার্গেট করার জন্য লোকেশন নির্বাচন করুন। এরপর, মিডিয়েশন গ্রুপের স্ট্যাটাস ‘এনাবলড’- এ সেট করুন এবং তারপর ‘অ্যাড অ্যাড ইউনিটস’-এ ক্লিক করুন।

এই মিডিয়েশন গ্রুপটিকে আপনার বিদ্যমান এক বা একাধিক AdMob অ্যাড ইউনিটের সাথে যুক্ত করুন। তারপর 'Done'-এ ক্লিক করুন।

এখন আপনি অ্যাড ইউনিট কার্ডটিতে আপনার নির্বাচিত অ্যাড ইউনিটগুলো দেখতে পাবেন:

বিজ্ঞাপনের উৎস হিসেবে maio যোগ করুন
Ad Sources সেকশনের Waterfall কার্ডের অধীনে, Add Ad Source নির্বাচন করুন।
maio নির্বাচন করুন এবং Optimize সুইচটি সক্রিয় করুন। maio-এর জন্য বিজ্ঞাপন উৎস অপ্টিমাইজেশন সেট আপ করতে পূর্ববর্তী বিভাগে প্রাপ্ত API ID এবং API KEY লিখুন। তারপর maio-এর জন্য একটি eCPM মান লিখুন এবং Continue-তে ক্লিক করুন।

আপনার যদি maio-এর জন্য আগে থেকেই কোনো ম্যাপিং থাকে, তাহলে সেটি নির্বাচন করতে পারেন। অন্যথায়, 'Add mapping'-এ ক্লিক করুন।

এরপর, পূর্ববর্তী ধাপে প্রাপ্ত মিডিয়া আইডি এবং জোন আইডি প্রবেশ করান। তারপর 'Done' বাটনে ক্লিক করুন।

ধাপ ৩: 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 অ্যান্ড্রয়েড ইন্টিগ্রেশনের জন্য কোনো অতিরিক্ত কোডের প্রয়োজন নেই।
ধাপ ৫: আপনার বাস্তবায়ন পরীক্ষা করুন
টেস্ট বিজ্ঞাপন সক্রিয় করুন
আপনার টেস্ট ডিভাইসটি AdMob-এর জন্য রেজিস্টার করে নিন ।
যেসব পাবলিশার 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` ইনস্ট্যান্স ছিল না। |