Metadatos de anuncios

Esta guía está dirigida a los publicadores que integran metadatos de anuncios con el SDK de anuncios de Google para dispositivos móviles para Android.

Requisitos previos

  • Versión 17.0.0 o posterior del SDK de anuncios de Google para dispositivos móviles
  • Completa los pasos que se indican en Anuncios de video recompensados.

Recupera los metadatos de los anuncios

Para obtener más información sobre los anuncios publicados, escucha los cambios en los metadatos de los anuncios de video recompensados.

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 estén disponibles en el momento en que se carga el anuncio, por lo que te recomendamos que esperes esta devolución de llamada antes de acceder a los metadatos de un anuncio.

Este es un ejemplo de código que muestra cómo recuperar los metadatos del anuncio:

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");
            }
        });
      };
    };
  );

Reemplaza la unidad de anuncios AD_UNIT_ID. Por ejemplo, /21775744923/example/rewarded para los anuncios recompensados.

Después de recuperar los metadatos, puedes verificar el paquete para ver las claves que te interesan. Los diferentes tipos de anuncios pueden tener asociadas distintas claves de metadatos de anuncios. Los anuncios de video de VAST tienen las siguientes claves:

Key Tipo Descripción
AdId String Es el ID del anuncio, que estará vacío si no está disponible.
AdTitle String El título, vacío si no se especifica.
CreativeDurationMs Número entero Es la duración de la creatividad seleccionada en milisegundos, -1 si no es lineal.
TraffickingParameters String Son los parámetros de coordinación de anuncios, que están vacíos si no están disponibles.
DealId String Es el primer ID del acuerdo presente en la cadena de wrapper del anuncio actual, comenzando desde la parte superior. Está vacío si no está disponible.
AdSystem String Es el servidor de anuncios de origen del anuncio. Si no está disponible, se muestra vacío.
CreativeId String Es el ID de la creatividad seleccionada para el anuncio. Si no está disponible, se muestra vacío.
MediaURL String Es la URL del contenido multimedia seleccionado.
Wrappers Array El array se completa con elementos que comienzan en el anuncio wrapper más interno (cerca del anuncio intercalado) y se mueven hacia el anuncio wrapper más externo. Cada elemento del array es un diccionario que contiene las siguientes claves y valores.
AdId
String. Es el ID de anuncio que se usa para el anuncio de wrapper. Está vacío si no está disponible.
AdSystem
String. Es el sistema de anuncios que se usa para el anuncio wrapper. Está vacío si no está disponible.
CreativeId
String. Es el ID de la creatividad que se usa para el anuncio envoltorio. Está vacío si no está disponible.