Anuncios de banner

Los anuncios de banner ocupan un lugar en el diseño de la app, ya sea en la parte superior o inferior de la pantalla del dispositivo. Permanecen en la pantalla mientras los usuarios interactúan con la app y se pueden actualizar automáticamente después de un período determinado. Si es la primera vez que usas la publicidad para dispositivos móviles, este es un excelente punto de partida. Caso de éxito

En esta guía, se muestra cómo integrar anuncios de banner deAdMob en una app para Android. Además de los fragmentos y las instrucciones de código, también se incluye información sobre cómo ajustar el tamaño de los banners correctamente y vínculos a recursos adicionales.

Prerequisites

Agregar AdView al diseño

El primer paso para mostrar un banner es colocar AdView en el diseño de Activity o Fragment en el que deseas mostrarlo. La manera más fácil de hacerlo es agregar una al archivo de diseño XML correspondiente. A continuación, se muestra un ejemplo que muestra la actividad AdView:

# main_activity.xml
...
  <com.google.android.gms.ads.AdView
      xmlns:ads="http://schemas.android.com/apk/res-auto"
      android:id="@+id/adView"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_centerHorizontal="true"
      android:layout_alignParentBottom="true"
      ads:adSize="BANNER"
      ads:adUnitId="ca-app-pub-3940256099942544/6300978111">
  </com.google.android.gms.ads.AdView>
...

Ten en cuenta los siguientes atributos obligatorios:

  • ads:adSize: se establece según el tamaño del anuncio que deseas utilizar. Si no deseas usar el tamaño estándar definido por la constante, puedes configurar un tamaño personalizado. Para obtener más información, consulta la sección sobre el tamaño del banner más abajo.
  • ads:adUnitId: configura esto como el identificador único asignado al bloque de anuncios en tu app donde se mostrarán los anuncios. Si muestras anuncios de banner en diferentes actividades, cada uno requeriría un bloque de anuncios.

Como alternativa, puedes crear AdView de manera programática:

Java

AdView adView = new AdView(this);

adView.setAdSize(AdSize.BANNER);

adView.setAdUnitId("ca-app-pub-3940256099942544/6300978111");
// TODO: Add adView to your view hierarchy.

Kotlin

val adView = AdView(this)

adView.adSize = AdSize.BANNER

adView.adUnitId = "ca-app-pub-3940256099942544/6300978111"
// TODO: Add adView to your view hierarchy.

Probar siempre con anuncios de prueba

Cuando compiles y pruebes tus apps, asegúrate de usar anuncios de prueba en lugar de anuncios de producción publicados. De lo contrario, podría suspenderse tu cuenta.

La forma más fácil de cargar anuncios de prueba es usar nuestro ID de bloque de anuncios de prueba exclusivo para banners de Android:

ca-app-pub-3940256099942544/6300978111

Se configuró especialmente para mostrar anuncios de prueba en cada solicitud, y puedes usarlo en tus propias apps durante la codificación, las pruebas y la depuración. Asegúrate de reemplazarlo con tu propio ID de bloque de anuncios antes de publicar la app.

Para obtener más información sobre cómo funcionan los anuncios de prueba del SDK de anuncios para dispositivos móviles, consulta Anuncios de prueba.

Carga un anuncio

Una vez que AdView esté implementado, el siguiente paso es cargar un anuncio. Eso se hace con el método loadAd() en la clase AdView. Toma un parámetro AdRequest, que contiene información del tiempo de ejecución (como la información de segmentación) sobre una sola solicitud de anuncio.

A continuación, se muestra un ejemplo que muestra cómo cargar un anuncio en el método onCreate() de un Activity:

MainActivity (extracto)

Java

package ...

import ...
import com.google.android.gms.ads.AdRequest;
import com.google.android.gms.ads.AdView;

public class MainActivity extends AppCompatActivity {
    private AdView mAdView;

    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        MobileAds.initialize(this, new OnInitializationCompleteListener() {
            @Override
            public void onInitializationComplete(InitializationStatus initializationStatus) {
            }
        });

        mAdView = findViewById(R.id.adView);
        AdRequest adRequest = new AdRequest.Builder().build();
        mAdView.loadAd(adRequest);
    }
}

Kotlin

package ...

import ...
import com.google.android.gms.ads.AdRequest
import com.google.android.gms.ads.AdView

class MainActivity : AppCompatActivity() {

    lateinit var mAdView : AdView

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        MobileAds.initialize(this) {}

        mAdView = findViewById(R.id.adView)
        val adRequest = AdRequest.Builder().build()
        mAdView.loadAd(adRequest)
    }
}

Listo. Su aplicación ya está lista para mostrar anuncios de banner.

Eventos de anuncios

Para personalizar aún más el comportamiento de tu anuncio, puedes incluir varios eventos en el ciclo de vida del anuncio: cargar, abrir, cerrar, etcétera. Puedes escuchar estos eventos mediante la clase AdListener.

Para usar un AdListener con AdView, llama al método setAdListener():

Java

mAdView.setAdListener(new AdListener() {
    @Override
    public void onAdClicked() {
      // Code to be executed when the user clicks on an ad.
    }

    @Override
    public void onAdClosed() {
      // Code to be executed when the user is about to return
      // to the app after tapping on an ad.
    }

    @Override
    public void onAdFailedToLoad(LoadAdError adError) {
      // Code to be executed when an ad request fails.
    }

    @Override
    public void onAdImpression() {
      // Code to be executed when an impression is recorded
      // for an ad.
    }

    @Override
    public void onAdLoaded() {
      // Code to be executed when an ad finishes loading.
    }

    @Override
    public void onAdOpened() {
      // Code to be executed when an ad opens an overlay that
      // covers the screen.
    }
});

Kotlin

mAdView.adListener = object: AdListener() {
    override fun onAdClicked() {
      // Code to be executed when the user clicks on an ad.
    }

    override fun onAdClosed() {
      // Code to be executed when the user is about to return
      // to the app after tapping on an ad.
    }

    override fun onAdFailedToLoad(adError : LoadAdError) {
      // Code to be executed when an ad request fails.
    }

    override fun onAdImpression() {
      // Code to be executed when an impression is recorded
      // for an ad.
    }

    override fun onAdLoaded() {
      // Code to be executed when an ad finishes loading.
    }

    override fun onAdOpened() {
      // Code to be executed when an ad opens an overlay that
      // covers the screen.
    }
}

Cada uno de los métodos anulables en AdListener corresponde a un evento en el ciclo de vida de un anuncio.

Métodos anulables
onAdClicked() Cuando se registra un clic para un anuncio, se invoca el método onAdClicked().
onAdClosed() Se invoca el método onAdClosed() cuando un usuario regresa a la app después de ver una URL de destino de un anuncio. Tu app puede usarla para reanudar actividades suspendidas o cualquier otro trabajo necesario a fin de prepararse para la interacción. Consulta el ejemplo de AdListener de AdMob para ver una implementación de los métodos de escucha de anuncios en la app de demostración de la API de Android.
onAdFailedToLoad() El método onAdFailedToLoad() es el único que incluye un parámetro. El parámetro de error de tipo LoadAdError describe qué error ocurrió. Para obtener más información, consulta la documentación de depuración de errores de carga de anuncios.
onAdImpression() Cuando se registra una impresión para un anuncio, se invoca el método onAdImpression().
onAdLoaded() El método onAdLoaded() se ejecuta cuando termina de cargarse un anuncio. Si deseas retrasar la adición del AdView a tu actividad o fragmento hasta que te asegures de que un anuncio se cargará, por ejemplo, puedes hacerlo aquí.
onAdOpened() Cuando se abre una superposición que cubre la pantalla, se invoca el método onAdOpened().

En la siguiente tabla, se indican los tamaños de banner estándar.

Tamaño en dp (ancho x) Descripción Disponibilidad Constante de AdSize
320 x 50 Banner Teléfonos y tablets BANNER
320 x 100 Banner grande Teléfonos y tablets LARGE_BANNER
300 x 250 Rectángulo mediano de IAB Teléfonos y tablets MEDIUM_RECTANGLE
468 x 60 Banner de tamaño completo de IAB Tablets FULL_BANNER
728 x 90 Tabla de clasificación de IAB Tablets LEADERBOARD
Ancho proporcionado x Altura adaptable Banner adaptable Teléfonos y tablets N/A
Ancho de pantalla x 32|50|90 Banner inteligente Teléfonos y tablets SMART_BANNER
Obtenga más información sobre los banners adaptables, que deben reemplazar a los banners inteligentes.

Para definir un tamaño de banner personalizado, configura tu AdSize deseado, como se muestra a continuación:

Java

AdSize adSize = new AdSize(300, 50);

Kotlin

val adSize = AdSize(300, 50)

Aceleración de hardware para los anuncios de video

Para que los anuncios de video se muestren correctamente en las vistas de anuncios en forma de banner, debes habilitar la aceleración de hardware.

La aceleración de hardware está habilitada de forma predeterminada, pero algunas apps pueden inhabilitarla. Si este es el caso de tu app, te recomendamos que habilites la aceleración de hardware para las clases de actividad que usan anuncios.

Cómo habilitar la aceleración de hardware

Si tu app no se comporta correctamente con la aceleración de hardware activada de manera global, también puedes controlarla en actividades individuales. A fin de habilitar o inhabilitar la aceleración de hardware, puedes usar el atributo android:hardwareAccelerated para los elementos <application> y <activity> en tu AndroidManifest.xml. En el siguiente ejemplo, se habilita la aceleración de hardware para toda la app, pero se la inhabilita para una actividad:

<application android:hardwareAccelerated="true">
    <!-- For activities that use ads, hardwareAcceleration should be true. -->
    <activity android:hardwareAccelerated="true" />
    <!-- For activities that don't use ads, hardwareAcceleration can be false. -->
    <activity android:hardwareAccelerated="false" />
</application>

Consulta la guía de aceleración de HW a fin de obtener más información sobre las opciones para controlar la aceleración de hardware. Ten en cuenta que las vistas de anuncios individuales no pueden habilitarse para la aceleración de hardware si la actividad está inhabilitada, por lo que esta debe tener habilitada la aceleración de hardware.

Recursos adicionales

Ejemplos en GitHub

  • Ejemplo de anuncios de banner: Java | Kotlin

  • Demostración de funciones avanzadas: Java | Kotlin

  • App de ejemplo de banner de RecyclerView: Java

Video instructivo sobre Mobile Ads Garage

Historias de éxito