এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

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

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েড (বিটা)

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

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

পূর্বশর্ত

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

সর্বদা টেস্ট অ্যাড দিয়ে পরীক্ষা করুন

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

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

/21775744923/example/fixed-size-banner

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.
        });
    }
}

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

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

নিম্নলিখিত নমুনা কোডে ব্যানার ভিউ ব্যবহারের পদ্ধতি বিস্তারিতভাবে বর্ণনা করা হয়েছে। এই উদাহরণে, একটি ব্যানার ভিউ-এর ইনস্ট্যান্স তৈরি করুন, 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-তে এই বৈশিষ্ট্যটি প্রয়োগ করার আগে, বিভিন্ন আকারের ক্রিয়েটিভের সাথে যুক্ত একই অ্যাড ইউনিটগুলিকে লক্ষ্য করে একটি লাইন আইটেম তৈরি করুন।

আপনার অ্যাপে, 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

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

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

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

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

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

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

অ্যাপ ইভেন্ট

অ্যাপ ইভেন্টের মাধ্যমে আপনি এমন বিজ্ঞাপন তৈরি করতে পারেন যা তার অ্যাপ কোডে বার্তা পাঠাতে পারে। এরপর অ্যাপটি এই বার্তাগুলোর ওপর ভিত্তি করে ব্যবস্থা নিতে পারে।

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

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

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

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

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

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

হ্যালোওয়ার্ল্ড উদাহরণ : সকল বিজ্ঞাপন ফরম্যাটের একটি সংক্ষিপ্ত বাস্তবায়ন।