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

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

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

পূর্বশর্ত

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

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

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

/21775744923/example/adaptive-banner

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

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

using GoogleMobileAds;
using GoogleMobileAds.Api;

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

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

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

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

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

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


  // This ad unit is configured to always serve test ads.
  private string _adUnitId = "/21775744923/example/adaptive-banner";

  AdManagerBannerView _bannerView;

  /// <summary>
  /// Creates a 320x50 banner view at top of the screen.
  /// </summary>
  public void CreateBannerView()
  {
      Debug.Log("Creating banner view");

      // If we already have a banner, destroy the old one.
      if (_bannerView != null)
      {
          DestroyAd();
      }

      // Create a 320x50 banner at top of the screen
      _bannerView = new AdManagerBannerView(_adUnitId, AdSize.Banner, AdPosition.Top);
  }

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

  • adUnitId : বিজ্ঞাপন ইউনিট ID যেখান থেকে AdManagerBannerView বিজ্ঞাপন লোড করবে।
  • AdSize : আপনি যে বিজ্ঞাপনের আকার ব্যবহার করতে চান। বিস্তারিত জানার জন্য ব্যানার মাপ পরামর্শ.
  • AdPosition : যে অবস্থানে ব্যানার ভিউ স্থাপন করা উচিত। AdPosition enum বৈধ বিজ্ঞাপন অবস্থানের মান তালিকাভুক্ত করে।

প্ল্যাটফর্মের উপর নির্ভর করে কীভাবে বিভিন্ন বিজ্ঞাপন ইউনিট ব্যবহার করা হয় তা নোট করুন। iOS-এ বিজ্ঞাপনের অনুরোধ করার জন্য আপনাকে একটি iOS বিজ্ঞাপন ইউনিট এবং Android-এ অনুরোধ করার জন্য একটি Android বিজ্ঞাপন ইউনিট ব্যবহার করতে হবে।

(ঐচ্ছিক) একটি কাস্টম অবস্থান সহ একটি ব্যানার দৃশ্য তৈরি করুন৷

AdPosition মান দ্বারা অফার করার চেয়ে একটি AdManagerBannerView স্ক্রিনে কোথায় রাখা হয় তার উপর বৃহত্তর নিয়ন্ত্রণের জন্য, প্যারামিটার হিসাবে x- এবং y-কোঅর্ডিনেট আছে এমন কনস্ট্রাক্টর ব্যবহার করুন:

// Create a 320x50 banner views at coordinate (0,50) on screen.
_bannerView = new AdManagerBannerView(_adUnitId, AdSize.Banner, 0, 50);

The top-left corner of the AdManagerBannerView is positioned at the x and y values passed to the constructor, where the origin is the top-left of the screen.

(ঐচ্ছিক) একটি কাস্টম আকার সহ একটি ব্যানার দৃশ্য তৈরি করুন৷

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

// Use the AdSize argument to set a custom size for the ad.
AdSize adSize = new AdSize(250, 250);
_bannerView = new AdManagerBannerView(_adUnitId, adSize, AdPosition.Bottom);

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

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

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

var adView = new AdManagerBannerView(_adUnitId, AdSize.Banner, AdPosition.Top);
adView.ValidAdSizes = new List<AdSize>
{
    AdSize.Banner, new AdSize(120, 20), new AdSize(250, 250),
};

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

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

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

/// <summary>
/// Creates the banner view and loads a banner ad.
/// </summary>
public void LoadAd()
{
    // create an instance of a banner view first.
    if(_bannerView == null)
    {
        CreateAdManagerBannerView();
    }

    // create our request used to load the ad.
    var adRequest = new AdManagerAdRequest();

    // send the request to load the ad.
    Debug.Log("Loading banner ad.");
    _bannerView.LoadAd(adRequest);
}

ব্যানার দেখার ঘটনা শুনুন

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

/// <summary>
/// listen to events the banner view may raise.
/// </summary>
private void ListenToAdEvents()
{
    // Raised when an ad is loaded into the banner view.
    _bannerView.OnBannerAdLoaded += () =>
    {
        Debug.Log("Banner view loaded an ad with response : "
            + _bannerView.GetResponseInfo());
    };
    // Raised when an ad fails to load into the banner view.
    _bannerView.OnBannerAdLoadFailed += (LoadAdError error) =>
    {
        Debug.LogError("Banner view failed to load an ad with error : "
            + error);
    };
    // Raised when the ad is estimated to have earned money.
    _bannerView.OnAdPaid += (AdValue adValue) =>
    {
        Debug.Log(String.Format("Banner view paid {0} {1}.",
            adValue.Value,
            adValue.CurrencyCode));
    };
    // Raised when an impression is recorded for an ad.
    _bannerView.OnAdImpressionRecorded += () =>
    {
        Debug.Log("Banner view recorded an impression.");
    };
    // Raised when a click is recorded for an ad.
    _bannerView.OnAdClicked += () =>
    {
        Debug.Log("Banner view was clicked.");
    };
    // Raised when an ad opened full screen content.
    _bannerView.OnAdFullScreenContentOpened += () =>
    {
        Debug.Log("Banner view full screen content opened.");
    };
    // Raised when the ad closed full screen content.
    _bannerView.OnAdFullScreenContentClosed += () =>
    {
        Debug.Log("Banner view full screen content closed.");
    };
}

ব্যানার ভিউ ধ্বংস

ব্যানার ভিউ ব্যবহার করা শেষ হলে, সম্পদ প্রকাশ করতে Destroy() কল করতে ভুলবেন না।

/// <summary>
/// Destroys the banner view.
/// </summary>
public void DestroyAd()
{
    if (_bannerView != null)
    {
        Debug.Log("Destroying banner view.");
        _bannerView.Destroy();
        _bannerView = null;
    }
}

তাই তো! আপনার অ্যাপ এখন ব্যানার বিজ্ঞাপন প্রদর্শনের জন্য প্রস্তুত।

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

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

নিচের সারণীতে স্ট্যান্ডার্ড ব্যানারের মাপ তালিকা করা আছে।

dp তে আকার (WxH) বর্ণনা প্রাপ্যতা বিজ্ঞাপনের আকার ধ্রুবক
320x50 স্ট্যান্ডার্ড ব্যানার ফোন এবং ট্যাবলেট BANNER
320x100 বড় ব্যানার ফোন এবং ট্যাবলেট LARGE_BANNER
300x250 IAB মাঝারি আয়তক্ষেত্র ফোন এবং ট্যাবলেট MEDIUM_RECTANGLE
468x60 IAB পূর্ণ আকারের ব্যানার ট্যাবলেট FULL_BANNER
728x90 আইএবি লিডারবোর্ড ট্যাবলেট LEADERBOARD
Provided width x Adaptive height অভিযোজিত ব্যানার ফোন এবং ট্যাবলেট N/A
স্ক্রিনের প্রস্থ x 32|50|90 স্মার্ট ব্যানার ফোন এবং ট্যাবলেট SMART_BANNER
স্মার্ট ব্যানার প্রতিস্থাপনের উদ্দেশ্যে অভিযোজিত ব্যানার সম্পর্কে আরও জানুন।

অ্যাপ ইভেন্ট

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

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

namespace GoogleMobileAds.Api.AdManager;

/// The App event message sent from the ad.
public class AppEvent
{
    // Name of the app event.
    string Name;
    // Argument passed from the app event.
    string Value;
}

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

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

রঙের নামের সাথে একটি অ্যাপ ইভেন্টের উপর নির্ভর করে কীভাবে আপনার অ্যাপের পটভূমির রঙ পরিবর্তন করতে হয় তা এখানে একটি উদাহরণ রয়েছে:

_bannerview.OnAppEventReceived += (AppEvent args) =>
{
  if (args.Name == "color")
  {
    Color color;
    if (ColorUtility.TryParseColor(arg.Value, out color))
    {
      gameObject.GetComponent<Renderer>().material.color = color;
    }
  }
};

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

<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: 0px;
      left: 0px;
      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>

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

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