En esta guía, te explicamos cómo cargar un anuncio de banner adaptable fijo en una app para Android.
Requisitos previos
- Completar la Guía de introducción
- [Opcional] Seleccionar una de las siguientes apps de ejemplo para ver una implementación de muestra de anuncios de banner:
- Ejemplo de anuncios de banner adaptable fijo en Java, Kotlin o Jetpack Compose
- Demostración de funciones avanzadas en Java o Kotlin
Haz siempre una comprobación con anuncios de prueba
Al compilar y verificar tus apps, asegúrate de usar anuncios de prueba en vez de anuncios activos en fase de producción. De lo contrario, tu cuenta podría suspenderse.
La forma más sencilla de cargar anuncios de prueba es usar nuestro ID de unidad de anuncios de prueba exclusivo para los banners en Android:
ca-app-pub-3940256099942544/9214589741
Está configurado especialmente para devolver anuncios de prueba en cada solicitud, y puedes usarlo en tus propias apps mientras realizas tus actividades de programación, prueba y depuración. Solo asegúrate de reemplazarlo por tu propio ID de unidad de anuncios antes de publicar tu app.
Para obtener más información sobre el funcionamiento de los anuncios de prueba del SDK de anuncios de Google para dispositivos móviles, consulta la sección Habilita los anuncios de prueba.
Define la vista de anuncio
Diseño XML
Agrega una vista a tu archivo de diseño XML para que sirva como contenedor de tu anuncio de banner adaptable fijo:
<!-- Ad view container that fills the width of the screen and adjusts its
height to the content of the ad. -->
<FrameLayout
android:id="@+id/ad_view_container"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_centerInParent="true"
android:layout_alignParentBottom="true" />
Jetpack Compose
Incluye el módulo JetpackComposeDemo/compose-util. Este módulo contiene asistentes para componer el objeto
AdView
y los recursos.Compón una clase
BannerAd
a partir del módulocompose-util
:
// Place the ad view at the bottom of the screen.
Column(modifier = modifier.fillMaxSize(), verticalArrangement = Arrangement.Bottom) {
Box(modifier = modifier.fillMaxWidth()) { BannerAd(adView, modifier) }
}
Establece el tamaño del anuncio
Configura AdSize
en un tipo de banner adaptable fijo con un ancho especificado:
Java
// Request an anchored adaptive banner with a width of 360.
adView.setAdSize(AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, 360));
Kotlin
// Request an anchored adaptive banner with a width of 360.
adView.setAdSize(AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, 360))
Jetpack Compose
// Set the adaptive banner ad size with a given width.
val adSize = AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(LocalContext.current, 360)
adView.setAdSize(adSize)
Agrega AdView
al diseño
Crea una clase AdView
con el tamaño del anuncio para agregarla al diseño de tu app:
Java
// Create a new ad view.
adView = new AdView(this);
adView.setAdUnitId(AD_UNIT_ID);
// Request an anchored adaptive banner with a width of 360.
adView.setAdSize(AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, 360));
// Replace ad container with new ad view.
adContainerView.removeAllViews();
adContainerView.addView(adView);
Kotlin
// Create a new ad view.
val adView = AdView(this)
adView.adUnitId = AD_UNIT_ID
// Request an anchored adaptive banner with a width of 360.
adView.setAdSize(AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, 360))
this.adView = adView
// Replace ad container with new ad view.
binding.adViewContainer.removeAllViews()
binding.adViewContainer.addView(adView)
Jetpack Compose
val adView = remember { AdView(context) }
// Setup and load the adview.
// Set the unique ID for this specific ad unit.
adView.adUnitId = BANNER_AD_UNIT_ID
// Set the adaptive banner ad size with a given width.
val adSize = AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(LocalContext.current, 360)
adView.setAdSize(adSize)
// Place the ad view at the bottom of the screen.
Column(modifier = modifier.fillMaxSize(), verticalArrangement = Arrangement.Bottom) {
Box(modifier = modifier.fillMaxWidth()) { BannerAd(adView, modifier) }
}
Carga un anuncio
Una vez implementada la clase AdView
, el siguiente paso es cargar un anuncio. Para hacerlo, tienes que usar el método loadAd()
en la clase AdView
. Ese método utiliza un parámetro AdRequest
, que contiene información del tiempo de ejecución (como la información de segmentación) sobre una solicitud de anuncio en particular.
Este es un ejemplo sobre cómo cargar un anuncio:
Java
AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder().build();
adView.loadAd(adRequest);
Kotlin
val adRequest = AdRequest.Builder().build()
adView.loadAd(adRequest)
Si la operación se realiza correctamente, tu app estará lista para mostrar anuncios de banner.
Actualiza un anuncio
Si configuraste tu unidad de anuncios para que se actualice, no es necesario que solicites otro anuncio cuando uno no se carga. El SDK de anuncios de Google para dispositivos móviles respeta cualquier frecuencia de actualización que hayas especificado en la IU de AdMob. Si no habilitaste la actualización, envía una nueva solicitud. Para obtener más detalles sobre la actualización de unidades de anuncios (por ejemplo, cómo establecer una frecuencia de actualización), consulta Cómo usar la actualización automática para los anuncios de banner.
Libera los recursos de un anuncio
Si ya terminaste de usar un anuncio de banner, puedes liberar sus recursos.
Para ello, quita el anuncio de la jerarquía de vistas y descarta todas sus referencias:
Java
public void destroyBanner() {
// Remove banner from view hierarchy.
if (adView != null) {
View parentView = (View) adView.getParent();
if (parentView instanceof ViewGroup) {
((ViewGroup) parentView).removeView(adView);
}
// Destroy the banner ad resources.
adView.destroy();
}
// Drop reference to the banner ad.
adView = null;
}
Kotlin
fun destroyBanner() {
// Remove banner from view hierarchy.
val parentView = adView?.parent
if (parentView is ViewGroup) {
parentView.removeView(adView)
}
// Destroy the banner ad resources.
adView?.destroy()
// Drop reference to the banner ad.
adView = null
}
Eventos de anuncios
En el ciclo de vida del anuncio, se pueden escuchar varios eventos, incluidos los de carga, los de impresión y clic en el anuncio, y los de apertura y cierre del anuncio. Se recomienda establecer la devolución de llamada antes de cargar el banner.Java
if (adView != null) {
adView.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(@NonNull 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
adView?.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 del ciclo de vida del anuncio.
Métodos anulables | |
---|---|
onAdClicked() |
Se invoca el método onAdClicked() cuando se registra un clic en un anuncio.
|
onAdClosed() |
Se invoca el método onAdClosed() cuando un usuario regresa a la app después de ver la URL de destino de un anuncio. Tu app puede usarlo para reanudar actividades suspendidas o realizar cualquier otra operación necesaria para prepararse para la interacción.
Consulta el ejemplo de AdListener de AdMob para ver una implementación de los métodos del objeto de escucha de anuncios en la app de demo de la API de Android.
|
onAdFailedToLoad() |
El método onAdFailedToLoad() es el único que incluye un parámetro. El parámetro de error del tipo LoadAdError describe qué error se produjo. Para obtener más información, consulta la documentación de depuración de errores de carga de anuncios.
|
onAdImpression() |
Se invoca el método onAdImpression() cuando se registra una impresión de anuncio.
|
onAdLoaded() |
El método onAdLoaded() se ejecuta cuando un anuncio termina de cargarse. Si deseas retrasar el momento de agregar AdView a tu actividad o fragmento (por ejemplo, hasta que tengas la certeza de que se cargará un anuncio), puedes hacerlo con este método.
|
onAdOpened() |
Se invoca el método onAdOpened() cuando un anuncio abre una superposición que cubre la pantalla.
|
Aceleración de hardware para los anuncios de video
Para que los anuncios de video se muestren correctamente en las vistas de anuncios de banner, la aceleración de hardware tiene que estar habilitada.
La aceleración de hardware está habilitada de forma predeterminada, pero es posible que algunas apps opten por inhabilitarla. Si esto se aplica a tu app, te recomendamos que habilites la aceleración de hardware para las clases Activity
que utilizan anuncios.
Habilita la aceleración de hardware
Si tu app no funciona de manera adecuada con la aceleración de hardware activada a nivel global, también puedes controlarla para actividades individuales. Para habilitar o inhabilitar la aceleración de hardware, puedes usar el atributo android:hardwareAccelerated
para los elementos <application>
y <activity>
en tu archivo AndroidManifest.xml
. En el siguiente ejemplo, se habilita la aceleración de hardware para la app en su totalidad, pero se 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 Aceleración de hardware para obtener más información sobre las opciones que permiten controlar su funcionamiento. Ten en cuenta que las vistas de anuncios individuales no se pueden habilitar para la aceleración de hardware si la actividad está inhabilitada; por lo tanto, la actividad en sí debe tener habilitada la aceleración de hardware.
Próximos pasos
Banners contraíbles
Los anuncios de banner contraíbles se presentan inicialmente como una superposición más grande, con un botón para contraer el anuncio a un tamaño más pequeño. Considera usarlos para optimizar aún más tu rendimiento. Consulta la sección de anuncios de banner contraíbles para obtener más detalles.
Banners adaptables intercalados
Los banners adaptables intercalados son más grandes y altos que los banners adaptables fijos. Tienen una altura variable y pueden llegar a ocupar toda la pantalla del dispositivo en sentido vertical. Para las apps que colocan anuncios de banner en contenido que se puede desplazar, se recomiendan los banners adaptables intercalados en lugar de los anuncios de banner adaptables fijo. Consulta la sección de banners adaptables intercalados para obtener más detalles.