ব্যানার বিজ্ঞাপন সেট-আপ করা

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

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

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

পূর্বশর্ত

চালিয়ে যাওয়ার আগে, Google Mobile Ads Unity Plugin সেট-আপ করুন।

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

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

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

/21775744923/example/interstitial

Google Mobile Ads Unity Plugin শুরু করুন

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

using GoogleMobileAds;
using GoogleMobileAds.Api;

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

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

BannerView-এর উদাহরণ

ব্যানার ভিউ কীভাবে ব্যবহার করতে হয় তা নিম্নলিখিত স্যাম্পেল কোডে বিস্তারিতভাবে দেখানো হয়েছে। উদাহরণে, ব্যানার ভিউয়ের একটি ইনস্ট্যান্স তৈরি করুন, ব্যানার ভিউতে বিজ্ঞাপন লোড করতে 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: ব্যানার ভিউ যেখানে প্লেস করা উচিত সেই পজিশন।

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

(ঐচ্ছিক) কাস্টম পজিশন সহ ব্যানার ভিউ তৈরি করুন

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

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

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

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

// 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

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

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

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

মনে রাখবেন: Ad Manager UI-তে রিফ্রেশ রেট সেট করার সময়, স্ক্রিনে ব্যানার দেখা গেলে তবেই অটোমেটিক রিফ্রেশ হয়।

ব্যানারের সাইজ

বড় অ্যাডাপ্টিভ ব্যানার, স্ক্রল করা যায় না এমন লেআউটের জন্য ডিজাইন করা আরও বড় ফর্ম্যাট প্রদান করে। স্ট্যান্ডার্ড অ্যাঙ্কর করা অ্যাডাপ্টিভ ব্যানারের তুলনায়, এই ব্যানারগুলি আরও বেশি উচ্চতা (স্ক্রিনের উচ্চতার ২০% পর্যন্ত, ৫০ থেকে ১৫০ ডিপি-র মধ্যে) ব্যবহার করার অনুমতি দেয়। এই বর্ধিত স্পেস ভিডিও কন্টেন্টের জন্য অপ্টিমাইজ করা হয়েছে।

নিচের সারণীতে স্ট্যান্ডার্ড ব্যানারের সাইজ তালিকাভুক্ত করা হয়েছে:

dp-তে সাইজ (WxH)	বিবরণ	উপলভ্যতা	AdSize কনস্ট্যান্ট
৩২০x৫০	স্ট্যান্ডার্ড ব্যানার	ফোন বা ট্যাবলেটগুলি	BANNER
৩২০x১০০	বড় ব্যানার	ফোন বা ট্যাবলেটগুলি	LARGE_BANNER
৩০০x২৫০	IAB মাঝারি আয়তক্ষেত্র	ফোন বা ট্যাবলেটগুলি	MEDIUM_RECTANGLE
৪৬৮x৬০	IAB ফুল-সাইজ ব্যানার	ট্যাবলেট	FULL_BANNER
৭২৮x৯০	IAB লিডারবোর্ড	ট্যাবলেট	LEADERBOARD
প্রদত্ত প্রস্থ x অ্যাডাপ্টিভ উচ্চতা	অ্যাডাপ্টিভ ব্যানার	ফোন বা ট্যাবলেটগুলি	প্রযোজ্য নয়
স্ক্রিনের প্রস্থ x ৩২|৫০|৯০	স্মার্ট ব্যানার	ফোন বা ট্যাবলেটগুলি	SMART_BANNER
অ্যাডাপ্টিভ ব্যানার সম্পর্কে আরও জানুন, যা স্মার্ট ব্যানার-এর পরিবর্তে ব্যবহার করার জন্য তৈরি করা হয়েছে।

মনে রাখবেন: কোনও Android অ্যাপ যদি এমন কোনও ব্যানার লোড করার চেষ্টা করে যা তার লেআউটের তুলনায় অনেক বড়, তাহলে SDK সেটি দেখাবে না, পরিবর্তে একটি ত্রুটি মেসেজ লগ করবে।

অ্যাপ ইভেন্ট

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

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

বিজ্ঞাপনে কোনও অ্যাপ ইভেন্ট ঘটলে 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 উদাহরণ: সব বিজ্ঞাপন ফর্ম্যাটের ন্যূনতম প্রয়োগ।