বিজ্ঞাপন প্রি-লোডিং (বিটা)

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েড আইওএস ইউনিটি অ্যান্ড্রয়েড (লেগ্যাসি)

অ্যাড প্রি-লোডিং হলো Google Mobile Ads Unity Plugin একটি গুগল-পরিচালিত বিজ্ঞাপন লোডিং বৈশিষ্ট্য, যা আপনার পক্ষ থেকে বিজ্ঞাপন লোডিং এবং ক্যাশিং পরিচালনা করে। অ্যাড প্রি-লোডিং ব্যবহার করতে হলে আপনার বিজ্ঞাপন লোডিং পরিচালনার পদ্ধতিতে পরিবর্তন আনতে হবে। অ্যাড প্রি-লোডিং ব্যবহার করে পারফরম্যান্স অপ্টিমাইজ করতে, কাস্টম ক্যাশিং নিষ্ক্রিয় করুন এবং এই দায়িত্বটি Google Mobile Ads Unity Plugin উপর অর্পণ করুন।

ম্যানুয়াল বিজ্ঞাপন লোডিংয়ের তুলনায় বিজ্ঞাপন প্রি-লোডিং নিম্নলিখিত সুবিধাগুলো প্রদান করে:

  • রেফারেন্স ম্যানেজমেন্ট: লোড করা বিজ্ঞাপনগুলো ধরে রাখে, ফলে সেগুলো দেখানোর জন্য প্রস্তুত না হওয়া পর্যন্ত আপনাকে রেফারেন্স রক্ষণাবেক্ষণ করতে হয় না।
  • স্বয়ংক্রিয় রিলোডিং: আপনি ক্যাশে থেকে কোনো বিজ্ঞাপন সরিয়ে নিলে এটি স্বয়ংক্রিয়ভাবে একটি নতুন বিজ্ঞাপন লোড করে।
  • নিয়ন্ত্রিত পুনঃপ্রচেষ্টা: এক্সপোনেনশিয়াল ব্যাকঅফ ব্যবহার করে ব্যর্থ অনুরোধগুলো স্বয়ংক্রিয়ভাবে পুনরায় চেষ্টা করে।
  • মেয়াদোত্তীর্ণতা ব্যবস্থাপনা: বিজ্ঞাপনের মেয়াদ শেষ হওয়ার আগেই (সাধারণত এক ঘণ্টা পর) সেগুলোকে স্বয়ংক্রিয়ভাবে রিফ্রেশ করে।
  • ক্যাশ অপ্টিমাইজেশন: আপনি যদি একের চেয়ে বড় ক্যাশ সাইজ ব্যবহার করেন, তাহলে Google Mobile Ads Unity Plugin সেরা বিজ্ঞাপনটি দেখানোর জন্য ক্যাশের ক্রম অপ্টিমাইজ করে।

এই নির্দেশিকায় প্রিলোড বিজ্ঞাপন কনফিগার করা, প্রিলোড বিজ্ঞাপনের প্রাপ্যতা যাচাই করা এবং প্রিলোড করা বিজ্ঞাপনটি দেখানোর পদ্ধতি আলোচনা করা হয়েছে।

পূর্বশর্ত

এই টিউটোরিয়ালটি শুরু করার আগে, আপনাকে অবশ্যই Google Mobile Ads Unity Plugin সেট আপ করতে হবে।

বিজ্ঞাপন প্রি-লোড করা শুরু করুন

অ্যাপটি চালু হলে, Preload মেথডটি একবার কল করুন। Preload মেথডটি কল করার পর, Google Mobile Ads Unity Plugin স্বয়ংক্রিয়ভাবে বিজ্ঞাপন প্রি-লোড করে এবং প্রি-লোড করা কনফিগারেশনগুলোর জন্য ব্যর্থ হওয়া অনুরোধগুলো পুনরায় চেষ্টা করে।

নিম্নলিখিত উদাহরণটি বিজ্ঞাপন প্রি-লোড করা শুরু করে: 

var preloadConfiguration = new PreloadConfiguration
{
    AdUnitId = "AD_UNIT_ID",
    Request = new AdRequest(),
};

// Start the preloading initialization process after MobileAds.Initialize().
InterstitialAdPreloader.Preload(
    // The Preload ID can be any unique string to identify this configuration.
    "AD_UNIT_ID",
    preloadConfiguration);

আগে থেকে লোড করা বিজ্ঞাপনটি নিন এবং দেখান

অ্যাড প্রি-লোডিং ব্যবহার করার সময়, Google Mobile Ads Unity Plugin ক্যাশ করা বিজ্ঞাপনগুলো ধরে রাখে। যখন আপনি কোনো বিজ্ঞাপন দেখাতে চান, তখন DequeueAd মেথডটি কল করুন। Google Mobile Ads Unity Plugin একটি উপলব্ধ বিজ্ঞাপন খুঁজে বের করে এবং ব্যাকগ্রাউন্ডে স্বয়ংক্রিয়ভাবে পরবর্তী বিজ্ঞাপনটি প্রি-লোড করে।

বিজ্ঞাপন দেখানোর জন্য প্রস্তুত না হওয়া পর্যন্ত DequeueAd মেথডটি কল করা থেকে বিরত থাকুন। ক্যাশে বিজ্ঞাপন রাখলে Google Mobile Ads Unity Plugin স্বয়ংক্রিয়ভাবে মেয়াদোত্তীর্ণ বিজ্ঞাপন রিফ্রেশ করে এবং ক্যাশে অপ্টিমাইজেশন সম্পাদন করে।

নিম্নলিখিত উদাহরণটি আগে থেকে লোড করা একটি বিজ্ঞাপন খুঁজে বের করে দেখায়: 

// DequeueAd returns the next available ad and loads another ad in the background.
var ad = InterstitialAdPreloader.DequeueAd("AD_UNIT_ID");

if (ad != null)
{
    // [Optional] Interact with the ad object as needed.
    ad.OnAdPaid += (AdValue value) =>
    {
        Debug.Log($"Ad paid: {value.CurrencyCode} {value.Value}");
        // [Optional] Send the impression-level ad revenue information to your preferred
        // analytics server directly within this callback.
    };

    // Do not hold onto preloaded ads, always show a preloaded ad immediately.
    ad.Show();
}

প্রি-লোডিং বিজ্ঞাপনের প্রাপ্যতা যাচাই করুন

বিজ্ঞাপনের প্রাপ্যতা যাচাই করতে, নিম্নলিখিত বিকল্পগুলির মধ্যে একটি বেছে নিন:

প্রি-লোডেড বিজ্ঞাপনের প্রাপ্যতা পান

নিম্নলিখিত উদাহরণটি বিজ্ঞাপনের প্রাপ্যতা যাচাই করে: 

var isAdAvailable = InterstitialAdPreloader.IsAdAvailable("AD_UNIT_ID");

আগে থেকে লোড করা বিজ্ঞাপনের প্রাপ্যতা শুনুন

বিজ্ঞাপন সফলভাবে প্রি-লোড হলে, প্রি-লোড হতে ব্যর্থ হলে, বা বিজ্ঞাপনের ক্যাশ শেষ হয়ে গেলে বিজ্ঞপ্তি পেতে প্রি-লোড ইভেন্টের জন্য নিবন্ধন করুন।

প্রিলোড ইভেন্টগুলো অ্যানালিটিক্স উদ্দেশ্যে ব্যবহৃত হয়। প্রিলোড ইভেন্ট কলব্যাকের মধ্যে:

  • Preload কল করবেন না।
  • বিজ্ঞাপনটি অবিলম্বে দেখানো না হলে DequeueAd কল করা থেকে বিরত থাকুন।

নিম্নলিখিত উদাহরণটি বিজ্ঞাপন ইভেন্টের জন্য নিবন্ধন করে: 


void StartPreloadWithCallbacks()
{
    var preloadConfiguration = new PreloadConfiguration
    {
        AdUnitId = "AD_UNIT_ID",
        Request = new AdRequest(),
    };

    // Start the preloading initialization process after MobileAds.Initialize().
    InterstitialAdPreloader.Preload(
        // The Preload ID can be any unique string to identify this configuration.
        "AD_UNIT_ID",
        preloadConfiguration,
        onAdPreloaded,
        onAdFailedToPreload,
        onAdsExhausted);
}

void onAdPreloaded(string preloadId, ResponseInfo responseInfo)
{
    Debug.Log($"Preload ad configuration {preloadId} was preloaded.");
}

void onAdFailedToPreload(string preloadId, AdError adError)
{
    string errorMessage = $"Preload ad configuration {preloadId} failed to " +
                          $"preload with error : {adError.GetMessage()}.";
    Debug.Log(errorMessage);
}

void onAdsExhausted(string preloadId)
{
    Debug.Log($"Preload ad configuration {preloadId} was exhausted");
    // [Important] Don't call Preload() or DequeueAd() from onAdsExhausted.
}

বিজ্ঞাপন প্রি-লোড করা বন্ধ করুন

সেশনে কোনো প্রিলোড আইডির জন্য যদি আবার বিজ্ঞাপন দেখানোর প্রয়োজন না হয়, তাহলে আপনি বিজ্ঞাপন প্রিলোড করা বন্ধ করতে পারেন। একটি নির্দিষ্ট প্রিলোড আইডির জন্য বিজ্ঞাপন প্রিলোড করা বন্ধ করতে, প্রিলোড আইডিটি সহ Destroy কল করুন। সমস্ত প্রিলোডারের জন্য প্রিলোডিং বন্ধ করতে, DestroyAll কল করুন। 

InterstitialAdPreloader.Destroy("AD_UNIT_ID");
InterstitialAdPreloader.DestroyAll();

বাফার আকার সেট করুন

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

new PreloadConfiguration
{
    AdUnitId = "AD_UNIT_ID",
    Request = new AdRequest(),
    BufferSize = 3
};

প্রিলোড ক্যাশে সীমা

Google Mobile Ads Unity Plugin সমস্ত অ্যাড ইউনিট এবং প্রিলোড আইডি জুড়ে প্রিলোড করা বিজ্ঞাপনের মোট সংখ্যার উপর একটি অ্যাপ-ব্যাপী সীমা আরোপ করে:

  • ডিফল্ট সীমা: Google Mobile Ads Unity Plugin মেমরিতে সর্বোচ্চ ৬টি প্রি-লোডেড বিজ্ঞাপন ধারণ করে। এই সীমাটি সমস্ত ফরম্যাট এবং প্রি-লোড আইডি জুড়ে প্রযোজ্য।
  • আমরা প্রতিটি প্রিলোড আইডির জন্য ২ বা ৩ এর একটি বাফার সাইজ রাখার পরামর্শ দিই।