এই নির্দেশিকা থেকে আপনি জানতে পারবেন কীভাবে Google Mobile Ads Flutter Plugin ব্যবহার করে মিডিয়েশন-এর মাধ্যমে LY Ads Network থেকে বিজ্ঞাপন লোড ও ডিসপ্লে করতে হয়, যার মধ্যে ওয়াটারফল ইন্টিগ্রেশনও কভার করা হয়। এতে LY Ads Network-কে বিজ্ঞাপন ইউনিটের মিডিয়েশন কনফিগারেশনে কীভাবে যোগ করতে হয় এবং LY Ads Network SDK ও অ্যাডাপ্টারকে Flutter অ্যাপে কীভাবে ইন্টিগ্রেট করতে হয় তা কভার করা হয়েছে।
যেসব ইন্টিগ্রেশন ও বিজ্ঞাপনের ফর্ম্যাট ব্যবহার করা যায়
LY Ads Network-এর জন্য 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 সেট-আপ করুন দেখুন।
ধাপ ১: LY Ads Network UI-তে কনফিগারেশন সেট-আপ করা
আপনার LY Ads Network অ্যাকাউন্টে সাইন-আপ ও লগ-ইন করুন।
নতুন অ্যাপ্লিকেশন যোগ করুন
অ্যাপ ট্যাবে গিয়ে নতুন রেজিস্ট্রেশন বোতামে ক্লিক করুন।
ফর্ম পূরণ করে রেজিস্ট্রেশন বিকল্পে ক্লিক করুন।
অ্যাপ আইডি নোট করে রাখুন।
Android
iOS
বিজ্ঞাপন স্লট তৈরি করা
অ্যাপ ট্যাবে, আপনার অ্যাপের বিবরণ দেখতে আপনার অ্যাপ বেছে নিন। স্লট বিভাগের মধ্যে, যোগ করুন বিকল্পে ক্লিক করুন।
স্লট সম্পর্কে বিস্তারিত জানতে ফর্মটি পূরণ করুন। বিডিংয়ের ধরন-এর জন্য, ওয়াটারফল মধ্যস্থতার জন্য এই স্লট কনফিগার করতে স্ট্যান্ডার্ড বেছে নিন অথবা বিডিংয়ের জন্য এই স্লট কনফিগার করতে Google SDK বিডিং বেছে নিন। ফর্ম পূরণ করা হয়ে গেলে তৈরি করুন বিকল্পে ক্লিক করুন।
স্লট আইডি নোট করে রাখুন।
আপনার প্রথম স্লট তৈরি করার পরে, LY Ads Network থেকে অনুমোদন পেতে আপনার অ্যাপের বিবরণ পৃষ্ঠায় পর্যালোচনা করুন বিকল্পে ক্লিক করুন। এতে কিছুটা সময় লাগতে পারে। আপনার কোনও প্রশ্ন থাকলে, LY Ads Network প্রতিনিধির সাথে যোগাযোগ করুন।
রিপোর্টিং API Key তৈরি করা
রিপোর্টিং API key ম্যানেজ করা ট্যাবে গিয়ে API key তৈরি করুন বোতামে ক্লিক করুন।
ফর্ম পূরণ করে সেভ করুন বিকল্পে ক্লিক করুন।
আপনার API Key ID এবং API Key Secret নোট করে রাখুন।
আপনার app-ads.txt আপডেট করুন
অ্যাপের জন্য অনুমোদিত বিক্রেতা বা app-ads.txt হল IAB Tech Lab-এর একটি উদ্যোগ যা আপনার অ্যাপের বিজ্ঞাপন ইনভেনটরি শুধুমাত্র আপনার অনুমোদিত চ্যানেলের মাধ্যমে বিক্রি করা নিশ্চিত করতে সাহায্য করে। বিজ্ঞাপন থেকে উপার্জনে
উল্লেখযোগ্য ক্ষতি এড়াতে, আপনাকে একটি app-ads.txt ফাইল প্রয়োগ করতে হবে।
আপনি আগে থেকে এটি না করে থাকলে,
Ad Manager-এর জন্য app-ads.txt ফাইল তৈরি করুন।
LY বিজ্ঞাপন নেটওয়ার্কের জন্য app-ads.txt প্রয়োগ করতে, app-ads.txt সম্পর্কে দেখুন।
ধাপ ২: Ad Manager UI-তে LY Ads Network ডিমান্ড সেট-আপ করা
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন
Android
নির্দেশাবলীর জন্য, Android-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।
iOS
নির্দেশাবলীর জন্য, iOS-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।
ধাপ ৩: LY Ads Network SDK ও অ্যাডাপ্টার ইম্পোর্ট করা
pub.dev-এর মাধ্যমে ইন্টিগ্রেশন
আপনার প্যাকেজের pubspec.yaml ফাইলে LY Ads Network SDK এবং অ্যাডাপ্টারের লেটেস্ট ভার্সনের সাথে নিম্নলিখিত ডিপেন্ডেন্সি যোগ করুন:
dependencies:
gma_mediation_line: ^2.2.1
ম্যানুয়াল ইন্টিগ্রেশন
LY Ads Network-এর জন্য
Google Mobile Ads মিডিয়েশন প্লাগ-ইনের লেটেস্ট ভার্সন ডাউনলোড করুন,
ডাউনলোড করা ফাইল এক্সট্র্যাক্ট করুন এবং এক্সট্র্যাক্ট করা প্লাগ-ইন ফোল্ডার
(এবং এর কন্টেন্ট) আপনার Flutter প্রোজেক্টে যোগ করুন। তারপর, নিম্নলিখিত ডিপেন্ডেন্সি যোগ করে আপনার
pubspec.yaml ফাইলে প্লাগ-ইন রেফারেন্স করুন:
dependencies:
gma_mediation_line:
path: path/to/local/package
ধাপ ৪: প্রয়োজনীয় কোড যোগ করুন
Android
LY Ads Network ইন্টিগ্রেশনের জন্য কোনও অতিরিক্ত কোডের প্রয়োজন নেই।
iOS
SKAdNetwork ইন্টিগ্রেশন
আপনার প্রোজেক্টের Info.plist ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে
LY Ads Network-এর ডকুমেন্টেশন অনুসরণ করুন।
ধাপ ৫: আপনার ইমপ্লিমেন্টেশন পরীক্ষা করুন
টেস্ট বিজ্ঞাপন চালু করুন
Ad Manager-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করতে ভুলবেন না।
টেস্ট বিজ্ঞাপন যাচাই করা
আপনি LY Ads Network থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, LY Ads Network বিজ্ঞাপন সোর্স ব্যবহার করে বিজ্ঞাপন ইনস্পেক্টরে সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন।
ঐচ্ছিক ধাপ
নেটওয়ার্ক-নির্দিষ্ট প্যারামিটার
LY Ads Network Flutter মধ্যস্থতা প্লাগ-ইন নিম্নলিখিত অতিরিক্ত অনুরোধ প্যারামিটারকে সাপোর্ট করে যা
LineMediationExtras ক্লাসের মাধ্যমে অ্যাডাপ্টারে পাস করা যেতে পারে:
-
enableAdSound: ব্যানার, ইন্টারস্টিশিয়াল ও পুরস্কার প্রদানকারী বিজ্ঞাপনের ডিফল্ট সাউন্ড স্টার্ট স্টেট নির্দিষ্ট করে।
এইসব প্যারামিটার সেট করে এমন বিজ্ঞাপনের অনুরোধ কীভাবে তৈরি করতে হয় তার কোডের উদাহরণ এখানে দেওয়া হল:
LineMediationExtras lineExtras = LineMediationExtras(enableAdSound: true)
AdRequest request = AdRequest(
keywords: <String>['foo', 'bar'],
contentUrl: 'http://foo.com/bar.html',
mediationExtras: [lineExtras],
);
ত্রুটি কোড
LY Ads Network থেকে অ্যাডাপ্টার বিজ্ঞাপন পেতে না পারলে,
প্রকাশকরা নিম্নলিখিত ক্লাসের অধীনে ResponseInfo ব্যবহার করে
বিজ্ঞাপনের উত্তর থেকে অন্তর্নিহিত সমস্যা চেক করতে পারবেন:
Android
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
LY Ads Network অ্যাডাপ্টার কোনও বিজ্ঞাপন লোড করতে না পারলে, যেসব কোড ও মেসেজ দেখায় সেগুলি এখানে দেওয়া হল:
Android
| সমস্যার কোড | ডোমেন | কারণ |
|---|---|---|
| 1-10 | com.five_corp.ad | LY Ads Network SDK থেকে SDK-নির্দিষ্ট সমস্যা পাওয়া গেছে। আরও বিবরণের জন্য LY Ads Network-এর ডকুমেন্টেশন দেখুন। |
| ১০১ | com.google.ads.mediation.line | অ্যাপ্লিকেশন আইডি নেই বা ভুল আছে। |
| 102 | com.google.ads.mediation.line | স্লট আইডি নেই বা ভুল আছে। |
| 103 | com.google.ads.mediation.line | অনুরোধ করা বিজ্ঞাপনের সাইজ LY Ads Network-এ কাজ করে এমন ব্যানার বিজ্ঞাপনের সাইজের সাথে মিলছে না। |
| 104 | com.google.ads.mediation.line | অ্যাক্টিভিটি প্রসঙ্গ না থাকার কারণে ইন্টারস্টিশিয়াল বা পুরস্কার প্রদানকারী বিজ্ঞাপন লোড করা যায়নি। |
| ১০৫ | com.google.ads.mediation.line | LY Ads Network SDK ইন্টারস্টিশিয়াল বা পুরস্কার প্রদানকারী বিজ্ঞাপন দেখাতে পারেনি। |
| 106 | com.google.ads.mediation.line | অ্যাসেট না থাকার কারণে নেটিভ বিজ্ঞাপন লোড করা যায়নি। |
| 107 | com.google.ads.mediation.line | FiveAd SDK একটি নাল বিজ্ঞাপন লোডার রিটার্ন করেছে। |
iOS
| সমস্যার কোড | ডোমেন | কারণ |
|---|---|---|
| 1-10 | LY Ads Network SDK-এর মাধ্যমে পাঠানো হয়েছে | LY Ads Network SDK থেকে SDK-নির্দিষ্ট সমস্যা পাওয়া গেছে। আরও বিবরণের জন্য LY Ads Network-এর ডকুমেন্টেশন দেখুন। |
| ১০১ | com.google.ads.mediation.line | সার্ভার প্যারামিটার ভুল (যেমন, অ্যাপ্লিকেশন আইডি বা স্লট আইডি নেই)। |
| 102 | com.google.ads.mediation.line | অনুরোধ করা বিজ্ঞাপনের সাইজ LY Ads Network-এ কাজ করে এমন ব্যানার বিজ্ঞাপনের সাইজের সাথে মিলছে না। |
| 103 | com.google.ads.mediation.line | নেটিভ বিজ্ঞাপনে তথ্যের আইকন ইমেজ অ্যাসেট লোড করা যায়নি। |
| 104 | com.google.ads.mediation.line | বিডিংয়ের জন্য সিগন্যাল সংগ্রহ করা যায়নি। |
| ১০৫ | com.google.ads.mediation.line | LINE Ads SDK বিজ্ঞাপন লোডার শুরু করা যায়নি। |
Line Flutter Mediation Adapter Changelog
ভার্সন ২.২.২ (কাজ চলছে)
- এখন iOS-এর ন্যূনতম ভার্সন 15.0 প্রয়োজন।
ভার্সন ২.২.১
- Line Android অ্যাডাপ্টার ভার্সন 3.1.1.2-এ কাজ করে।
- Line iOS অ্যাডাপ্টার ভার্সন 3.1.1.0-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 9.1.0-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে
ভার্সন ২.২.০
- Line Android অ্যাডাপ্টার ভার্সন 3.1.1.1-এ কাজ করে।
- Line iOS অ্যাডাপ্টার ভার্সন 3.1.0.0-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 9.1.0-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে
ভার্সন ২.১.৩
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 9.1.0-এ কাজ করার জন্য আপডেট করা হয়েছে।
- Swift প্যাকেজ ম্যানেজার সংক্রান্ত সুবিধা যোগ করা হয়েছে।
- Line Android অ্যাডাপ্টার ভার্সন 3.1.1.1-এ কাজ করে।
- Line iOS অ্যাডাপ্টার ভার্সন 3.0.1.2-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 9.1.0-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে
ভার্সন ২.১.২
- Line Android অ্যাডাপ্টার ভার্সন 3.1.1.1-এ কাজ করে।
- Line iOS অ্যাডাপ্টার ভার্সন 3.0.1.2-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 9.0.0-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে
ভার্সন ২.১.১
- Line Android অ্যাডাপ্টার ভার্সন 3.1.1.0-এ কাজ করে।
- Line iOS অ্যাডাপ্টার ভার্সন 3.0.1.2-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 9.0.0-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে
ভার্সন 2.1.0
- Flutter-এর ন্যূনতম ভার্সন 3.38.1-এ আপডেট করা হয়েছে
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন ৮.০.০-এর সাথে কাজ করার জন্য আপডেট করা হয়েছে
- Line Android অ্যাডাপ্টার ভার্সন 3.1.0.0-এ কাজ করে।
- Line iOS অ্যাডাপ্টার ভার্সন 3.0.1.0-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন ৮.০.০-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে
ভার্সন 2.0.0
- Flutter-এর ন্যূনতম ভার্সন 3.35.1-এ আপডেট করা হয়েছে
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন ৭.০.০-এর সাথে কাজ করার জন্য আপডেট করা হয়েছে
- Line Android অ্যাডাপ্টার ভার্সন 3.0.1.0-এ কাজ করে।
- Line iOS অ্যাডাপ্টার ভার্সন 3.0.0.0-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন ৭.০.০-এর মাধ্যমে তৈরি ও পরীক্ষা করা হয়েছে
ভার্সন ১.০.৬
- Line Android অ্যাডাপ্টার ভার্সন 2.9.20251028.0-এ কাজ করে।
- Line iOS অ্যাডাপ্টার ভার্সন 2.9.20251119.0-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 6.0.0-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে
ভার্সন ১.০.৫
- Line Android অ্যাডাপ্টার ভার্সন 2.9.20250924.1-এ কাজ করে।
- Line iOS অ্যাডাপ্টার ভার্সন 2.9.20250930.0 কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 6.0.0-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে
ভার্সন 1.0.4
- Line Android অ্যাডাপ্টার ভার্সন 2.9.20250718.0-এ কাজ করে।
- Line iOS অ্যাডাপ্টার ভার্সন 2.9.20250512.0 কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 6.0.0-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে
ভার্সন 1.0.3
- Line Android অ্যাডাপ্টার ভার্সন 2.9.20250519.0-এ কাজ করে।
- Line iOS অ্যাডাপ্টার ভার্সন 2.9.20250512.0 কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 6.0.0-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে
ভার্সন 1.0.2
- Line Android অ্যাডাপ্টার ভার্সন 2.9.20250317.1-এ কাজ করে।
- Line iOS অ্যাডাপ্টার ভার্সন 2.9.20241106.3-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 6.0.0-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে
ভার্সন ১.০.১
- Line Android অ্যাডাপ্টার ভার্সন 2.9.20250110.1-এ কাজ করে।
- Line iOS অ্যাডাপ্টার ভার্সন 2.9.20241106.2 কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন ৫.৩.১-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে।
ভার্সন 1.0.0
- প্রাথমিক রিলিজ।
- Line Android অ্যাডাপ্টার ভার্সন 2.9.20250110.0-এ কাজ করে।
- Line iOS অ্যাডাপ্টার ভার্সন 2.9.20241106.1 কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন ৫.৩.১-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে।