Metadatos de anuncios

Esta guía está destinada a los publicadores que integran los metadatos de anuncios con el SDK de Google Mobile Ads para Android.

Requisitos previos

  • Versión mínima 17.0.0 del SDK de anuncios de Google para dispositivos móviles
  • Completa los pasos en Videos recompensados.

Cómo recuperar metadatos de anuncios

Es posible que algunas apps deseen 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 RewardedVideo.getAdMetadata() para obtener 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 la carga. No se garantiza que los metadatos de un anuncio estén disponibles en el momento en que se carga, por lo que te recomendamos que esperes a 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:

Java

RewardedAd.load(this, "/21775744923/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, "/21775744923/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 paquete en busca de las claves que te interesan. Los diferentes tipos de anuncios pueden tener diferentes claves de metadatos asociadas con ellos. Los anuncios de video de VAST tienen las siguientes claves:

Key Tipo Descripción
AdId String Es el ID del anuncio, vacío si no está disponible.
AdTitle String Es 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 Parámetros de tráfico, vacíos si no están disponibles.
DealId String El primer ID de acuerdo presente en la cadena de wrapper del anuncio actual, comenzando desde la parte superior (vacío si no está disponible)
AdSystem String Es el servidor de anuncios de origen del anuncio, vacío si no está disponible.
CreativeId String Es el ID de la creatividad seleccionada para el anuncio, vacío si no está disponible.
MediaURL String Es la URL del contenido multimedia seleccionado.
Wrappers Array El array se completa con elementos que comienzan en el anuncio envolvente más interno (cerca del anuncio intercalado) y se mueven hacia afuera hasta el anuncio envolvente 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 wrapper. Si no está disponible, aparecerá vacío.
AdSystem
String. Es el sistema de anuncios que se usa para el anuncio del wrapper. Si no está disponible, aparecerá vacío.
CreativeId
String. Es el ID de la creatividad que se usa para el anuncio del wrapper. Si no está disponible, aparecerá vacío.