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

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

এই নির্দেশিকা থেকে আপনি জানতে পারবেন কীভাবে Google Mobile Ads Unity Plugin ব্যবহার করে মিডিয়েশন-এর মাধ্যমে LY Ads Network থেকে বিজ্ঞাপন লোড ও ডিসপ্লে করতে হয়, যার মধ্যে ওয়াটারফল ইন্টিগ্রেশনও কভার করা হয়। এটি বিজ্ঞাপন ইউনিটের মিডিয়েশন কনফিগারেশনে 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 লেভেল ২৪ বা তার পরের ভার্সন।
  • 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 Ads Network থেকে অনুমোদন পেতে আপনার অ্যাপের বিবরণ পৃষ্ঠায় পর্যালোচনা করুন বিকল্পে ক্লিক করুন। এতে কিছুটা সময় লাগতে পারে। আপনার কোনও প্রশ্ন থাকলে, LY Ads Network প্রতিনিধির সাথে যোগাযোগ করুন।

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

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

    রিপোর্টিং 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 বিজ্ঞাপন নেটওয়ার্কের জন্য 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 প্লাগ-ইন আপনার প্রোজেক্টে ইনস্টল করতে পারবেন:

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

    OpenUPM

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

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

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

    OpenUPM-এর বিবরণ

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

    Unity Registries

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

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

    Unity প্যাকেজ

    চেঞ্জলগ-এ দেওয়া ডাউনলোড লিঙ্ক থেকে LY Ads Network-এর জন্য Google মোবাইল বিজ্ঞাপন মিডিয়েশন প্লাগ-ইনের লেটেস্ট ভার্সন ডাউনলোড করুন এবং জিপ ফাইল থেকে GoogleMobileAdsLineMediation.unitypackage এক্সট্র্যাক্ট করুন।

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

    Unity থেকে ইমপোর্ট করুন

    তারপর, অ্যাসেট > এক্সটার্নাল ডিপেন্ডেন্সি ম্যানেজার > Android রিজলভার > ফোর্স রিজলভ বিকল্প বেছে নিন। এক্সটার্নাল ডিপেন্ডেন্সি ম্যানেজার লাইব্রেরি শুরু থেকে ডিপেন্ডেন্সি রেজোলিউশন পারফর্ম করবে এবং ঘোষিত ডিপেন্ডেন্সি আপনার 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 প্লাগ-ইন চেঞ্জলগ

    ভার্সন ২.২.১

    ভার্সন ২.২.০

    ভার্সন ২.১.১

    ভার্সন ২.১.০

    ভার্সন ২.০.২

    ভার্সন ২.০.১

    ভার্সন 2.0.0

    ভার্সন 1.5.10

    ভার্সন 1.5.9

    ভার্সন ১.৫.৮

    ভার্সন ১.৫.৭

    ভার্সন ১.৫.৬

    ভার্সন ১.৫.৫

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

    ভার্সন ১.৫.৪

    ভার্সন ১.৫.৩

    ভার্সন ১.৫.২

    ভার্সন 1.5.1

    ভার্সন 1.5.0

    ভার্সন ১.৪.০

    ভার্সন ১.৩.১

    ভার্সন 1.3.0

    ভার্সন ১.২.০

    ভার্সন ১.১.২

    ভার্সন ১.১.১

    ভার্সন 1.1.0

    ভার্সন 1.0.0