কাস্টম নেটিভ বিজ্ঞাপন ফরম্যাট

বিজ্ঞাপন পরিচালক প্রকাশকদের কাছে কাস্টম সম্পদের তালিকা নির্ধারণ করে তাদের নিজস্ব নেটিভ বিজ্ঞাপন ফর্ম্যাট তৈরি করার বিকল্প রয়েছে। এগুলিকে কাস্টম নেটিভ বিজ্ঞাপন ফর্ম্যাট বলা হয় এবং সংরক্ষিত বিজ্ঞাপনের সাথে ব্যবহার করা যেতে পারে। কাস্টম নেটিভ বিজ্ঞাপন প্রকাশকদের তাদের অ্যাপে ইচ্ছামত ছবি এবং স্ট্রিং ডেটা প্রেরণ করতে সক্ষম করে। এই ডেটা একটি CustomNativeAd অবজেক্ট দ্বারা প্রতিনিধিত্ব করা হয়।

একটি কাস্টম নেটিভ বিজ্ঞাপন লোড করুন

কাস্টম নেটিভ বিজ্ঞাপনগুলি AdLoader অবজেক্ট ব্যবহার করে লোড করা হয়। ForCustomNativeAd() পদ্ধতিটি AdLoader কাস্টম নেটিভ বিজ্ঞাপন পরিচালনা করার জন্য কনফিগার করে। এই পদ্ধতির জন্য দুটি প্যারামিটার রয়েছে:

  • AdLoader যে কাস্টম বিজ্ঞাপনের জন্য অনুরোধ করবে তার formatId । প্রতিটি কাস্টম নেটিভ বিজ্ঞাপন ফর্ম্যাটের সাথে একটি ফর্ম্যাট আইডি মান যুক্ত থাকে। এই প্যারামিটারটি নির্দেশ করে যে আপনার অ্যাপ AdLoader কোন ফর্ম্যাটের অনুরোধ করতে চায়।
  • ব্যবহারকারী যখন বিজ্ঞাপনে ক্লিক করেন তখন একটি ঐচ্ছিক Action<CustomNativeAd, string> ব্যবহার করা হবে।

কাস্টম নেটিভ বিজ্ঞাপনগুলি AdLoader ক্লাসের মাধ্যমে লোড করা হয়, যার নিজস্ব AdLoader.Builder ক্লাস রয়েছে যা তৈরির সময় এটি কাস্টমাইজ করে। ForCustomNativeAd() পদ্ধতিটি AdLoader নেটিভ বিজ্ঞাপন পরিচালনা করার জন্য কনফিগার করে।

void LoadCustomNativeAd()
{
    AdLoader adLoader = new AdLoader.Builder("/21775744923/example/native")
            .ForCustomNativeAd("10063170")
            .Build();
    adLoader.LoadAd(new AdRequest.Builder().Build());
}

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

কাস্টম নেটিভ বিজ্ঞাপন ইভেন্ট

AdLoader ক্লাসটি EventHandler ধরণের বিজ্ঞাপন ইভেন্ট প্রদান করে, যা আপনাকে একটি কাস্টম নেটিভ বিজ্ঞাপনের জীবনচক্র সম্পর্কে অবহিত করে। নীচের উদাহরণটি দেখায় যে কীভাবে একটি বিজ্ঞাপন লোডারে কাস্টম নেটিভ বিজ্ঞাপন ইভেন্টের জন্য নিবন্ধন করতে হয়:

private AdLoader adLoader;
adLoader.OnCustomNativeAdLoaded += HandleCustomNativeAdLoaded;
adLoader.OnAdFailedToLoad += HandleCustomNativeAdFailedToLoad;

HandleCustomNativeAdLoaded() পদ্ধতিতে একটি CustomNativeAdEventArgs প্যারামিটার থাকে। লোড হওয়া কাস্টম নেটিভ বিজ্ঞাপনটি এই ইভেন্ট প্যারামিটারের মাধ্যমে অ্যাক্সেস করা যেতে পারে, যেমনটি নীচে দেখানো হয়েছে:

void HandleCustomNativeAdLoaded(object sender, CustomNativeAdEventArgs args)
{
    this.customNativeAd = args.nativeAd;
}

HandleCustomNativeAdFailedToLoad() পদ্ধতিতে একটি AdFailedToLoadEventArgs প্যারামিটার রয়েছে। LoadAdError ক্ষেত্রের GetMessage পদ্ধতিটি কল করে ত্রুটি বার্তাটি অ্যাক্সেস করা যেতে পারে, যেমনটি নীচে দেখানো হয়েছে:

void HandleCustomNativeAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
{
    string message = args.LoadAdError.GetMessage();
    Debug.Log("Ad Loader fail event received with message: " + message);
}

কাস্টম নেটিভ বিজ্ঞাপন ফর্ম্যাটগুলি প্রদর্শন করুন

কাস্টম নেটিভ বিজ্ঞাপনগুলি যেকোনো সংখ্যক ব্যবহারকারী-সংজ্ঞায়িত চিত্র এবং পাঠ্য সম্পদের জন্য সমর্থন প্রদান করে। এই সম্পদগুলি CustomNativeAd ক্লাসের মাধ্যমে অ্যাক্সেস করা হয়, যা GetTexture2D() এবং GetText() পদ্ধতি প্রদান করে যা একটি ফর্ম্যাট ক্ষেত্রের পরিবর্তনশীল ID কে একটি প্যারামিটার হিসাবে গ্রহণ করে।

এখানে একটি উদাহরণ বাস্তবায়ন যা একটি কাস্টম নেটিভ বিজ্ঞাপন থেকে সম্পদ অ্যাক্সেস করে:

private bool adLoaded;
private Texture2D mainImageTexture;
private string headline;
private CustomNativeAd customNativeAd;
...

void Update()
{
    if(adLoaded)
    {
        mainImageTexture = customNativeAd.GetTexture2D("MainImage");
        headline = customNativeAd.GetText("Headline");
        adLoaded = false;
    }
}
...
void HandleCustomNativeAdLoaded(object sender, CustomNativeAdEventArgs args)
{
    customNativeAd = args.nativeAd;
    adLoaded = true;
    ...
}

কাস্টম নেটিভ বিজ্ঞাপনের ইম্প্রেশন এবং ক্লিকগুলি পরিচালনা করুন

কাস্টম নেটিভ বিজ্ঞাপনের মাধ্যমে, আপনার অ্যাপটি ইম্প্রেশন রেকর্ড করার এবং SDK-তে ক্লিক ইভেন্ট রিপোর্ট করার জন্য দায়ী।

রেকর্ড ইম্প্রেশন

একটি কাস্টম বিজ্ঞাপনের জন্য একটি ইম্প্রেশন রেকর্ড করতে, সংশ্লিষ্ট CustomNativeAd এ RecordImpression() পদ্ধতিটি কল করুন:

customNativeAd.RecordImpression();

ক্লিক রিপোর্ট করুন

কোনও অ্যাসেটে ক্লিক হয়েছে কিনা তা SDK-তে রিপোর্ট করতে, সংশ্লিষ্ট CustomNativeAd এ PerformClick() পদ্ধতিতে কল করুন এবং ক্লিক করা অ্যাসেটের নামটি পাস করুন। উদাহরণস্বরূপ, যদি আপনার কাস্টম ফর্ম্যাটে "MainImage" নামক একটি অ্যাসেট থাকে এবং আপনি সেই অ্যাসেটের সাথে সম্পর্কিত টেক্সচারের উপর ক্লিক রিপোর্ট করতে চান, তাহলে আপনার কোডটি এইরকম দেখাবে:

customNativeAd.PerformClick("MainImage");

কাস্টম ক্লিক অ্যাকশনের প্রতিক্রিয়া জানান

যখন কোনও কাস্টম বিজ্ঞাপনে ক্লিকের রিপোর্ট করা হয়, তখন SDK থেকে সম্ভাব্য প্রতিক্রিয়াগুলি এই ক্রমে চেষ্টা করা হয়:

  1. বিজ্ঞাপনের ডিপ লিঙ্ক URL-এর জন্য একটি কন্টেন্ট রিজলভার খুঁজুন এবং প্রথমটি শুরু করুন যা সমাধান করবে।

  2. একটি ব্রাউজার খুলুন এবং বিজ্ঞাপনের ঐতিহ্যবাহী গন্তব্য URL-এ যান।

ব্যবহারকারীকে ডিপ লিঙ্ক বা ওয়েব ব্রাউজারে নিয়ে যাওয়ার পরিবর্তে যদি আপনি নিজের কাস্টম নেটিভ বিজ্ঞাপন ফর্ম্যাটের ক্লিক অ্যাকশন নিজেই পরিচালনা করতে চান, তাহলে AdLoader.Builder.ForCustomNativeAd() পদ্ধতিতে একটি ঐচ্ছিক Action<CustomNativeAd, string> প্রদান করুন। এই কাস্টম ক্লিক অ্যাকশন সেট করে, আপনি SDK এর ক্লিক আচরণকে ওভাররাইড করছেন। এখানে একটি উদাহরণ দেওয়া হল যেখানে একটি নির্দিষ্ট সম্পদের জন্য একটি ক্লিক লগ করার জন্য একটি কাস্টম ক্লিক অ্যাকশন ব্যবহার করা হয়:

private void LoadCustomNativeAd()
{
    AdLoader adLoader = new AdLoader.Builder("/21775744923/example/native")
            .ForCustomNativeAd("10063170", HandleCustomNativeAdClicked)
            .Build();
    adLoader.OnCustomNativeAdLoaded += HandleCustomNativeAdLoaded;
    adLoader.LoadAd(createAdRequest());
}

private void HandleCustomNativeAdClicked(CustomNativeAd customNativeAd, string assetName)
{
    Debug.Log("Custom Native ad asset with name " + assetName + " was clicked.");
}