Anuncios de banner que se pueden contraer

Los anuncios de banner contraíbles son anuncios de banner que, en un principio, se presentan como una superposición más grande, con un botón para contraerlos al tamaño de banner solicitado originalmente. El objetivo de los anuncios de banner que se pueden contraer es mejorar el rendimiento de los anuncios fijos que, de otro modo, tienen un tamaño más pequeño. En esta guía, se muestra cómo activar los anuncios de banner que se pueden contraer para las posiciones de banner existentes.

Requisitos previos

• Completa la guía de introducción a los anuncios de banner.

Implementación

Asegúrate de que la vista de tu banner esté definida con el tamaño que deseas que los usuarios vean en el estado normal (contraido) del banner. Incluye un parámetro de extras en la solicitud del anuncio con collapsible como clave y la posición del anuncio como valor.

La posición contraíble define cómo se ancla la región expandida al anuncio de banner.

Valor Placement	Comportamiento	Caso de uso previsto
top	La parte superior del anuncio expandido se alinea con la parte superior del anuncio contraído.	El anuncio se coloca en la parte superior de la pantalla.
bottom	La parte inferior del anuncio expandido se alinea con la parte inferior del anuncio contraído.	El anuncio se coloca en la parte inferior de la pantalla.

Si el anuncio cargado es un banner plegable, este muestra la superposición plegable de inmediato una vez que se coloca en la jerarquía de vista.

Java

private void loadBannerAd() {
  adView = new AdView(this);
  adView.setAdUnitId("ca-app-pub-3940256099942544/2014213617")

  AdSize adSize = getAdSize();
  adView.setAdSize(adSize);
  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the bannerView.
  Bundle extras = new Bundle();
  extras.putString("collapsible", "bottom");

  AdRequest adRequest = new AdRequest.Builder()
      .addNetworkExtrasBundle(AdMobAdapter.class, extras)
     .build();

  adView.loadAd(adRequest);
}

Kotlin

private fun loadBanner() {adView = AdView(this);
  adView.adUnitId = "ca-app-pub-3940256099942544/2014213617"

  adView.setAdSize(adSize)

  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the bannerView.
  val extras = Bundle()
  extras.putString("collapsible", "bottom")

  val adRequest = AdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
    .build()

  adView.loadAd(adRequest)
}

Comportamiento de actualización de los anuncios

En el caso de las aplicaciones que configuran la actualización automática de los anuncios de banner en la interfaz web de Ad Manager, cuando se solicita un anuncio de banner contraíble para un espacio de banner, las actualizaciones de anuncios posteriores no solicitarán anuncios de banner contraíbles. Esto se debe a que mostrar un banner contraíble en cada actualización podría tener un impacto negativo en la experiencia del usuario.

Si deseas cargar otro anuncio de banner contraíble más adelante en la sesión, puedes cargar un anuncio de forma manual con una solicitud que contenga el parámetro contraíble.

Comprueba si un anuncio cargado se puede contraer

Los anuncios de banner no contraíbles son aptos para mostrarse en las solicitudes de anuncios contraíbles para maximizar el rendimiento. Llama a isCollapsible para comprobar si el último banner cargado se puede contraer. Si la solicitud no se carga y el banner anterior es contraíble, la API muestra un valor verdadero.

Java

public void onAdLoaded() {
  Log.i(TAG, String.format("The last loaded banner is %scollapsible.", adView.isCollapsible() ? "" : "not "));
}

Kotlin

fun onAdLoaded() {
  Log.i(TAG, "The last loaded banner is ${if (adView.isCollapsible) "" else "not "}collapsible.")
}

Mediación

Los anuncios de banner contraíbles solo están disponibles para la demanda de Google durante el período beta. Los anuncios publicados a través de la mediación se muestran como anuncios de banner normales que no se pueden contraer.