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

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

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

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

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

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

পূর্বশর্ত

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

  • লেটেস্ট 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 সেট-আপ করুন দেখুন।
  • মধ্যস্থতা সেট-আপ করুন।

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

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

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

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

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

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

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

    অ্যাপ আইডি নোট করে রাখুন।

    Android

    রেজিস্ট্রেশন সম্পর্কিত বিবরণ

    iOS

    রেজিস্ট্রেশন সম্পর্কিত বিবরণ

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

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

    স্লট যোগ করুন

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

    স্লট ফর্ম যোগ করুন

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

    স্লটের বিবরণ

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

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

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

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

    রিপোর্টিং API Key ট্যাব

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

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

    আপনার API Key ID এবং API Key Secret নোট করে রাখুন।

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

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

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

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

    ধাপ ২: Ad Manager 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 খুলতে Window > Package Manager বিকল্পে নেভিগেট করুন এবং ড্রপ-ডাউন মেনু থেকে আমার রেজিস্ট্রি বিকল্প বেছে নিন।

    Unity Registries

    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 Network ইন্টিগ্রেশনের জন্য কোনও অতিরিক্ত কোডের প্রয়োজন নেই।

    iOS

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

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

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

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

    Ad Manager-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করতে ভুলবেন না।

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

    আপনি যে 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 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 Unity Mediation Plugin-এর পরিবর্তনের লগ

    ভার্সন ২.২.১

    ভার্সন ২.২.০

    ভার্সন ২.১.১

    ভার্সন ২.১.০

    ভার্সন ২.০.২

    ভার্সন ২.০.১

    ভার্সন 2.0.0

    ভার্সন 1.5.10

    ভার্সন ১.৫.৯

    ভার্সন ১.৫.৮

    ভার্সন 1.5.7

    ভার্সন 1.5.6

    ভার্সন ১.৫.৫

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

    ভার্সন ১.৫.৪

    ভার্সন ১.৫.৩

    ভার্সন ১.৫.২

    ভার্সন ১.৫.১

    ভার্সন 1.5.0

    ভার্সন 1.4.0

    ভার্সন ১.৩.১

    ভার্সন 1.3.0

    ভার্সন ১.২.০

    ভার্সন 1.1.2

    ভার্সন ১.১.১

    ভার্সন 1.1.0

    ভার্সন 1.0.0