এই নির্দেশিকাটি আপনাকে দেখাবে কিভাবে মিডিয়েশন ব্যবহার করে maio থেকে বিজ্ঞাপন লোড ও প্রদর্শন করার জন্য Google Mobile Ads Flutter Plugin ব্যবহার করতে হয়, যেখানে ওয়াটারফল ইন্টিগ্রেশনও অন্তর্ভুক্ত রয়েছে। এতে আলোচনা করা হয়েছে কিভাবে একটি অ্যাড ইউনিটের মিডিয়েশন কনফিগারেশনে maio যোগ করতে হয় এবং কিভাবে একটি Flutter অ্যাপে maio SDK ও অ্যাডাপ্টার ইন্টিগ্রেট করতে হয়।
maio-এর ড্যাশবোর্ড ইন্টারফেসে লেবেল, বাটন এবং বিবরণের জন্য জাপানি ভাষা ব্যবহার করা হয়েছে, এবং এই গাইডের স্ক্রিনশটগুলো অনুবাদ করা হয়নি। তবে, এখানকার বিবরণ এবং নির্দেশাবলীতে লেবেল ও বাটনগুলোকে তাদের ইংরেজি প্রতিশব্দ দিয়ে উল্লেখ করা হয়েছে। উদাহরণস্বরূপ, "URL スキーム"-কে "URL Scheme" বলা হয়েছে।
সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফরম্যাট
maio-এর মিডিয়েশন অ্যাডাপ্টারটির নিম্নলিখিত সক্ষমতাগুলো রয়েছে:
| একীকরণ | |
|---|---|
| নিলাম | |
| জলপ্রপাত | |
| ফর্ম্যাট | |
| ব্যানার | |
| ইন্টারস্টিশিয়াল | |
| পুরস্কৃত | |
| স্থানীয় | |
প্রয়োজনীয়তা
- সর্বশেষ Google Mobile Ads Flutter Plugin
- ফ্লাটার ৩.৭.০ বা উচ্চতর
- অ্যান্ড্রয়েডে স্থাপন করতে
- অ্যান্ড্রয়েড এপিআই লেভেল ২৩ বা তার বেশি
- iOS-এ স্থাপন করতে
- iOS ডেপ্লয়মেন্ট টার্গেট ১২.০ বা তার উচ্চতর
- Google Mobile Ads Flutter Plugin দিয়ে কনফিগার করা একটি কার্যকরী ফ্লাটার প্রজেক্ট। বিস্তারিত জানতে Google Mobile Ads Flutter Plugin সেট আপ করুন’ দেখুন।
- মধ্যস্থতার ব্যবস্থা করুন ।
ধাপ ১: maio UI-তে কনফিগারেশন সেট আপ করুন
প্রথমে, আপনার মাইও অ্যাকাউন্টে সাইন আপ বা লগ ইন করুন । বাম সাইডবারে থাকা অ্যাপ্লিকেশন ম্যানেজমেন্ট বোতামে ক্লিক করুন এবং নতুন অ্যাপে ক্লিক করুন।

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

আইওএস

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

আইওএস

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

আইওএস

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

আইওএস


ধাপ ২: অ্যাড ম্যানেজার UI-তে মেইল ডিমান্ড সেট আপ করুন।
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন।
অ্যান্ড্রয়েড
নির্দেশাবলীর জন্য, অ্যান্ড্রয়েড গাইডের ধাপ ২ দেখুন।
আইওএস
নির্দেশাবলীর জন্য, iOS গাইডের ধাপ ২ দেখুন।
ধাপ ৩: maio SDK এবং অ্যাডাপ্টার ইম্পোর্ট করুন
pub.dev এর মাধ্যমে একীকরণ
আপনার প্যাকেজের pubspec.yaml ফাইলে maio SDK এবং অ্যাডাপ্টারের সর্বশেষ সংস্করণ সহ নিম্নলিখিত ডিপেন্ডেন্সিটি যোগ করুন:
dependencies:
gma_mediation_maio: ^1.1.3
ম্যানুয়াল ইন্টিগ্রেশন
maio- এর জন্য Google Mobile Ads মিডিয়েশন প্লাগইনের সর্বশেষ সংস্করণটি ডাউনলোড করুন, ডাউনলোড করা ফাইলটি এক্সট্র্যাক্ট করুন এবং এক্সট্র্যাক্ট করা প্লাগইন ফোল্ডারটি (এবং এর ভেতরের সবকিছু) আপনার ফ্লাটার প্রজেক্টে যুক্ত করুন। এরপর, আপনার pubspec.yaml ফাইলে নিম্নলিখিত ডিপেন্ডেন্সিটি যোগ করে প্লাগইনটিকে রেফারেন্স করুন:
dependencies:
gma_mediation_maio:
path: path/to/local/package
ধাপ ৪: প্রয়োজনীয় কোড যোগ করুন
অ্যান্ড্রয়েড
maio ইন্টিগ্রেশনের জন্য কোনো অতিরিক্ত কোডের প্রয়োজন নেই।
আইওএস
SKAdনেটওয়ার্ক ইন্টিগ্রেশন
আপনার প্রোজেক্টের Info.plist ফাইলে SKAdNetwork আইডেন্টিফায়ারগুলো যোগ করতে maio-এর ডকুমেন্টেশন অনুসরণ করুন।
ধাপ ৫: আপনার বাস্তবায়ন পরীক্ষা করুন
টেস্ট বিজ্ঞাপন সক্রিয় করুন
আপনার টেস্ট ডিভাইসটি অ্যাড ম্যানেজারের জন্য রেজিস্টার করা নিশ্চিত করুন।
যেসব পাবলিশার Google Mobile Ads Flutter Plugin ৭.২৬.০ বা তার উচ্চতর সংস্করণ ব্যবহার করেন, তারা রিকোয়েস্ট করার সময় টেস্ট ডিভাইস হিসেবে রেজিস্টার করা ফোন এবং ট্যাবলেটে maio থেকে স্বয়ংক্রিয়ভাবে টেস্ট অ্যাড পাবেন।
পরীক্ষামূলক বিজ্ঞাপন যাচাই করুন
আপনি maio থেকে টেস্ট অ্যাড পাচ্ছেন কিনা তা যাচাই করতে, ad inspector-এ maio (Waterfall) অ্যাড সোর্স(গুলি) ব্যবহার করে সিঙ্গেল অ্যাড সোর্স টেস্টিং সক্ষম করুন।
ত্রুটি কোড
যদি অ্যাডাপ্টারটি maio থেকে কোনো বিজ্ঞাপন গ্রহণ করতে ব্যর্থ হয়, তাহলে পাবলিশাররা নিম্নলিখিত ক্লাসগুলির অধীনে ResponseInfo ব্যবহার করে বিজ্ঞাপনের প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটিটি পরীক্ষা করতে পারেন:
অ্যান্ড্রয়েড
| ফর্ম্যাট | ক্লাসের নাম |
|---|---|
| ইন্টারস্টিশিয়াল | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
| পুরস্কৃত | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
আইওএস
| ফর্ম্যাট | ক্লাসের নাম |
|---|---|
| ইন্টারস্টিশিয়াল | GADMMaioInterstitialAdapter |
| পুরস্কৃত | GADMMaioRewardedAdapter |
যখন কোনো বিজ্ঞাপন লোড হতে ব্যর্থ হয়, তখন maio অ্যাডাপ্টার কর্তৃক প্রদর্শিত কোড এবং সংশ্লিষ্ট বার্তাগুলো নিচে দেওয়া হলো:
অ্যান্ড্রয়েড
| ত্রুটি কোড | কারণ |
|---|---|
| ০-১০ | maio একটি SDK-নির্দিষ্ট ত্রুটি দেখিয়েছে। আরও বিস্তারিত জানতে কোড এবং maio-এর ডকুমেন্টেশন দেখুন। |
| ১০১ | Maio-তে কোনো বিজ্ঞাপন উপলব্ধ নেই। |
| ১০২ | অবৈধ সার্ভার প্যারামিটার (যেমন প্লেসমেন্ট আইডি অনুপস্থিত)। |
| ১০৩ | বিজ্ঞাপন লোড করতে ব্যবহৃত কনটেক্সটটি একটি `Activity` ইনস্ট্যান্স ছিল না। |
আইওএস
| ত্রুটি কোড | কারণ |
|---|---|
| ০-১০ | maio একটি SDK-নির্দিষ্ট ত্রুটি দেখিয়েছে। আরও বিস্তারিত জানতে maio-এর কোড দেখুন। |
| ১০১ | maio-তে এখনও কোনো বিজ্ঞাপন উপলব্ধ নেই। |
| ১০২ | অবৈধ সার্ভার প্যারামিটার (যেমন প্লেসমেন্ট আইডি অনুপস্থিত)। |
| ১০৩ | maio অ্যাডাপ্টারটি অনুরোধ করা ad ফরম্যাটটি সমর্থন করে না। |
| ১০৪ | এই নেটওয়ার্ক কনফিগারেশনের জন্য একটি বিজ্ঞাপন ইতিমধ্যেই লোড করা হয়েছে। |
maio ফ্লাটার মিডিয়েশন অ্যাডাপ্টার চেঞ্জলগ
সংস্করণ ১.১.৪ (নির্মাণাধীন)
সংস্করণ ১.১.৩
- maio অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 2.0.7.0 সমর্থন করে।
- maio iOS অ্যাডাপ্টার সংস্করণ 2.2.0.3 সমর্থন করে।
- গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।
সংস্করণ ১.১.২
- ফ্লাটারের সর্বনিম্ন সংস্করণ ৩.৩৫.১-এ আপডেট করা হয়েছে।
- গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 7.0.0 সমর্থন করার জন্য আপডেট করা হয়েছে।
- maio অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 2.0.8.0 সমর্থন করে।
- maio iOS অ্যাডাপ্টার সংস্করণ 2.2.0.1 সমর্থন করে।
সংস্করণ ১.১.১
- maio অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 2.0.7.0 সমর্থন করে।
- maio iOS অ্যাডাপ্টার সংস্করণ 2.2.0.1 সমর্থন করে।
- গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।
সংস্করণ ১.১.০
- maio অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 2.0.6.0 সমর্থন করে।
- maio iOS অ্যাডাপ্টার সংস্করণ 2.2.0.0 সমর্থন করে।
- গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।
সংস্করণ ১.০.৩
- maio অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 2.0.5.0 সমর্থন করে।
- maio iOS অ্যাডাপ্টার সংস্করণ 2.1.6.1 সমর্থন করে।
- গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।
সংস্করণ ১.০.২
- maio অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 2.0.4.0 সমর্থন করে।
- maio iOS অ্যাডাপ্টার সংস্করণ 2.1.6.1 সমর্থন করে।
- গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।
সংস্করণ ১.০.১
- maio অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 2.0.3.1 সমর্থন করে।
- maio iOS অ্যাডাপ্টার সংস্করণ 2.1.6.1 সমর্থন করে।
- গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।
সংস্করণ ১.০.০
- প্রাথমিক প্রকাশ।
- maio অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 2.0.3.0 সমর্থন করে।
- maio iOS অ্যাডাপ্টার সংস্করণ 2.1.6.0 সমর্থন করে।
- গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ ৫.৩.১ দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।