فراداده آگهی

انتخاب پلاتفرم: Android iOS Android (قدیمی)

این راهنما برای ناشرانی است که «فراداده آگهی» را با «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google برای Android» ادغام می‌کنند.

پیش‌نیازها

  • حداقل نسخه ۱۷.۰.۰ کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google.
  • مراحل را در ویدیو پاداش‌دار تکمیل کنید.

درحال واکشی فراداده آگهی

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

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

Kotlin

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

پس‌از بازیابی فراداده، می‌توانید «بسته» را برای کلیدهایی که برایتان مهم است بررسی کنید. انواع مختلف آگهی ممکن است کلیدهای فراداده آگهی متفاوتی داشته باشند که به آن‌ها مرتبط است. آگهی‌های ویدیویی VAST دارای کلیدهای زیر هستند:

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