বিজ্ঞাপন মেটাডেটা

এই নির্দেশিকাটি Android-এর জন্য Google Mobile Ads SDK-এর সাথে বিজ্ঞাপনের মেটাডেটা ইন্টিগ্রেট করা প্রকাশকদের জন্য তৈরি করা হয়েছে।

পূর্বশর্ত

বিজ্ঞাপনের মেটাডেটা ফেচ করা হচ্ছে

পরিবেশিত বিজ্ঞাপন সম্পর্কে আরও জানতে, পুরস্কার প্রদানকারী ভিডিও বিজ্ঞাপনে বিজ্ঞাপন মেটাডেটা পরিবর্তন শুনুন।

কোনও বিজ্ঞাপন লোড হওয়ার ঠিক পরেই অথবা লোড হওয়ার পরে অ্যাসিঙ্ক্রোনাসভাবে মেটাডেটা পরিবর্তন হলে onAdMetadataChanged() কল করা হয়। বিজ্ঞাপন লোড হওয়ার সময় বিজ্ঞাপনের মেটাডেটা উপলভ্য থাকবে কিনা তার কোনও গ্যারেন্টি নেই, তাই বিজ্ঞাপনের মেটাডেটা অ্যাক্সেস করার আগে এই কলব্যাকের জন্য অপেক্ষা করার সাজেশন আমরা দিই।

বিজ্ঞাপনের মেটাডেটা কীভাবে ফিরিয়ে আনতে হয় তা দেখানোর জন্য এখানে একটি কোডের উদাহরণ দেওয়া হল:

Kotlin 

RewardedAd.load(
AdRequest.Builder("AD_UNIT_ID").build(),
object : AdLoadCallback<RewardedAd> {
  override fun onAdLoaded(ad: RewardedAd) {
    ...
    ad.adEventCallback = object : RewardedAdEventCallback {
      override fun onAdMetadataChanged() {
        val metadata = ad.adMetadata
        val adId = metadata.getString("AdId")
      }
    }
  }
})

Java 

RewardedAd.load(
  new AdRequest.Builder("AD_UNIT_ID").build(),
  new AdLoadCallback<RewardedAd>() {
    @Override
    public void onAdLoaded(@NonNull RewardedAd rewardedAd) {
      Rewarded.this.rewardedAd = rewardedAd;
        ...
        rewardedAd.setAdEventCallback(new RewardedAdEventCallback() {
            @Override
            public void onAdMetadataChanged() {
                Bundle metadata = rewardedAd.getAdMetadata();
                String adId = metadata.getString("AdId");
            }
        });
      };
    };
  );

AD_UNIT_ID বিজ্ঞাপন ইউনিট পরিবর্তন করুন। যেমন, /21775744923/example/rewarded পুরস্কার প্রদানকারী বিজ্ঞাপনের জন্য।

মেটাডেটা ফিরিয়ে আনার পরে, আপনি যে কীগুলি সম্পর্কে জানতে চান তার জন্য বান্ডেল চেক করতে পারেন। বিভিন্ন ধরনের বিজ্ঞাপনের সাথে বিভিন্ন ধরনের বিজ্ঞাপন মেটাডেটা কী যুক্ত থাকতে পারে। VAST ভিডিও বিজ্ঞাপনে নিম্নলিখিত কী থাকে:

Key ধরন বিবরণ
AdId স্ট্রিং বিজ্ঞাপনের আইডি, উপলভ্য না থাকলে খালি।
AdTitle স্ট্রিং শীর্ষক, উল্লেখ করা না থাকলে খালি থাকবে।
CreativeDurationMs পূর্ণসংখ্যা মিলি সেকেন্ডে বেছে নেওয়া ক্রিয়েটিভের সময়সীমা, নন-লিনিয়ার হলে -১।
TraffickingParameters স্ট্রিং ট্রাফিকিং প্যারামিটার, উপলভ্য না থাকলে খালি থাকে।
DealId স্ট্রিং বর্তমান বিজ্ঞাপনের জন্য র‍্যাপার চেনে উপস্থিত প্রথম ডিল আইডি, উপর থেকে শুরু করে--উপলভ্য না হলে খালি।
AdSystem স্ট্রিং বিজ্ঞাপনের সোর্স বিজ্ঞাপন সার্ভার, উপলভ্য না থাকলে ফাঁকা থাকে।
CreativeId স্ট্রিং বিজ্ঞাপনের জন্য বেছে নেওয়া ক্রিয়েটিভের আইডি, উপলভ্য না থাকলে খালি থাকবে।
MediaURL স্ট্রিং বেছে নেওয়া মিডিয়ার URL।
Wrappers অ্যারে অ্যারেটি সবচেয়ে ভিতরের র‌্যাপার বিজ্ঞাপন (ইনলাইন বিজ্ঞাপনের কাছাকাছি) থেকে শুরু করে সবচেয়ে বাইরের র‌্যাপার বিজ্ঞাপন পর্যন্ত এলিমেন্ট দিয়ে ভর্তি করা হয়। অ্যারের প্রতিটি এলিমেন্ট হল একটি ডিকশনারি যাতে নিম্নলিখিত কী ও ভ্যালু থাকে।
AdId
String. র‍্যাপার বিজ্ঞাপনের জন্য ব্যবহৃত বিজ্ঞাপন আইডি, উপলভ্য না থাকলে খালি থাকে।
AdSystem
String. র‍্যাপার বিজ্ঞাপনের জন্য ব্যবহৃত বিজ্ঞাপন সিস্টেম, উপলভ্য না থাকলে খালি থাকে।
CreativeId
String. র‍্যাপার বিজ্ঞাপনের জন্য ব্যবহৃত ক্রিয়েটিভ আইডি, উপলভ্য না থাকলে খালি থাকে।