মধ্যস্থতার সাথে LY Ads Network ইন্টিগ্রেট করা

এই নির্দেশিকা আপনাকে দেখায় যে কীভাবে Google Mobile Ads Flutter Plugin ব্যবহার করে LY Ads Network থেকে মিডিয়েশন ব্যবহার করে বিজ্ঞাপন লোড এবং প্রদর্শন করতে হয়, যা ওয়াটারফল ইন্টিগ্রেশন কভার করে। এটি কোনও বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে কীভাবে LY Ads Network যোগ করতে হয় এবং কীভাবে Flutter অ্যাপে LY Ads Network SDK এবং অ্যাডাপ্টার ইন্টিগ্রেট করতে হয় তা কভার করে।

যেসব ইন্টিগ্রেশন ও বিজ্ঞাপনের ফর্ম্যাট ব্যবহার করা যায়

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 অ্যাকাউন্টে সাইন-আপ ও লগ-ইন করুন।

নতুন অ্যাপ্লিকেশন যোগ করুন

অ্যাপ ট্যাবে গিয়ে নতুন রেজিস্ট্রেশন বোতামে ক্লিক করুন।

ফর্ম পূরণ করে রেজিস্ট্রেশন বিকল্পে ক্লিক করুন।

অ্যাপ আইডি মনে রাখুন।

বিজ্ঞাপন স্লট তৈরি করা

অ্যাপ ট্যাবে, আপনার অ্যাপের বিবরণ দেখতে সেটি বেছে নিন। স্লট বিভাগের মধ্যে, যোগ করুন বিকল্পে ক্লিক করুন।

স্লট সম্পর্কে বিস্তারিত জানতে ফর্মটি পূরণ করুন। বিডিংয়ের ধরন-এর জন্য, স্ট্যান্ডার্ড বেছে নিন যাতে ওয়াটারফল মিডিয়েশনের জন্য এই স্লট কনফিগার করা যায় অথবা Google SDK বিডিং বেছে নিন যাতে বিডিংয়ের জন্য এই স্লট কনফিগার করা যায়। ফর্ম পূরণ করা হয়ে গেলে তৈরি করুন বিকল্পে ক্লিক করুন।

স্লট আইডি নোট করে রাখুন।

আপনার প্রথম স্লট তৈরি করার পরে, LY বিজ্ঞাপন নেটওয়ার্ক থেকে অনুমোদন পেতে আপনার অ্যাপের বিবরণ পৃষ্ঠায় পর্যালোচনা করুন বিকল্পে ক্লিক করুন। এতে কিছুটা সময় লাগতে পারে। আপনার কোনও প্রশ্ন থাকলে, 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 ডিমান্ড সেট-আপ করা

আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন

ধাপ ৩: 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

ধাপ ৪: প্রয়োজনীয় কোড যোগ করুন

ধাপ ৫: আপনার ইমপ্লিমেন্টেশন পরীক্ষা করুন

টেস্ট বিজ্ঞাপন চালু করা

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 ব্যবহার করে বিজ্ঞাপনের উত্তর থেকে অন্তর্নিহিত ত্রুটি চেক করতে পারবেন:

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

GADMediationAdapterLine

LY Ads Network অ্যাডাপ্টার কোনও বিজ্ঞাপন লোড করতে না পারলে, যেসব কোড ও মেসেজ দেখায় সেগুলি এখানে দেওয়া হল:

Line Flutter Mediation Adapter Changelog

ভার্সন 2.2.2 (কাজ চলছে)

• এখন ন্যূনতম 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 Plugin ভার্সন 9.1.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে

ভার্সন 2.1.3

• Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 9.1.0-এ কাজ করার জন্য আপডেট করা হয়েছে।
• Swift প্যাকেজ ম্যানেজার সংক্রান্ত সুবিধা যোগ করা হয়েছে।
• Line Android অ্যাডাপ্টার ভার্সন 3.1.1.1 কাজ করে।
• Line iOS অ্যাডাপ্টার ভার্সন 3.0.1.2-এ কাজ করে।
• Google Mobile Ads Flutter Plugin ভার্সন 9.1.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে

ভার্সন ২.১.২

• Line Android অ্যাডাপ্টার ভার্সন 3.1.1.1-এ কাজ করে।
• Line iOS অ্যাডাপ্টার ভার্সন 3.0.1.2-এ কাজ করে।
• Google Mobile Ads Flutter Plugin ভার্সন 9.0.0-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে

ভার্সন 2.1.1

• Line Android অ্যাডাপ্টার ভার্সন 3.1.1.0-এ কাজ করে।
• Line iOS অ্যাডাপ্টার ভার্সন 3.0.1.2-এ কাজ করে।
• Google Mobile Ads Flutter Plugin ভার্সন 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 Plugin ভার্সন 6.0.0-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে

ভার্সন ১.০.৫

• Line Android অ্যাডাপ্টার ভার্সন 2.9.20250924.1-এ কাজ করে।
• Line iOS অ্যাডাপ্টার ভার্সন 2.9.20250930.0 কাজ করে।
• Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 6.0.0-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে

ভার্সন ১.০.৪

• 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-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে

ভার্সন 1.0.1

• 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 প্লাগ-ইন ভার্সন ৫.৩.১-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে।