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

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

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

• Минимальная версия Google Mobile Ads SDK 17.0.0.
• Выполните действия, описанные в разделе Видео с вознаграждением .

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

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

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

Примечание. Только объявления VAST Wrapper будут иметь ключ Wrappers в метаданных объявления. Встроенные объявления VAST не содержат метаданных Wrappers .