Anuncios nativos

Selecciona la plataforma: Android iOS Flutter Unity

Los anuncios nativos son recursos de anuncios que se presentan a los usuarios a través de componentes de IU nativos de la plataforma. Se muestran con los mismos tipos de vistas que ya utilizas para crear tus diseños y se pueden adaptar al diseño visual de tu app.

Cuando se carga un anuncio nativo, tu app recibe un objeto de anuncio que contiene sus recursos, y la responsabilidad de mostrarlos recae en la app (no en el SDK de anuncios de Google para dispositivos móviles).

En términos generales, la implementación correcta de anuncios nativos consta de dos partes: cargar un anuncio con el SDK y, luego, mostrar el contenido del anuncio en tu app.

En esta página, se muestra cómo usar el SDK para cargar anuncios nativos. Sugerencia: Obtén más información sobre los anuncios nativos en nuestro Manual de anuncios nativos.

También puedes consultar algunas historias de éxito de clientes: caso de éxito 1 y caso de éxito 2.

Requisitos previos

Siempre haz pruebas 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.

La forma más sencilla de cargar anuncios de prueba es usar nuestro ID de unidad de anuncios de prueba exclusivo para los anuncios nativos en Android:

ca-app-pub-3940256099942544/2247696110

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 cómo funcionan los anuncios de prueba del SDK de anuncios de Google para dispositivos móviles, consulta Anuncios de prueba.

Carga anuncios

Los anuncios nativos se cargan con la clase AdLoader, que tiene su propia clase Builder para personalizarla durante la creación. Cuando se agrega objetos de escucha al AdLoader durante su compilación, una app especifica qué tipos de anuncios nativos está lista para recibir. Luego, AdLoader solicita solo esos tipos.

Cómo compilar un AdLoader

En el siguiente código, se muestra cómo compilar un AdLoader que puede cargar anuncios nativos:

Java

// It is recommended to call AdLoader.Builder on a background thread.
new Thread(
        () -> {
          AdLoader adLoader =
              new AdLoader.Builder(context, "AD_UNIT_ID")
                  .forNativeAd(
                      new NativeAd.OnNativeAdLoadedListener() {
                        @Override
                        // The native ad loaded successfully. You can show the ad.
                        public void onNativeAdLoaded(@NonNull NativeAd nativeAd) {}
                      })
                  .withAdListener(
                      new AdListener() {
                        @Override
                        // The native ad load failed. Check the adError message for failure
                        // reasons.
                        public void onAdFailedToLoad(@NonNull LoadAdError adError) {}
                      })
                  // Use the NativeAdOptions.Builder class to specify individual options
                  // settings.
                  .withNativeAdOptions(new NativeAdOptions.Builder().build())
                  .build();
        })
    .start();
NativeAdSnippets.java

Kotlin

// It is recommended to call AdLoader.Builder on a background thread.
CoroutineScope(Dispatchers.IO).launch {
  val adLoader =
    AdLoader.Builder(context, "AD_UNIT_ID")
      .forNativeAd { nativeAd ->
        // The native ad loaded successfully. You can show the ad.
      }
      .withAdListener(
        object : AdListener() {
          override fun onAdFailedToLoad(adError: LoadAdError) {
            // The native ad load failed. Check the adError message for failure reasons.
          }
        }
      )
      // Use the NativeAdOptions.Builder class to specify individual options settings.
      .withNativeAdOptions(NativeAdOptions.Builder().build())
      .build()
}
NativeAdSnippets.kt

Reemplaza AD_UNIT_ID por el ID de tu dispositivo de prueba.

El método forNativeAd() se encarga de preparar el AdLoader para el formato NativeAd. Cuando un anuncio se carga correctamente, se llama al método onNativeAdLoaded() del objeto de escucha.

Configura un AdListener con AdLoader (opcional)

Cuando se crea el AdLoader, la función withAdListener establece un AdListener para el cargador. El método toma un AdListener como su único parámetro, que recibe devoluciones de llamada del AdLoader cuando se producen eventos del ciclo de vida del anuncio:

Java

adLoaderBuilder.withAdListener(
    // Override AdListener callbacks here.
    new AdListener() {});
NativeAdSnippets.java

Kotlin

adLoaderBuilder.withAdListener(
  // Override AdListener callbacks here.
  object : AdListener() {}
)
NativeAdSnippets.kt

Solicitar anuncios

Una vez que termines de compilar un AdLoader, es momento de usarlo para solicitar anuncios. Existen dos métodos disponibles para esto: loadAd() y loadAds().

loadAd()

Este método envía una solicitud para un solo anuncio.

Java

adLoader.loadAd(new AdRequest.Builder().build());
NativeAdSnippets.java

Kotlin

adLoader.loadAd(AdRequest.Builder().build())
NativeAdSnippets.kt

loadAds()

Este método envía una solicitud para varios anuncios (hasta cinco):

Java

// Load three native ads.
adLoader.loadAds(new AdRequest.Builder().build(), 3);
NativeAdSnippets.java

Kotlin

// Load three native ads.
adLoader.loadAds(AdRequest.Builder().build(), 3)
NativeAdSnippets.kt

Ambos métodos toman un objeto AdRequest como primer parámetro. Esta es la misma clase AdRequest que usan los banners y los anuncios intersticiales, y puedes usar métodos de la clase AdRequest para agregar información de segmentación, tal como lo harías con otros formatos de anuncios.

Carga varios anuncios (opcional)

El método loadAds() toma un parámetro adicional: la cantidad de anuncios que el SDK debe intentar cargar para la solicitud. Este número tiene un límite de cinco, y no se garantiza que el SDK devuelva la cantidad exacta de anuncios solicitados.

Todos los anuncios de Google que se devuelvan serán diferentes entre sí, aunque no se garantiza que los anuncios del inventario reservado o de los compradores externos sean únicos.

No uses el método loadAds() si utilizas la mediación, ya que las solicitudes de varios anuncios nativos no funcionan para los IDs de bloques de anuncios que se configuraron para la mediación.

Devoluciones de llamada

Después de una llamada a loadAd(), se realiza una sola devolución de llamada a los métodos de escucha definidos anteriormente para entregar el objeto del anuncio nativo o informar un error.

Después de una llamada a loadAds(), se realizan varias devoluciones de llamada de este tipo (al menos una y no más que la cantidad de anuncios solicitados). Las apps que solicitan varios anuncios deben llamar a AdLoader.isLoading() en sus implementaciones de devolución de llamada para determinar si finalizó el proceso de carga.

A continuación, se incluye un ejemplo que muestra cómo verificar isLoading() en la devolución de llamada onNativeAdLoaded():

Java

adLoaderBuilder
    .forNativeAd(
        nativeAd -> {
          // This callback is invoked when a native ad is successfully loaded.
        })
    .build();
NativeAdSnippets.java

Kotlin

adLoaderBuilder
  .forNativeAd { nativeAd ->
    // This callback is invoked when a native ad is successfully loaded.
  }
  .build()
NativeAdSnippets.kt

Liberar recursos

Asegúrate de usar el método destroy() en los anuncios nativos cargados. Esto libera los recursos utilizados y evita las fugas de memoria.

Verifica que todas las referencias a NativeAd se destruyan en el método onDestroy() de tu actividad.

En tu devolución de llamada onNativeAdLoaded, asegúrate de destruir los anuncios nativos existentes a los que se anulará la referencia.

Otra verificación clave es si la actividad se destruye y, de ser así, llama a destroy() en el anuncio devuelto y regresa de inmediato:

Java

nativeAd.destroy();
NativeAdSnippets.java

Kotlin

nativeAd.destroy()
NativeAdSnippets.kt

Prácticas recomendadas

Sigue estas reglas cuando cargues anuncios.

  • Las apps que usan anuncios nativos en una lista deben almacenar en caché previamente la lista de anuncios.

  • Cuando realices la precarga de anuncios, borra la caché y vuelve a cargarla después de una hora.

  • No llames a loadAd() ni a loadAds() en un AdLoader hasta que finalice la carga de la primera solicitud.

  • Limita el almacenamiento en caché de anuncios nativos solo a lo que sea necesario. Por ejemplo, cuando se realiza el almacenamiento previo en caché, solo se almacenan en caché los anuncios que son visibles de inmediato en la pantalla. Los anuncios nativos tienen una gran huella de memoria, y almacenarlos en caché sin destruirlos genera un uso excesivo de la memoria.

  • Destruye los anuncios nativos cuando ya no los uses.

Aceleración de hardware para anuncios de video

Para que los anuncios de video se muestren correctamente en las vistas de tus anuncios nativos, debe estar habilitada la aceleración por hardware.

La aceleración de hardware está habilitada de forma predeterminada, pero algunas apps pueden inhabilitarla. Si esto se aplica a tu app, te recomendamos que habilites la aceleración por hardware para las clases de Activity que usan anuncios.

Cómo habilitar la aceleración de hardware

Si tu app no se comporta de manera adecuada con la aceleración de hardware activada globalmente, también puedes controlarla en actividades individuales. Para habilitar o inhabilitar la aceleración de hardware, usa 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 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>

HardwareAccelerationSnippet.xml

Consulta la guía de aceleración por hardware para obtener más información sobre las opciones para controlar la aceleración por hardware. 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 que la actividad en sí debe tener habilitada la aceleración de hardware.

Mostrar tu anuncio

Una vez que hayas cargado un anuncio, solo te quedará mostrarlo a tus usuarios. Visita nuestra guía avanzada sobre anuncios nativos para saber cómo hacerlo.