এই নির্দেশিকা থেকে আপনি জানতে পারবেন কীভাবে Google Mobile Ads Flutter Plugin ব্যবহার করে মিডিয়েশন-এর মাধ্যমে i-mobile থেকে বিজ্ঞাপন লোড ও ডিসপ্লে করতে হয়, যার মধ্যে ওয়াটারফল ইন্টিগ্রেশনও কভার করা হয়। এটি বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে i-mobile কীভাবে যোগ করতে হয় এবং Flutter অ্যাপে i-mobile SDK ও অ্যাডাপ্টার কীভাবে ইন্টিগ্রেট করতে হয় তা কভার করে।
i-mobile-এর ড্যাশবোর্ড ইন্টারফেসের লেবেল, বোতাম ও বিবরণে জাপানি টেক্সট ব্যবহার করা হয়। এই গাইডের স্ক্রিনশটগুলি অনুবাদ করা হয়নি। তবে, এই গাইডের বিবরণ ও নির্দেশাবলীতে, লেবেল ও বোতামের অনুবাদ করা হয়েছে এবং বন্ধনীতে সেগুলির ইংরেজি সমার্থক শব্দ দেওয়া হয়েছে।
যেসব ইন্টিগ্রেশন ও বিজ্ঞাপনের ফর্ম্যাট ব্যবহার করা যায়
i-mobile-এর জন্য Ad Manager মিডিয়েশন অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা আছে:
| ইন্টিগ্রেশন | |
|---|---|
| বিডিং | |
| জলপ্রপাত | |
| ফর্ম্যাট | |
| অ্যাপ খোলার সাথে সাথে দেখা যায় | |
| ব্যানার | |
| স্থান | |
| পুরস্কার জিতেছেন | |
| পুরস্কৃত ইন্টারস্টিশিয়াল | |
| নেটিভ | |
পূর্বশর্ত
চালিয়ে যাওয়ার আগে, নিম্নলিখিত বিষয়গুলি যাচাই করুন:
- লেটেস্ট Google Mobile Ads Flutter Plugin ভার্সন।
- Flutter ফ্রেমওয়ার্ক ভার্সন 3.7.0 বা তার পরবর্তী যেকোনও ভার্সন।
- Android-এ ডিপ্লয় করতে
- Android API লেভেল ২৪ বা তার পরের ভার্সন।
- iOS-এ ডিপ্লয় করতে
- iOS ডেপ্লয়মেন্ট টার্গেট 13.0 বা তার পরবর্তী যেকোনও ভার্সন।
- Google Mobile Ads Flutter Plugin-এর সাথে কনফিগার করা একটি কার্যকরী Flutter প্রোজেক্ট। আরও বিবরণের জন্য Google Mobile Ads Flutter Plugin সেট-আপ করুন দেখুন।
ধাপ ১: i-mobile UI-তে কনফিগারেশন সেট-আপ করা
আপনার i-mobile অ্যাকাউন্টে সাইন-আপ বা লগ-ইন করুন।
サイト/アプリ管理 (Site/Application Management) ট্যাব এবং আপনার অ্যাপের প্ল্যাটফর্মের জন্য বোতামে ক্লিক করে i-mobile ড্যাশবোর্ডে আপনার অ্যাপ যোগ করুন।
Android

iOS

ফর্ম পূরণ করে 新規登録 (সাইন-আপ করুন) বোতামে ক্লিক করুন।
Android

iOS

নতুন বিজ্ঞাপন স্পট তৈরি করতে, サイト/アプリ管理 (সাইট/অ্যাপ্লিকেশন ম্যানেজমেন্ট) ট্যাবের অধীনে আপনার অ্যাপ বেছে নিন।
Android

iOS

広告スポット管理 (Ad Spot Management) ট্যাবে গিয়ে 新規広告スポット (New Ad Spot) বোতামে ক্লিক করুন।
এরপর, 広告スポット名 (বিজ্ঞাপন স্পটের নাম), 広告スポットサイズ (বিজ্ঞাপন স্পটের সাইজ) এবং অন্যান্য বিবরণ দিয়ে ফর্মটি পূরণ করুন। তারপর, 新規登録 (সাইন-আপ করুন) বোতামে ক্লিক করুন।
আপনার নতুন বিজ্ঞাপন স্পট রেডি আছে। ইন্টিগ্রেশন সংক্রান্ত বিবরণ দেখতে, アプリ設定取得 (Get App settings) বোতামে ক্লিক করুন।
パブリッシャーID (প্রকাশক আইডি), メディアID (মিডিয়া আইডি), এবং スポットID (স্পট আইডি) নোট করে রাখুন। Ad Manager UI-তে মধ্যস্থতার জন্য i-mobile কনফিগার করার সময় আপনাকে পরে এইসব প্যারামিটার ব্যবহার করতে হবে।
Android

iOS

আপনার app-ads.txt আপডেট করুন
অ্যাপের জন্য অনুমোদিত বিক্রেতা বা app-ads.txt হল IAB Tech Lab-এর একটি উদ্যোগ যা আপনার অ্যাপের বিজ্ঞাপন ইনভেনটরি শুধুমাত্র আপনার অনুমোদিত চ্যানেলের মাধ্যমে বিক্রি করা নিশ্চিত করতে সাহায্য করে। বিজ্ঞাপন থেকে উপার্জনে
উল্লেখযোগ্য ক্ষতি এড়াতে, আপনাকে একটি app-ads.txt ফাইল প্রয়োগ করতে হবে।
আপনি আগে থেকে এটি না করে থাকলে,
Ad Manager-এর জন্য app-ads.txt ফাইল তৈরি করুন।
i-mobile-এর জন্য app-ads.txt প্রয়োগ করতে, তাদের
প্রায়শই জিজ্ঞাসিত প্রশ্ন দেখুন।
ধাপ ২: Ad Manager UI-তে i-mobile ডিমান্ড সেট-আপ করা
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন
Android
নির্দেশাবলীর জন্য, Android-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।
iOS
নির্দেশাবলীর জন্য, iOS-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।
ধাপ ৩: i-mobile SDK ও অ্যাডাপ্টার ইমপোর্ট করা
pub.dev-এর মাধ্যমে ইন্টিগ্রেশন
(শুধুমাত্র Android) আপনার প্রোজেক্টের android ডিরেক্টরির মধ্যে থাকা build.gradle ফাইলে নিম্নলিখিত রিপোজিটরি যোগ করুন:
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile.github.io/adnw-sdk-android")
}
}
আপনার প্যাকেজের pubspec.yaml ফাইলে i-mobile SDK এবং অ্যাডাপ্টারের লেটেস্ট ভার্সনের সাথে নিম্নলিখিত ডিপেন্ডেন্সি যোগ করুন:
dependencies:
gma_mediation_imobile: ^1.0.6
ম্যানুয়াল ইন্টিগ্রেশন
i-mobile-এর জন্য
Google Mobile Ads মিডিয়েশন প্লাগ-ইনের লেটেস্ট ভার্সন ডাউনলোড করুন,
ডাউনলোড করা ফাইল এক্সট্র্যাক্ট করুন এবং এক্সট্র্যাক্ট করা প্লাগ-ইন ফোল্ডার
(এবং এর কন্টেন্ট) আপনার Flutter প্রোজেক্টে যোগ করুন। তারপর, নিম্নলিখিত ডিপেন্ডেন্সি যোগ করে আপনার
pubspec.yaml ফাইলে প্লাগ-ইন রেফারেন্স করুন:
dependencies:
gma_mediation_imobile:
path: path/to/local/package
ধাপ ৪: অতিরিক্ত কোড প্রয়োজন
Android
i-mobile ইন্টিগ্রেশনের জন্য অতিরিক্ত কোনও কোডের প্রয়োজন নেই।
iOS
SKAdNetwork ইন্টিগ্রেশন
আপনার প্রোজেক্টের Info.plist ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে
i-mobile-এর ডকুমেন্টেশন অনুসরণ করুন।
ধাপ ৫: আপনার ইমপ্লিমেন্টেশন পরীক্ষা করুন
টেস্ট বিজ্ঞাপন চালু করুন
Ad Manager-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করতে ভুলবেন না। i-mobile টেস্টিংয়ের জন্য টেস্ট Spot ID, মিডিয়া আইডি এবং প্রকাশক আইডি প্রদান করে, আপনি সেগুলি এখানে খুঁজে পাবেন।
টেস্ট বিজ্ঞাপন যাচাই করা
আপনি i-mobile থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, i-mobile (ওয়াটারফল) বিজ্ঞাপন সোর্স ব্যবহার করে বিজ্ঞাপন ইন্সপেক্টরে সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন।
ত্রুটি কোড
i-mobile থেকে অ্যাডাপ্টার বিজ্ঞাপন পেতে না পারলে, প্রকাশকরা ResponseInfo ব্যবহার করে
বিজ্ঞাপনের উত্তর থেকে অন্তর্নিহিত সমস্যা চেক করতে পারবেন
নিম্নলিখিত ক্লাসগুলির অধীনে:
Android
| ফর্ম্যাট | ক্লাসের নাম |
|---|---|
| ব্যানার | com.google.ads.mediation.imobile.IMobileAdapter |
| স্থান | com.google.ads.mediation.imobile.IMobileAdapter |
| নেটিভ | com.google.ads.mediation.imobile.IMobileMediationAdapter |
iOS
| ফর্ম্যাট | ক্লাসের নাম |
|---|---|
| ব্যানার | IMobileAdapter |
| স্থান | IMobileAdapter |
| নেটিভ | GADMediationAdapterIMobile |
কোনও বিজ্ঞাপন লোড না হলে i-mobile অ্যাডাপ্টারের মাধ্যমে দেখানো কোড ও মেসেজ এখানে দেওয়া হল:
Android
| সমস্যার কোড | কারণ |
|---|---|
| 0-99 | i-mobile SDK-তে সমস্যা হয়েছে। আরও বিবরণের জন্য কোড দেখুন। |
| ১০১ | i-mobile-এ বিজ্ঞাপন লোড করার জন্য Activity কনটেক্সট প্রয়োজন। |
| 102 | Ad Manager UI-তে কনফিগার করা i-mobile সার্ভার প্যারামিটার নেই বা ভুল। |
| 103 | অনুরোধ করা বিজ্ঞাপনের সাইজ i-mobile-এ কাজ করে এমন ব্যানারের সাইজের সাথে মিলছে না। |
| 104 | i-mobile-এর নেটিভ বিজ্ঞাপন লোড হওয়ার সাকসেস কলব্যাক একটি খালি নেটিভ বিজ্ঞাপনের তালিকা ফিরিয়ে দিয়েছে। |
iOS
| সমস্যার কোড | কারণ |
|---|---|
| 0-10 | i-mobile SDK-তে সমস্যা হয়েছে। আরও বিবরণের জন্য কোড দেখুন। |
| ১০১ | Ad Manager UI-তে কনফিগার করা i-mobile সার্ভার প্যারামিটার নেই বা ভুল। |
| 102 | অনুরোধ করা বিজ্ঞাপনের সাইজ i-mobile-এ কাজ করে এমন ব্যানারের সাইজের সাথে মিলছে না। |
| 103 | i-mobile বিজ্ঞাপন দেখাতে পারেনি। |
| 104 | i-mobile একটি খালি নেটিভ বিজ্ঞাপন অ্যারে রিটার্ন করেছে। |
| ১০৫ | i-mobile নেটিভ বিজ্ঞাপন অ্যাসেট ডাউনলোড করতে পারেনি। |
| 106 | একই স্পট আইডি ব্যবহার করে একাধিক ইন্টারস্টিশিয়াল বিজ্ঞাপনের জন্য অনুরোধ করার সুবিধা i-mobile-এ নেই। |
i-mobile Flutter মিডিয়েশন অ্যাডাপ্টার চেঞ্জলগ
ভার্সন ১.০.৬
- i-mobile Android অ্যাডাপ্টার ভার্সন 2.3.2.5-এ কাজ করে।
- i-mobile iOS অ্যাডাপ্টার ভার্সন 2.3.4.8-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 9.1.0-এর মাধ্যমে তৈরি ও পরীক্ষা করা হয়েছে।
ভার্সন ১.০.৫
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 9.1.0-এ কাজ করার জন্য আপডেট করা হয়েছে।
- Swift প্যাকেজ ম্যানেজার সংক্রান্ত সুবিধা যোগ করুন।
- i-mobile Android অ্যাডাপ্টার ভার্সন 2.3.2.4-এ কাজ করে।
- i-mobile iOS অ্যাডাপ্টার ভার্সন 2.3.4.8-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 9.1.0-এর মাধ্যমে তৈরি ও পরীক্ষা করা হয়েছে।
ভার্সন 1.0.4
- i-mobile Android অ্যাডাপ্টার ভার্সন 2.3.2.3-এ কাজ করে।
- i-mobile iOS অ্যাডাপ্টার ভার্সন 2.3.4.7-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 8.0.0-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে।
ভার্সন 1.0.3
- Flutter-এর ন্যূনতম ভার্সন 3.38.1-এ আপডেট করা হয়েছে
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন ৮.০.০-এর সাথে কাজ করার জন্য আপডেট করা হয়েছে
- i-mobile Android অ্যাডাপ্টার ভার্সন 2.3.2.3-এ কাজ করে।
- i-mobile iOS অ্যাডাপ্টার ভার্সন 2.3.4.6-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 8.0.0-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে।
ভার্সন 1.0.2
- i-mobile Android অ্যাডাপ্টার ভার্সন 2.3.2.1-এ কাজ করে।
- i-mobile iOS অ্যাডাপ্টার ভার্সন 2.3.4.3-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 6.0.0-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে।
ভার্সন ১.০.১
- i-mobile Android অ্যাডাপ্টার ভার্সন 2.3.2.1-এ কাজ করে।
- i-mobile iOS অ্যাডাপ্টার ভার্সন 2.3.4.2 কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 6.0.0-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে।
ভার্সন 1.0.0
- প্রাথমিক রিলিজ।
- i-mobile Android অ্যাডাপ্টার ভার্সন 2.3.2.0-এ কাজ করে।
- i-mobile iOS অ্যাডাপ্টার ভার্সন 2.3.4.1-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন ৫.৩.১-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে।