فراداده آگهی

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

پیش نیازها

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

برخی از برنامه‌ها ممکن است بخواهند درباره تبلیغاتی که ارائه شده‌اند بیشتر بدانند. می‌توانید با فراخوانی RewardedVideoAd.setAdMetadataListener() با اجرای AdMetadataListener به تغییرات فراداده آگهی در تبلیغات ویدیویی دارای پاداش گوش دهید. هنگامی که AdMetadataListener.onAdMetadataChanged() فراخوانی شد، می توانید RewardedVideo.getAdMetadata() را برای فراداده های یک آگهی بررسی کنید.

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
رشته . شناسه خلاق مورد استفاده برای تبلیغات بسته بندی، اگر در دسترس نباشد خالی است.