Metadados do anúncio

Selecione a plataforma: Android Novo Android iOS

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

Pré-requisitos

  • Versão mínima 17.0.0 do SDK do Google Mobile Ads.
  • Conclua as etapas em Vídeo premiado.

Como buscar metadados de anúncios

Para saber mais sobre os anúncios veiculados, ouça as mudanças nos metadados de anúncios em vídeos premiados.

onAdMetadataChanged() é chamado logo após o carregamento de um anúncio ou quando os metadados mudam de forma assíncrona após o carregamento. Não há garantia de que os metadados de um anúncio estarão disponíveis no momento em que ele for carregado. Por isso, 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 recuperar os metadados, você pode verificar o pacote para as chaves que interessam. Diferentes tipos de anúncios podem ter chaves de metadados 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 for 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, vazios se não estiverem disponíveis.
DealId String O primeiro ID da transação presente na cadeia de wrapper do anúncio atual, começando pela parte de cima. Fica 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 in-line) 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 anúncio wrapper, vazio se não estiver disponível.