Esta guía está destinada a los editores que integran metadatos de anuncios con el SDK de anuncios de Google para dispositivos móviles de Android.
Requisitos previos
- Versión mínima 17.0.0 del SDK de anuncios de Google para dispositivos móviles
- Completa los pasos en Video recompensado.
Obteniendo metadatos de anuncios
Es posible que algunas apps quieran obtener más información sobre los anuncios que se publicaron. Para detectar cambios en los metadatos de los anuncios de video recompensados, llama a RewardedVideoAd.setAdMetadataListener()
con una implementación de AdMetadataListener
. Una vez que se llame a AdMetadataListener.onAdMetadataChanged()
, puedes verificar el elemento RewardedVideo.getAdMetadata()
para ver los metadatos de un anuncio.
Se llama a onAdMetadataChanged()
justo después de que se carga un anuncio o cuando sus metadatos cambian de forma asíncrona después de que se carga. No se garantiza que los metadatos de un anuncio estarán disponibles en el momento en que se cargue, por lo que recomendamos esperar esta devolución de llamada antes de acceder a los metadatos de un anuncio.
A continuación, se incluye un ejemplo de código que muestra cómo recuperar los metadatos del anuncio:
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") } } })
Después de recuperar los metadatos, puedes verificar el Bundle para las claves que te interesan. Los diferentes tipos de anuncios pueden tener diferentes claves de metadatos de anuncios asociadas a ellos. Los anuncios de video de VAST tienen las siguientes claves:
Key |
Tipo | Descripción |
---|---|---|
AdId |
Cadena | Indica el ID del anuncio. Este campo estará vacío si no está disponible. |
AdTitle |
Cadena | Título, vacío si no se especifica. |
CreativeDurationMs |
Número entero | La duración seleccionada de la creatividad en milisegundos, -1 si no es lineal. |
TraffickingParameters |
Cadena | Parámetros de coordinación de anuncios (vacíos si no están disponibles) |
DealId |
Cadena | Es el primer ID de acuerdo presente en la cadena de wrapper para el anuncio actual, comenzando desde la parte superior; vacío si no está disponible. |
AdSystem |
Cadena | Es el servidor de anuncios fuente del anuncio. Este campo estará vacío si no está disponible. |
CreativeId |
Cadena | El ID de la creatividad seleccionada para el anuncio (vacío si no está disponible). |
MediaURL |
Cadena | La URL del contenido multimedia seleccionado |
Wrappers |
Array |
El array se propaga con elementos que comienzan en el anuncio wrapper interno (cerca del anuncio intercalado) y se mueven hacia afuera, hasta el anuncio wrapper más externo. Cada elemento del array es un diccionario que contiene las siguientes claves y valores.
|