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

Выберите платформу: 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")
        }
      }
    })

После получения метаданных вы можете проверить пакет на наличие нужных вам ключей. Разные типы рекламы могут иметь разные ключи метаданных. Видеореклама VAST имеет следующие ключи:

Key Тип Описание
AdId Нить Идентификатор объявления. Если недоступно, оставьте пустым.
AdTitle Нить Заголовок. Если не указано, пусто.
CreativeDurationMs Целое число Выбранная длительность креатива в миллисекундах, -1, если нелинейная.
TraffickingParameters Нить Параметры трафика, пустые, если недоступны.
DealId Нить Первый идентификатор сделки, присутствующий в цепочке оберток для текущего объявления, начиная с вершины. Если идентификатор недоступен, он пуст.
AdSystem Нить Исходный сервер объявления. Пустой, если недоступен.
CreativeId Нить Идентификатор выбранного креатива для объявления, пустой, если недоступен.
MediaURL Нить URL выбранного носителя.
Wrappers Множество Массив заполняется элементами, начиная с самого внутреннего объявления-обертки (рядом со встроенным объявлением) и далее к самому внешнему объявлению-обертке. Каждый элемент массива представляет собой словарь, содержащий следующие ключи и значения.
AdId
Строка . Идентификатор объявления, используемый для рекламы-обертки. Пусто, если недоступно.
AdSystem
Строка . Рекламная система, используемая для рекламы-обертки. Пусто, если недоступно.
CreativeId
Строка . Идентификатор креатива, используемый для рекламного объявления, пусто, если недоступно.