ব্যানার বিজ্ঞাপন

ব্যানার ভিউ হলো আয়তাকার ছবি বা টেক্সট বিজ্ঞাপন যা স্ক্রিনে একটি জায়গা দখল করে। ব্যবহারকারীরা অ্যাপের সাথে ইন্টারঅ্যাক্ট করার সময় এগুলি স্ক্রিনে থাকে এবং একটি নির্দিষ্ট সময় পরে স্বয়ংক্রিয়ভাবে রিফ্রেশ হতে পারে। আপনি যদি মোবাইল বিজ্ঞাপনে নতুন হন, তাহলে এগুলি শুরু করার জন্য একটি দুর্দান্ত জায়গা।

এই নির্দেশিকাটি আপনাকে দেখায় কিভাবে ইউনিটি অ্যাপে ব্যানার ভিউ ইন্টিগ্রেট করতে হয়। কোড স্নিপেট এবং নির্দেশাবলী ছাড়াও, এতে ব্যানারের সঠিকভাবে আকার নির্ধারণ এবং অতিরিক্ত রিসোর্সের লিঙ্ক সম্পর্কে তথ্যও অন্তর্ভুক্ত রয়েছে।

পূর্বশর্ত

• শুরু করুন নির্দেশিকাটি সম্পূর্ণ করুন।

সর্বদা পরীক্ষামূলক বিজ্ঞাপন দিয়ে পরীক্ষা করুন

নিম্নলিখিত নমুনা কোডটিতে একটি বিজ্ঞাপন ইউনিট আইডি রয়েছে যা আপনি পরীক্ষামূলক বিজ্ঞাপনের অনুরোধ করতে ব্যবহার করতে পারেন। এটি বিশেষভাবে প্রতিটি অনুরোধের জন্য উৎপাদন বিজ্ঞাপনের পরিবর্তে পরীক্ষামূলক বিজ্ঞাপন ফেরত দেওয়ার জন্য কনফিগার করা হয়েছে, যা এটি ব্যবহার করা নিরাপদ করে তোলে।

তবে, অ্যাড ম্যানেজার ওয়েব ইন্টারফেসে একটি অ্যাপ নিবন্ধন করার পরে এবং আপনার অ্যাপে ব্যবহারের জন্য নিজস্ব বিজ্ঞাপন ইউনিট আইডি তৈরি করার পরে, ডেভেলপমেন্টের সময় আপনার ডিভাইসটিকে একটি পরীক্ষামূলক ডিভাইস হিসেবে স্পষ্টভাবে কনফিগার করুন ।

/21775744923/example/fixed-size-banner

মোবাইল বিজ্ঞাপন SDK চালু করুন

বিজ্ঞাপন লোড করার আগে, আপনার অ্যাপটিকে MobileAds.Initialize() এ কল করে Google Mobile Ads SDK চালু করতে বলুন। এটি শুধুমাত্র একবার করতে হবে, আদর্শভাবে অ্যাপ লঞ্চের সময়।

using GoogleMobileAds;
using GoogleMobileAds.Api;

public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize Google Mobile Ads SDK.
        MobileAds.Initialize((InitializationStatus initStatus) =>
        {
            // This callback is called once the MobileAds SDK is initialized.
        });
    }
}

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

ব্যানারভিউ উদাহরণ

নিচের নমুনা কোডে ব্যানার ভিউ কীভাবে ব্যবহার করতে হয় তার বিস্তারিত বর্ণনা দেওয়া আছে। উদাহরণে, একটি ব্যানার ভিউয়ের একটি উদাহরণ তৈরি করুন, ব্যানার ভিউতে একটি বিজ্ঞাপন লোড করতে একটি AdManagerAdRequest ব্যবহার করুন এবং তারপর জীবনচক্র ইভেন্টগুলি পরিচালনা করে এর ক্ষমতা বৃদ্ধি করুন।

একটি ব্যানার ভিউ তৈরি করুন

ব্যানার ভিউ ব্যবহারের প্রথম ধাপ হল ব্যানার ভিউয়ের একটি উদাহরণ তৈরি করা।

// Create a 320x50 banner at top of the screen.
adManagerBannerView = new AdManagerBannerView("AD_UNIT_ID", AdSize.Banner, AdPosition.Top);
AdManagerBannerViewSnippets.cs

AD_UNIT_ID এর পরিবর্তে আপনার বিজ্ঞাপন ইউনিট আইডি দিন।

একটি AdManagerBannerView এর কনস্ট্রাক্টরের নিম্নলিখিত প্যারামিটার রয়েছে:

• adUnitId : লোড করা ব্যানার বিজ্ঞাপনের বিজ্ঞাপন ইউনিট আইডি।
• AdSize : আপনি যে ব্যানারের আকার ব্যবহার করতে চান।
• AdPosition : ব্যানার ভিউ যেখানে স্থাপন করা উচিত সেই অবস্থান।

(ঐচ্ছিক) একটি কাস্টম অবস্থান সহ একটি ব্যানার ভিউ তৈরি করুন

AdPosition মানগুলির তুলনায় স্ক্রিনে ব্যানার ভিউ কোথায় স্থাপন করা হবে তার উপর আরও বেশি নিয়ন্ত্রণের জন্য, প্যারামিটার হিসাবে x- এবং y-স্থানাঙ্কযুক্ত কনস্ট্রাক্টর ব্যবহার করুন:

// Create a 320x50 banner views at coordinate (0,50) on screen.
adManagerBannerView = new AdManagerBannerView("AD_UNIT_ID", AdSize.Banner, 0, 50);
AdManagerBannerViewSnippets.cs

ব্যানার ভিউয়ের উপরের-বাম কোণটি কনস্ট্রাক্টরের কাছে প্রেরিত x এবং y মানের উপর অবস্থিত, যেখানে অরিজিনটি স্ক্রিনের উপরের-বাম দিকে অবস্থিত।

(ঐচ্ছিক) একটি কাস্টম আকার দিয়ে একটি ব্যানার ভিউ তৈরি করুন

AdSize ধ্রুবক ব্যবহার করার পাশাপাশি, আপনি আপনার বিজ্ঞাপনের জন্য একটি কাস্টম আকারও নির্দিষ্ট করতে পারেন:

// Create a 250x250 banner at the bottom of the screen.
AdSize adSize = new AdSize(250, 250);
adManagerBannerView = new AdManagerBannerView("AD_UNIT_ID", adSize, AdPosition.Bottom);
AdManagerBannerViewSnippets.cs

(ঐচ্ছিক) একাধিক বিজ্ঞাপনের আকার

বিজ্ঞাপন পরিচালক আপনাকে একাধিক বিজ্ঞাপনের আকার নির্দিষ্ট করতে দেয় যা একটি AdManagerBannerView এ পরিবেশন করার যোগ্য হতে পারে। SDK এ এই বৈশিষ্ট্যটি প্রয়োগ করার আগে, বিভিন্ন আকারের সৃজনশীলতার সাথে সম্পর্কিত একই বিজ্ঞাপন ইউনিটগুলিকে লক্ষ্য করে একটি লাইন আইটেম তৈরি করুন।

আপনার অ্যাপে, একাধিক AdSize প্যারামিটার ValidAdSizes এ পাস করুন:

// Create a 250x250 banner at the bottom of the screen.
adManagerBannerView = new AdManagerBannerView("AD_UNIT_ID", AdSize.Banner, AdPosition.Top);

// Add multiple ad sizes.
adManagerBannerView.ValidAdSizes = new List<AdSize>
{
    AdSize.Banner,
    new AdSize(120, 20),
    new AdSize(250, 250),
};
AdManagerBannerViewSnippets.cs

যদি AdManagerAdView রিফ্রেশের সময় আকার পরিবর্তন করে, তাহলে আপনার লেআউটটি স্বয়ংক্রিয়ভাবে নতুন আকারের সাথে খাপ খাইয়ে নিতে সক্ষম হবে। পরবর্তী বিজ্ঞাপনটি ফিরে না আসা পর্যন্ত AdManagerAdView প্রথম প্যারামিটারে পাস করা আকারে ডিফল্ট থাকে।

একটি ব্যানার বিজ্ঞাপন লোড করুন

AdManagerBannerView চালু হওয়ার পর, AdManagerBannerView ক্লাসে LoadAd() পদ্ধতি ব্যবহার করে একটি বিজ্ঞাপন লোড করতে এগিয়ে যান। এটির জন্য একটি এমন প্যারামিটার যা রানটাইম তথ্য ধারণ করে, যেমন টার্গেটিং তথ্য, বর্জন লেবেল এবং প্রকাশকের প্রদত্ত আইডি।

একটি বিজ্ঞাপন লোড করতে, একটি AdManagerAdRequest তৈরি করুন এবং এটি LoadAd() পদ্ধতিতে পাস করুন।

// Send a request to load an ad into the banner view.
adManagerBannerView.LoadAd(new AdManagerAdRequest());
AdManagerBannerViewSnippets.cs

ব্যানার ভিউ ইভেন্টগুলি শুনুন

আপনার বিজ্ঞাপনের আচরণ কাস্টমাইজ করার জন্য, আপনি বিজ্ঞাপনের জীবনচক্রের বেশ কয়েকটি ইভেন্টের সাথে সংযুক্ত হতে পারেন, যেমন লোডিং, খোলা বা বন্ধ করা। এই ইভেন্টগুলি শুনতে, একজন প্রতিনিধি নিবন্ধন করুন:

adManagerBannerView.OnBannerAdLoaded += () =>
{
    // Raised when an ad is loaded into the banner view.
};
adManagerBannerView.OnBannerAdLoadFailed += (LoadAdError error) =>
{
    // Raised when an ad fails to load into the banner view.
};
adManagerBannerView.OnAdPaid += (AdValue adValue) =>
{
    // Raised when the ad is estimated to have earned money.
};
adManagerBannerView.OnAdImpressionRecorded += () =>
{
    // Raised when an impression is recorded for an ad.
};
adManagerBannerView.OnAdClicked += () =>
{
    // Raised when a click is recorded for an ad.
};
adManagerBannerView.OnAdFullScreenContentOpened += () =>
{
    // Raised when an ad opened full screen content.
};
adManagerBannerView.OnAdFullScreenContentClosed += () =>
{
    // Raised when the ad closed full screen content.
};
AdManagerBannerViewSnippets.cs

ব্যানার ভিউ নষ্ট করে দিন

ব্যানারটি ধ্বংস করতে, রিসোর্স প্রকাশ করতে Destroy() পদ্ধতিটি কল করুন:

if (adManagerBannerView != null)
{
    // Always destroy the banner view when no longer needed.
    adManagerBannerView.Destroy();
    adManagerBannerView = null;
}
AdManagerBannerViewSnippets.cs

যেসব ব্যানার লোড হতে ব্যর্থ হয়, আমরা আপনাকে নতুন ব্যানার তৈরি করার পরিবর্তে ব্যানারটি রিফ্রেশ করার পরামর্শ দিচ্ছি। বিস্তারিত জানার জন্য, "বিজ্ঞাপন রিফ্রেশ করুন" দেখুন।

একটি বিজ্ঞাপন রিফ্রেশ করুন

যদি আপনি আপনার বিজ্ঞাপন ইউনিট রিফ্রেশ করার জন্য কনফিগার করে থাকেন, তাহলে বিজ্ঞাপন লোড না হলে আপনাকে আর একটি বিজ্ঞাপনের অনুরোধ করতে হবে না। Google মোবাইল বিজ্ঞাপন SDK বিজ্ঞাপন পরিচালক UI-তে আপনার নির্দিষ্ট করা যেকোনো রিফ্রেশ রেট মেনে চলে। যদি আপনি রিফ্রেশ সক্ষম না করে থাকেন, তাহলে একটি নতুন অনুরোধ জারি করুন। বিজ্ঞাপন ইউনিট রিফ্রেশ সম্পর্কে আরও তথ্যের জন্য, যেমন রিফ্রেশ রেট সেট করার জন্য, মোবাইল অ্যাপে বিজ্ঞাপনের জন্য রিফ্রেশ রেট দেখুন।

ব্যানারের আকার

নিম্নলিখিত টেবিলে স্ট্যান্ডার্ড ব্যানারের আকারগুলি তালিকাভুক্ত করা হয়েছে:

অ্যাপ ইভেন্ট

অ্যাপ ইভেন্টগুলি আপনাকে এমন বিজ্ঞাপন তৈরি করতে দেয় যা তাদের অ্যাপ কোডে বার্তা পাঠাতে পারে। এরপর অ্যাপটি এই বার্তাগুলির উপর ভিত্তি করে পদক্ষেপ নিতে পারে।

আপনি AppEvent ব্যবহার করে বিজ্ঞাপন ম্যানেজারের নির্দিষ্ট অ্যাপ ইভেন্টগুলি শুনতে পারেন। এই ইভেন্টগুলি বিজ্ঞাপনের জীবনচক্রের যেকোনো সময় ঘটতে পারে, এমনকি লোড কল হওয়ার আগেই।

যখন কোনও বিজ্ঞাপনে কোনও অ্যাপ ইভেন্ট ঘটে তখন OnAppEventReceived উত্থাপিত হয়। আপনার কোডে এই ইভেন্টটি কীভাবে পরিচালনা করবেন তার একটি উদাহরণ এখানে দেওয়া হল:

adManagerBannerView.OnAppEventReceived += (AppEvent args) =>
{
    Debug.Log($"Received app event from the ad: {args.Name}, {args.Data}.");
};
AdManagerBannerViewSnippets.cs

রঙের নামের অ্যাপ ইভেন্টের উপর নির্ভর করে আপনার অ্যাপের ব্যাকগ্রাউন্ডের রঙ কীভাবে পরিবর্তন করবেন তা দেখানোর একটি উদাহরণ এখানে দেওয়া হল:

adManagerBannerView.OnAppEventReceived += (AppEvent args) =>
{
    if (args.Name == "color")
    {
        Color color;
        if (ColorUtility.TryParseHtmlString(args.Data, out color))
        {
            renderer.material.color = color;
        }
    }
};
AdManagerBannerViewSnippets.cs

এবং, এখানে সংশ্লিষ্ট সৃজনশীলটি রয়েছে যা রঙিন অ্যাপ ইভেন্ট পাঠায়:

<html>
<head>
  <script src="//www.gstatic.com/afma/api/v1/google_mobile_app_ads.js"></script>
  <script>
    document.addEventListener("DOMContentLoaded", function() {
      // Send a color=green event when ad loads.
      admob.events.dispatchAppEvent("color", "green");

      document.getElementById("ad").addEventListener("click", function() {
        // Send a color=blue event when ad is clicked.
        admob.events.dispatchAppEvent("color", "blue");
      });
    });
  </script>
  <style>
    #ad {
      width: 320px;
      height: 50px;
      top: 0;
      left: 0;
      font-size: 24pt;
      font-weight: bold;
      position: absolute;
      background: black;
      color: white;
      text-align: center;
    }
  </style>
</head>
<body>
  <div id="ad">Carpe diem!</div>
</body>
</html>
AppEventSnippets.html

অতিরিক্ত সম্পদ

• HelloWorld উদাহরণ : সকল বিজ্ঞাপন ফর্ম্যাটের একটি ন্যূনতম বাস্তবায়ন।