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

প্ল্যাটফর্ম বেছে নিন: Android iOS Unity Flutter Android (Legacy)

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

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

LY Ads Network-এর জন্য AdMob মধ্যস্থতা অ্যাডাপ্টরের নিম্নলিখিত ক্ষমতা আছে:

ইন্টিগ্রেশন
বিডিং
জলপ্রপাত
ফর্ম্যাট
ব্যানার
স্থান
পুরস্কার জিতেছেন

পূর্বশর্ত

এগিয়ে যাওয়ার আগে, নিম্নলিখিত বিষয়গুলি যাচাই করিয়ে নিন:

  • Google Mobile Ads Unity Plugin-এর লেটেস্ট ভার্সন।
  • Unity Editor ভার্সন 4 বা তার পরবর্তী যেকোনও ভার্সন।
  • [বিডিংয়ের জন্য]: বিডিংয়ে কাজ করে এমন সব বিজ্ঞাপন ফর্ম্যাট ইন্টিগ্রেট করতে, LY Ads Network 1.5.0 বা এর পরের যেকোনও ভার্সনের জন্য Google Mobile Ads মধ্যস্থতা প্লাগ-ইন ব্যবহার করুন (লেটেস্ট ভার্সন ব্যবহার করার সাজেশন দেওয়া হয়)।
  • Android-এ ডেপ্লয় করতে
    • Android API লেভেল 24 বা এর পরের যেকোনও ভার্সন।
  • iOS-এ ডেপ্লয় করতে
    • iOS ডিপ্লয়মেন্ট টার্গেট 13.0 বা তার পরের যেকোনও ভার্সন।
  • Google Mobile Ads Unity Plugin-এর সাথে কনফিগার করা একটি চালু Unity প্রোজেক্ট। আরও বিবরণের জন্য সেট-আপ Google Mobile Ads Unity Plugin দেখুন।
  • AdMob মধ্যস্থতা সেট-আপ করুন।

ধাপ ১: LY Ads Network UI-তে কনফিগারেশন সেট-আপ করুন

আপনার LY Ads Network অ্যাকাউন্টে সাইন-আপ ও লগ-ইন করুন।

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

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

নতুন রেজিস্ট্রেশন

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

নতুন রেজিস্ট্রেশন ফর্ম

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

Android

রেজিস্ট্রেশনের বিবরণ

iOS

রেজিস্ট্রেশনের বিবরণ

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

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

স্লট যোগ করুন

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

স্লট ফর্ম যোগ করা

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

স্লটের বিবরণ

প্রথম স্লট তৈরি করার পরে, LY Ads Network-এর থেকে অনুমোদন পেতে আপনার অ্যাপের বিবরণ পৃষ্ঠায় পর্যালোচনা করুন বিকল্পে ক্লিক করুন। এতে কিছুটা সময় লাগতে পারে। আপনার কোনও প্রশ্ন থাকলে LY Ads নেটওয়ার্ক প্রতিনিধির সাথে যোগাযোগ করুন।

পর্যালোচনা করার অনুরোধ করুন

রিপোর্টিং API কী তৈরি করা

রিপোর্টিং API key ম্যানেজ করা ট্যাবে নেভিগেট করে API key তৈরি করুন বোতামে ক্লিক করুন।

রিপোর্টিং API কী ট্যাব

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

রিপোর্টিং API কী ফর্ম

আপনার API Key ID এবং API Key Secret মনে রাখবেন।

রিপোর্টিং API কী ফর্ম

আপনার app-ads.txt আপডেট করা

অ্যাপের জন্য অনুমোদিত বিক্রেতা app-ads.txt হল একটি IAB টেক ল্যাব ইনিশিয়েটিভ যা কনফার্ম করতে সাহায্য করে যে আপনার অ্যাপ বিজ্ঞাপনের ইনভেনটরি আপনি যাদের অনুমোদিত হিসেবে শনাক্ত করেছেন, শুধুমাত্র সেইসব চ্যানেলের মাধ্যমেই বিক্রি করা কনফার্ম করতে সাহায্য করে। বিজ্ঞাপন থেকে হওয়া উপার্জনে উল্লেখযোগ্য ক্ষতি এড়াতে, আপনাকে একটি app-ads.txt ফাইল প্রয়োগ করতে হবে। আপনি আগে থেকে এটি না করে থাকলে, আপনার অ্যাপের জন্য একটি app-ads.txt ফাইল সেট-আপ করুন।

LY Ads Network-এর জন্য app-ads.txt প্রয়োগ করতে, app-ads.txt সম্পর্কে দেখুন।

ধাপ ২: AdMob UI-তে LY Ads Network ডিমান্ড সেট-আপ করুন

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

Android

নির্দেশাবলীর জন্য, Android-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।

iOS

নির্দেশাবলীর জন্য, iOS-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।

ধাপ ৩: LY Ads Network SDK ও অ্যাডাপ্টার ইমপোর্ট করা

OpenUPM-CLI

আপনার OpenUPM-CLI ইনস্টল করা থাকলে, আপনার প্রোজেক্টের রুট ডিরেক্টরি থেকে নিম্নলিখিত কমান্ড রান করিয়ে, আপনার প্রোজেক্টে Unity-এর জন্য Google Mobile Ads LY Ads Network Mediation Plugin ইনস্টল করতে পারবেন:

openupm add com.google.ads.mobile.mediation.line

OpenUPM

আপনার Unity প্রোজেক্ট এডিটরে, এডিট করুন > প্রোজেক্ট সেটিংস > প্যাকেজ ম্যানেজার বিকল্প বেছে নিয়ে Unity প্যাকেজ ম্যানেজার সেটিংস খুলুন।

স্কোপড রেজিস্ট্রি ট্যাবের অধীনে, OpenUPM-কে স্কোপড রেজিস্ট্রি হিসেবে যোগ করুন নিম্নলিখিত বিবরণ সহ:

  • নাম: OpenUPM
  • URL: https://package.openupm.com
  • স্কোপ: com.google

OpenUPM-এর বিবরণ

তারপর, Unity Package Manager খুলতে উইন্ডো > প্যাকেজ ম্যানেজার বিকল্পে নেভিগেট করুন এবং ড্রপ-ডাউন মেনু থেকে আমার রেজিস্ট্রি বিকল্প বেছে নিন।

Unity রেজিস্ট্রি

Google Mobile Ads লাইন মেডিটেশন প্যাকেজ বেছে নিয়ে ইনস্টল করুন বিকল্পে ক্লিক করুন।

OpenUPM থেকে ইনস্টল করা

Unity প্যাকেজ

LY Ads Network-এর জন্য Google Mobile Ads মধ্যস্থতা প্লাগ-ইনের লেটেস্ট ভার্সন ডাউনলোড করুন। এটি পরিবর্তনের লগ থেকে ডাউনলোড লিঙ্কে পাবেন এবং zip ফাইল থেকে GoogleMobileAdsLineMediation.unitypackage এক্সট্র্যাক্ট করুন।

আপনার Unity প্রোজেক্ট এডিটরে, অ্যাসেট > প্যাকেজ ইমপোর্ট করুন > কাস্টম প্যাকেজ বিকল্প বেছে নিন এবং GoogleMobileAdsLineMediation.unitypackage আপনার ডাউনলোড করা ফাইলটি খুঁজে নিন। সব ফাইল বেছে নেওয়া হয়েছে কিনা তা নিশ্চিত করুন এবং ইমপোর্ট করুন বিকল্পে ক্লিক করুন।

Unity থেকে ইমপোর্ট করা

তারপর, অ্যাসেট > এক্সটার্নাল ডিপেন্ডেন্সি ম্যানেজার > Android Resolver > ফোর্স রিজলভ বিকল্প বেছে নিন। এক্সটার্নাল ডিপেন্ডেন্সি ম্যানেজার লাইব্রেরি, শুরু থেকে ডিপেন্ডেন্সি রেজোলিউশন পারফর্ম করবে এবং ঘোষিত ডিপেন্ডেন্সি আপনার Unity অ্যাপের Assets/Plugins/Android ডিরেক্টরিতে কপি করবে।

জোর করে সমাধান করা

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

Android

LY Ads নেটওয়ার্ক ইন্টিগ্রেশনের জন্য কোনও অতিরিক্ত কোডের প্রয়োজন নেই।

iOS

SKAdNetwork ইন্টিগ্রেশন

আপনার প্রোজেক্টের Info.plist ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে, LY Ads Network-এর ডকুমেন্টেশন অনুসরণ করুন।

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

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

AdMob-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করেছেন কিনা তা ভালোভাবে দেখে নিন।

টেস্ট বিজ্ঞাপন যাচাই করা

আপনি যে LY Ads Network থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন তা যাচাই করতে, বিজ্ঞাপন পরিদর্শকে LY Ads Network বিজ্ঞাপন সোর্স ব্যবহার করে সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন।

ঐচ্ছিক ধাপ

নেটওয়ার্ক-নির্দিষ্ট প্যারামিটার

LY Ads Network Unity মধ্যস্থতা প্লাগ-ইন নিম্নলিখিত অতিরিক্ত অনুরোধ প্যারামিটার কাজ করে যা LineMediationExtras ক্লাসের মাধ্যমে অ্যাডাপ্টরে পাস করা যেতে পারে:

  • SetEnableAdSound(boolean) : ব্যানার, ইন্টারস্টিশিয়াল ও পুরস্কার প্রদানকারী বিজ্ঞাপনের ডিফল্ট সাউন্ড স্টার্ট স্টেট নির্দিষ্ট করে।

এইসব প্যারামিটার সেট করে কীভাবে বিজ্ঞাপনের অনুরোধ তৈরি করতে হয়, তার একটি কোড উদাহরণ এখানে দেওয়া হল:

using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.Line.Api;
// ...

var adRequest = new AdRequest();
var lineExtras = new LineMediationExtras();
lineExtras.SetEnableAdSound(true);
adRequest.MediationExtras.Add(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 নেটওয়ার্কে কাজ করে এমন ব্যানার বিজ্ঞাপনের সাইজের সাথে মিলছে না।
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 নেটওয়ার্কে কাজ করে এমন ব্যানার বিজ্ঞাপনের সাইজের সাথে মিলছে না।
103 com.google.ads.mediation.line নেটিভ বিজ্ঞাপনে তথ্য আইকনের ইমেজ অ্যাসেট লোড করা যায়নি।
104 com.google.ads.mediation.line বিডিংয়ের জন্য সিগন্যাল সংগ্রহ করা যায়নি।
১০৫ com.google.ads.mediation.line LINE Ads SDK বিজ্ঞাপন লোডার চালু করা যায়নি।

Line Unity Mediation Plugin-এর পরিবর্তনের লগ

ভার্সন ২.২.১

ভার্সন ২.২.০

ভার্সন ২.১.১

ভার্সন ২.১.০

ভার্সন ২.০.২

ভার্সন ২.০.১

ভার্সন 2.0.0

ভার্সন 1.5.10

ভার্সন 1.5.9

ভার্সন 1.5.8

ভার্সন 1.5.7

ভার্সন 1.5.6

ভার্সন ১.৫.৫

  • OpenUPM-এর মাধ্যমে ইনস্টল করার ফলে প্লাগ-ইন প্যাকেজ সঠিকভাবে ইমপোর্ট করতে না পারা সংক্রান্ত সমস্যার সমাধান করা হয়েছে।

ভার্সন ১.৫.৪

ভার্সন 1.5.3

ভার্সন ১.৫.২

ভার্সন ১.৫.১

ভার্সন 1.5.0

ভার্সন 1.4.0

ভার্সন ১.৩.১

ভার্সন 1.3.0

ভার্সন 1.2.0

ভার্সন 1.1.2

ভার্সন ১.১.১

ভার্সন 1.1.0

ভার্সন 1.0.0