فراداده آگهی

این راهنما برای ناشران در نظر گرفته شده است که فراداده تبلیغات را با Google Mobile Ads SDK برای Android ادغام می کنند.

پیش نیازها

واکشی ابرداده آگهی

برای اطلاعات بیشتر در مورد تبلیغات ارائه شده، به تغییرات فراداده آگهی در تبلیغات ویدیویی پاداش گوش دهید.

onAdMetadataChanged() درست پس از بارگیری آگهی یا زمانی که ابرداده آن به صورت ناهمزمان پس از بارگیری تغییر می کند فراخوانی می شود. تضمینی وجود ندارد که ابرداده یک آگهی در زمان بارگیری آگهی در دسترس باشد، بنابراین توصیه می‌کنیم قبل از دسترسی به فراداده آگهی منتظر این تماس باشید.

در اینجا یک نمونه کد نشان می دهد که چگونه می توان ابرداده تبلیغات را بازیابی کرد:

کاتلین 

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")
      }
    }
  }
})

جاوا 

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 برای تبلیغات با پاداش.

پس از بازیابی متادیتا، می‌توانید Bundle را برای یافتن کلیدهایی که برایتان مهم هستند بررسی کنید. انواع مختلف تبلیغات ممکن است دارای کلیدهای فراداده تبلیغات متفاوتی باشند. تبلیغات ویدیویی VAST دارای کلیدهای زیر هستند:

Key تایپ کنید توضیحات
AdId رشته شناسه آگهی در صورت موجود نبودن خالی است.
AdTitle رشته عنوان، اگر مشخص نشده باشد خالی است.
CreativeDurationMs عدد صحیح مدت زمان خلاقیت انتخاب شده بر حسب میلی ثانیه، -1 اگر غیرخطی باشد.
TraffickingParameters رشته پارامترهای قاچاق، اگر در دسترس نباشد خالی است.
DealId رشته اولین شناسه معامله موجود در زنجیره بسته بندی آگهی فعلی، از بالا شروع می شود - اگر در دسترس نباشد خالی است.
AdSystem رشته سرور آگهی منبع آگهی، در صورت موجود نبودن خالی است.
CreativeId رشته شناسه خلاقیت انتخاب شده برای تبلیغ، در صورت موجود نبودن خالی است.
MediaURL رشته URL رسانه انتخاب شده.
Wrappers آرایه آرایه با عناصری پر شده است که از درونی‌ترین آگهی بسته‌بندی شروع می‌شوند (نزدیک به آگهی درون خطی) و به سمت بیرونی‌ترین آگهی بسته‌بندی حرکت می‌کنند. هر عنصر در آرایه یک فرهنگ لغت است که حاوی کلیدها و مقادیر زیر است.
AdId
رشته . شناسه آگهی استفاده شده برای آگهی بسته بندی، اگر در دسترس نباشد خالی است.
AdSystem
رشته . سیستم تبلیغاتی مورد استفاده برای تبلیغات لفاف دار، اگر در دسترس نباشد خالی است.
CreativeId
رشته . شناسه خلاق مورد استفاده برای تبلیغات بسته بندی، اگر در دسترس نباشد خالی است.