‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

فراداده آگهی

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

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

پیش‌نیازها

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

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

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

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

جاوا

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`	رشته	نشانی وب رسانه انتخاب‌شده.
`Wrappers`	آرایه	آرایه با عناصری پر می‌شود که از داخلی‌ترین آگهی بسته‌بندی (نزدیک به آگهی به‌خط) شروع می‌شوند و به‌سمت بیرونی‌ترین آگهی بسته‌بندی حرکت می‌کنند. هر عنصر در آرایه یک واژه‌نامه است که شامل کلیدها و مقادیر زیر است. `AdId` رشته. شناسه آگهی مورداستفاده برای آگهی پوششی، درصورت دردسترس نبودن خالی است. `AdSystem` رشته. سیستم آگهی مورداستفاده برای آگهی پوششی، اگر دردسترس نباشد خالی است. `CreativeId` رشته. شناسه طرح آگهی استفاده‌شده برای آگهی پوششی، اگر دردسترس نباشد خالی است.