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

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

Предварительные условия

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

Некоторым приложениям может потребоваться дополнительная информация о показанной рекламе. Вы можете прослушивать изменения метаданных объявлений в видеообъявлениях с вознаграждением, вызвав RewardedVideoAd.setAdMetadataListener() с реализацией AdMetadataListener . После вызова AdMetadataListener.onAdMetadataChanged() вы можете проверить RewardedVideo.getAdMetadata() на наличие метаданных объявления.

onAdMetadataChanged() вызывается сразу после загрузки объявления или когда его метаданные изменяются асинхронно после загрузки. Не гарантируется, что метаданные объявления будут доступны во время загрузки объявления, поэтому мы рекомендуем дождаться этого обратного вызова, прежде чем получать доступ к метаданным объявления.

Вот пример кода, показывающий, как получить метаданные объявления:

Джава

RewardedAd.load(this, "/6499/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, "/6499/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
Нить . Идентификатор объявления, используемый для объявления-контейнера. Если он недоступен, пусто.