Метаданные объявлений

Это руководство предназначено для издателей, которые интегрируют метаданные объявлений с Google Mobile Ads SDK для Android.

Требования

Получение метаданных объявления

Чтобы узнать больше о показанных объявлениях, отслеживайте изменения метаданных в видеообъявлениях с вознаграждением.

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

Java 

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
Строка. Идентификатор креатива, используемый для контейнера объявления. Если он недоступен, поле остается пустым.