فراداده آگهی

پلتفرم را انتخاب کنید: Android iOS

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

پیش نیازها

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

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

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

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

جاوا 

RewardedAd.load(this, "/21775744923/example/rewarded", new AdManagerAdRequest.Builder().build(),
    new RewardedAdLoadCallback() {
      @Override
      public void onAdLoaded(@NonNull RewardedAd rewardedAd) {
        mRewardedAd = rewardedAd;
        rewardedAd.setOnAdMetadataChangedListener(new OnAdMetadataChangedListener() {
          @Override
          public void onAdMetadataChanged() {
            Bundle metadata = rewardedAd.getAdMetadata();
            String adId = metadata.getString("AdId");
          }
        });
      }
    });

کاتلین 

RewardedAd.load(this, "/21775744923/example/rewarded", AdManagerAdRequest.Builder().build(),
                    object : RewardedAdLoadCallback() {
      override fun onAdLoaded(rewardedAd: RewardedAd) {
        mRewardedAd = rewardedAd
        rewardedAd.onAdMetadataChangedListener = OnAdMetadataChangedListener {
          val metadata = rewardedAd.adMetadata
          val adId = metadata.getString("AdId")
        }
      }
    })

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

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