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

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

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

AdLoader অবজেক্ট ব্যবহার করে কাস্টম নেটিভ বিজ্ঞাপন ফর্ম্যাট লোড করা হয়। forCustomTemplateAd() পদ্ধতি কাস্টম নেটিভ বিজ্ঞাপন ফর্ম্যাটগুলি পরিচালনা করতে AdLoader কনফিগার করে। প্রতিটি কাস্টম নেটিভ বিজ্ঞাপন ফর্ম্যাটের সাথে একটি টেমপ্লেট আইডি মান যুক্ত থাকে। আপনাকে অবশ্যই কাস্টম নেটিভ বিজ্ঞাপন ফর্ম্যাটের টেমপ্লেট আইডি নির্দিষ্ট করতে হবে আপনার অ্যাপ AdLoader অনুরোধ করতে চায়৷ আপনি যে নেটিভ বিজ্ঞাপন ফর্ম্যাটের অনুরোধ করতে চান তার টেমপ্লেট আইডির জন্য অ্যাড ম্যানেজার UI-তে টেমপ্লেট আইডিগুলি খুঁজুন।

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

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

void LoadCustomNativeTemplateAd()
{
    AdLoader adLoader = new AdLoader.Builder("/21775744923/example/native")
        .forCustomNativeAd("10063170")
        .forCustomNativeAd("10063171")
        .forCustomNativeAd("10063172")
        .Build();
    adLoader.LoadAd(new AdRequest.Builder().Build());
}

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

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

adLoader.onCustomNativeTemplateAdLoaded += HandleCustomNativeAdLoaded;
adLoader.OnAdFailedToLoad += HandleCustomNativeAdFailedToLoad;

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

private boolean adLoaded;
private CustomNativeTemplateAd customNativeTemplateAd;
...
void HandleCustomNativeAdLoaded(object sender, CustomNativeEventArgs args)
{
    customNativeTemplateAd = args.nativeAd;
    adLoaded = true;
}

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

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

নিম্নলিখিত উদাহরণ বাস্তবায়ন একটি CustomNativeTemplateAd থেকে সম্পদ বের করে:

public const int NATIVE_AD_TEMPLATE_1 = 10063170;
public const int NATIVE_AD_TEMPLATE_2 = 10063171;

private boolean adLoaded;
private Texture2d mainImageTexture;
private string headline;
private CustomNativeTemplateAd customNativeTemplateAd;
...

void Update()
{
    if(adLoaded)
    {
        mainImageTexture = customNativeTemplateAd.GetTexture2D("MainImage");
        headline = customNativeTemplateAd.GetText("Headline");

        string templateId = customNativeTemplateAd.GetCustomTemplateId();
        if (templateId == NATIVE_AD_TEMPLATE_1)
        {
            ...
        }
        else if (templateId == NATIVE_AD_TEMPLATE_2)
        {
            ...
        }
        ...
        adLoaded = false;
    }
}
...

void HandleCustomNativeAdLoaded(object sender, CustomNativeEventArgs args)
{
    customNativeTemplateAd = args.nativeAd;
    adLoaded = true;
    ...
}

দ্রষ্টব্য: যখন বিজ্ঞাপন ইভেন্টগুলি Google Mobile Ads Android SDK থেকে ইউনিটি প্লাগইনে ফরওয়ার্ড করা হয়, তখন সেগুলিকে মূল থ্রেডে ডাকা হয় না। যেহেতু ইউনিটির মূল থ্রেডে টেক্সচার লোড করা প্রয়োজন, তাই একটি CustomNativeTemplateAd থেকে সম্পদগুলি onCustomNativeTemplateAdLoaded বিজ্ঞাপন ইভেন্টের মধ্যে অ্যাক্সেস করা যাবে না। উপরের কোড উদাহরণটি OnAdLoaded বিজ্ঞাপন ইভেন্টের মধ্যে থেকে একটি পতাকা সেট করার বা অবস্থা পরিবর্তন করার প্রস্তাবিত অনুশীলনকে চিত্রিত করে। Update() পদ্ধতি এই পতাকা পরীক্ষা করতে পারে বা অবস্থার পরিবর্তন করতে পারে এবং কাস্টম নেটিভ টেমপ্লেট বিজ্ঞাপন সম্পদ অ্যাক্সেস করতে পারে।

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

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

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

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

customNativeTemplateAd.RecordImpression();

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

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

customNativeTemplateAd.PerformClick("MainImage");

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

1. বিজ্ঞাপনের ডিপ লিঙ্ক URL-এর জন্য একটি বিষয়বস্তু সমাধানকারী খুঁজুন এবং সমাধান করা প্রথমটি শুরু করুন।
2. একটি ব্রাউজার খুলুন এবং বিজ্ঞাপনের ঐতিহ্যগত গন্তব্য URL এ নেভিগেট করুন।

কাস্টম ক্লিক কর্ম

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

private void LoadCustomNativeTemplateAd()
{
    AdLoader adLoader = new AdLoader.Builder("/21775744923/example/native")
        .forCustomNativeAd("10063170", HandleCustomNativeAdClicked)
        .Build();
    adLoader.onCustomNativeTemplateAdLoaded += HandleCustomNativeAdLoaded;
    adLoader.OnAdFailedToLoad += HandleCustomNativeAdFailedToLoad;
    adLoader.LoadAd(createAdRequest());
}

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