Comparte tus comentarios sobre el SDK de GMA de nueva generación en el canal de Discord #gma-next-gen-sdk del servidor de la comunidad de Google Advertising and Measurement.

Metadatos de anuncios

Selecciona la plataforma: Android (beta)

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.

Cómo obtener 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.

Este es un ejemplo de código en el que se muestra cómo recuperar los metadatos de los anuncios:

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 consultar el paquete para obtener las claves que te interesan. Es posible que los diferentes tipos de anuncios tengan 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. Está vacío si no está disponible.
`AdTitle`	String	Es el título. 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 publicación. Están vacíos si no están disponibles.
`DealId`	String	Es el primer ID de acuerdo presente en la cadena de wrapper para el 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. 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 propaga con elementos que comienzan en el anuncio de wrapper más interno (cerca del anuncio intercalado) y se extienden hacia afuera hasta el anuncio de wrapper 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 wrapper. Está vacío si no está disponible.