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

দ্রষ্টব্য: কাস্টম নেটিভ বিজ্ঞাপন শুধুমাত্র অ্যাড ম্যানেজার প্রকাশকদের জন্য উপলব্ধ।

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

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

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

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

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

void LoadCustomNativeAd()
{
    AdLoader adLoader = new AdLoader.Builder("/6499/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() পদ্ধতি প্রদান করে যা একটি ফরম্যাট ক্ষেত্রের পরিবর্তনশীল আইডিকে প্যারামিটার হিসেবে গ্রহণ করে।

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

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("/6499/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.");
}