Metadados do anúncio

Este guia é destinado a editores que integram metadados de anúncios ao SDK dos anúncios para dispositivos móveis do Google para Android.

Pré-requisitos

  • Versão mínima 17.0.0 do SDK dos anúncios para dispositivos móveis do Google.
  • Conclua as etapas em Vídeos premiados.

Buscar metadados do anúncio

Alguns apps podem querer saber mais sobre os anúncios veiculados. É possível detectar mudanças nos metadados de anúncios em anúncios em vídeo premiados chamando RewardedVideoAd.setAdMetadataListener() com uma implementação de AdMetadataListener. Depois que AdMetadataListener.onAdMetadataChanged() for chamado, confira RewardedVideo.getAdMetadata() para os metadados de um anúncio.

onAdMetadataChanged() é chamado logo após o carregamento de um anúncio ou quando os metadados dele mudam de forma assíncrona após o carregamento. Não é garantido que os metadados de um anúncio estarão disponíveis no momento em que ele for carregado. Portanto, recomendamos aguardar esse callback antes de acessar os metadados de um anúncio.

Confira um exemplo de código que mostra como recuperar os metadados do anúncio:

Java

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

Kotlin

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

Depois de extrair os metadados, você pode verificar o pacote para encontrar as chaves que são importantes para você. Diferentes tipos de anúncios podem ter chaves de metadados de anúncios diferentes associadas a eles. Os anúncios em vídeo VAST têm as seguintes chaves:

Key Tipo Descrição
AdId String O ID do anúncio, vazio se não estiver disponível.
AdTitle String O título, vazio se não especificado.
CreativeDurationMs Número inteiro A duração do criativo selecionado em milissegundos, -1 se não for linear.
TraffickingParameters String Parâmetros de tráfego, vazio se não estiver disponível.
DealId String O primeiro ID de transação presente na cadeia de wrapper do anúncio atual, começando de cima, vazio se não estiver disponível.
AdSystem String O servidor de anúncios de origem do anúncio, vazio se não estiver disponível.
CreativeId String O ID do criativo selecionado para o anúncio, vazio se não estiver disponível.
MediaURL String O URL da mídia selecionada.
Wrappers Matriz A matriz é preenchida com elementos que começam no anúncio wrapper mais interno (próximo ao anúncio inline) e se movem para fora até o anúncio wrapper mais externo. Cada elemento na matriz é um dicionário que contém as seguintes chaves e valores.
AdId
String. ID do anúncio usado para o anúncio wrapper, vazio se não estiver disponível.
AdSystem
String. Sistema de anúncios usado para o anúncio wrapper, vazio se não estiver disponível.
CreativeId
String. ID do criativo usado para o wrapper de anúncio. Vai estar em branco se não estiver disponível.