Metadados do anúncio

Este guia é destinado a publishers que integram metadados de anúncios com o SDK de 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ídeo premiado.

Buscando metadados do anúncio

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

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 há garantia de que os metadados de um anúncio estarão disponíveis quando 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:

Kotlin 

RewardedAd.load(
AdRequest.Builder("AD_UNIT_ID").build(),
object : AdLoadCallback<RewardedAd> {
  override fun onAdLoaded(ad: RewardedAd) {
    ...
    ad.adEventCallback = object : RewardedAdEventCallback {
      override fun onAdMetadataChanged() {
        val metadata = ad.adMetadata
        val adId = metadata.getString("AdId")
      }
    }
  }
})

Java 

RewardedAd.load(
  new AdRequest.Builder("AD_UNIT_ID").build(),
  new AdLoadCallback<RewardedAd>() {
    @Override
    public void onAdLoaded(@NonNull RewardedAd rewardedAd) {
      Rewarded.this.rewardedAd = rewardedAd;
        ...
        rewardedAd.setAdEventCallback(new RewardedAdEventCallback() {
            @Override
            public void onAdMetadataChanged() {
                Bundle metadata = rewardedAd.getAdMetadata();
                String adId = metadata.getString("AdId");
            }
        });
      };
    };
  );

Substitua o bloco de anúncios AD_UNIT_ID. Por exemplo, /21775744923/example/rewarded para anúncios premiados.

Depois de recuperar os metadados, verifique o pacote em busca das chaves que você quer. Diferentes tipos de anúncios podem ter chaves de metadados 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, que fica vazio se não for especificado.
CreativeDurationMs Número inteiro A duração do criativo selecionado em milissegundos. -1 se for não linear.
TraffickingParameters String Parâmetros de tráfego, vazios se não estiverem disponíveis.
DealId String O primeiro ID de negociação presente na cadeia de wrappers do anúncio atual, começando de cima para baixo. 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. Fica vazio se não estiver disponível.
MediaURL String O URL da mídia selecionada.
Wrappers Matriz A matriz é preenchida com elementos começando pelo anúncio wrapper mais interno (próximo ao anúncio inline) e seguindo para o 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. Fica em branco se não estiver disponível.
AdSystem
String. Sistema de publicidade usado para o anúncio wrapper. Fica vazio se não estiver disponível.
CreativeId
String. ID do criativo usado para o anúncio wrapper. Fica vazio se não estiver disponível.