Compartilhe seu feedback sobre o SDK do GMA Next-Gen no canal do Discord #gma-next-gen-sdk do servidor da Comunidade de publicidade e medição do Google.

Metadados do anúncio

Selecione a plataforma: Android (Beta)

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 do carregamento. 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, 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 veiculação, 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.