Este guia é destinado a editores 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
Alguns apps querem saber mais sobre os anúncios que foram veiculados. Para detectar alterações nos metadados dos anúncios em vídeo premiados, chame RewardedVideoAd.setAdMetadataListener()
com uma implementação de AdMetadataListener
. Depois que AdMetadataListener.onAdMetadataChanged()
for chamado, você poderá verificar RewardedVideo.getAdMetadata()
em busca dos metadados de um anúncio.
O onAdMetadataChanged()
é chamado logo após o carregamento de um anúncio ou quando os
metadados dele mudam de maneira assíncrona após o carregamento. Não há garantia
de que os metadados de um anúncio estejam disponíveis no momento em que o anúncio é
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, "/6499/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, "/6499/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 são importantes para você. Diferentes tipos de anúncios podem ter diferentes 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, em branco 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 for não 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 superior vazia, 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
(perto do anúncio inline) e se movem para fora em direção ao anúncio wrapper mais externo. Cada elemento na matriz é um dicionário que contém as chaves e os valores a seguir.
|