Metadatos de anuncios

Selecciona la plataforma: Android iOS

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 mínima 17.0.0 del SDK de anuncios de Google para dispositivos móviles
• Completa los pasos en Video recompensado.

Recupera metadatos de 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.

A continuación, se muestra un ejemplo de código en el que se explica 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 Bundle para ver las claves que te interesan. Los diferentes tipos de anuncios pueden tener diferentes claves de metadatos de anuncios asociadas. Los anuncios de video de VAST tienen las siguientes claves:

Key	Tipo	Descripción
AdId	String	Es el ID del anuncio, que está vacío si no está disponible.
AdTitle	String	Es el título, que está vacío si no se especifica.
CreativeDurationMs	Número entero	Es la duración de la creatividad seleccionada en milisegundos. Es -1 si no es lineal.
TraffickingParameters	String	Son los parámetros de segmentación, que están vacíos si no están disponibles.
DealId	String	Es el primer ID de 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 fuente del anuncio. Está vacío si no está disponible.
CreativeId	String	Es el ID de la creatividad seleccionada para el anuncio. Está 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 extienden hacia 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 del 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 de wrapper. Está vacío si no está disponible. CreativeId String. Es el ID de la creatividad que se usa para el anuncio de envoltorio. Está vacío si no está disponible.

Nota: Solo los anuncios de Wrapper de VAST tendrán la clave Wrappers en los metadatos del anuncio. Los anuncios intercalados de VAST no contienen metadatos de Wrappers.