Precarga de anuncios (beta)

La precarga de anuncios es una función de carga de anuncios administrada por Google en Google Mobile Ads Flutter Plugin que se encarga de cargar y almacenar en caché los anuncios en tu nombre. La precarga de anuncios requiere un cambio en la forma en que administras la carga de anuncios. Para optimizar el rendimiento con la precarga de anuncios, inhabilita el almacenamiento en caché personalizado y delega esa responsabilidad a Google Mobile Ads Flutter Plugin.

La precarga de anuncios ofrece los siguientes beneficios en comparación con la carga manual de anuncios:

  • Administración de referencias: Conserva los anuncios cargados para que no tengas que mantener las referencias hasta que tengas todo listo para mostrarlos.
  • Recarga automática: Carga automáticamente un anuncio nuevo cuando extraes uno de la caché.
  • Reintentos administrados: Reintenta automáticamente las solicitudes con errores con la retirada exponencial.
  • Administración de vencimientos: Actualiza automáticamente los anuncios antes de que venzan (por lo general, después de una hora).
  • Optimización de la caché: Si usas un tamaño de caché superior a uno, Google Mobile Ads Flutter Plugin optimiza el orden de la caché para publicar el mejor anuncio.

Esta guía abarca cómo configurar los anuncios para la precarga, verificar su disponibilidad y mostrar los anuncios precargados.

Requisitos previos

Antes de continuar con este instructivo, debes configurar Google Mobile Ads Flutter Plugin.

Empieza a precargar los anuncios

Cuando se inicie la app, llama al método start una vez. Después de llamar al método start, Google Mobile Ads Flutter Plugin precarga automáticamente los anuncios y reintenta las solicitudes fallidas para las configuraciones precargadas.

En el siguiente ejemplo, se inicia la precarga de anuncios:

InterstitialAdPreloader.start(
  preloadId: _adUnitId,
  preloadConfiguration: PreloadConfiguration(adUnitId: _adUnitId),
  callback: const PreloadCallback(),
);

Reemplaza _adUnitId por tu ID de unidad de anuncios.

Obtén y muestra los anuncios precargados

Cuando se usa la precarga de anuncios, Google Mobile Ads Flutter Plugin conserva los anuncios almacenados en caché. Cuando quieras mostrar un anuncio, llama al método pollAd. Google Mobile Ads Flutter Plugin recupera un anuncio disponible y precarga automáticamente el siguiente anuncio en segundo plano.

Evita llamar al método pollAd hasta que todo esté listo para mostrar un anuncio. Mantener los anuncios en la caché permite que Google Mobile Ads Flutter Plugin actualice automáticamente los anuncios vencidos y realice la optimización de la caché.

En el siguiente ejemplo, se recupera y muestra un anuncio precargado:

void _pollAndShowAd() async {
  final InterstitialAd? ad = await InterstitialAdPreloader.pollAd(_adUnitId);
  if (ad != null) {
    _interstitialAd = ad;
    ad.fullScreenContentCallback = FullScreenContentCallback(
      onAdImpression: (ad) {
        // Called when an impression occurs on the ad.
        debugPrint('Ad recorded an impression.');
      },
    );
    ad.onPaidEvent = (ad, valueMicros, precision, currencyCode) {
      // Called when an ad is estimated to have earned money.
      debugPrint('Ad paid: $valueMicros $currencyCode.');
    };
    // Show the ad.
    await ad.show();
  }
}

Verifica la disponibilidad de anuncios precargados

Para verificar la disponibilidad de anuncios, elige una de las siguientes opciones:

Obtén la disponibilidad de anuncios precargados

En el siguiente ejemplo, se verifica la disponibilidad de anuncios:

void _checkAdAvailability() async {
  final bool isAvailable = await InterstitialAdPreloader.isAdAvailable(
    _adUnitId,
  );
  debugPrint('Is ad available: $isAvailable');
}

Escucha la disponibilidad de anuncios precargados

Regístrate para recibir eventos de precarga y recibir notificaciones cuando los anuncios se precarguen correctamente, no se precarguen o se agote la caché de anuncios.

Los eventos de precarga se usan con fines de análisis. Dentro de las devoluciones de llamada de eventos de precarga:

  • No llames a start.
  • Evita llamar a pollAd, a menos que el anuncio se muestre de inmediato.

En el siguiente ejemplo, se registran los eventos de anuncios:

InterstitialAdPreloader.start(
  preloadId: _adUnitId,
  preloadConfiguration: PreloadConfiguration(adUnitId: _adUnitId),
  callback: PreloadCallback(
    onAdPreloaded: (preloadId, responseInfo) {
      debugPrint('Ad preloaded for ID: $preloadId');
    },
    onAdFailedToPreload: (preloadId, error) {
      debugPrint('Ad failed to preload for ID: $preloadId. Error: $error');
    },
    onAdsExhausted: (preloadId) {
      debugPrint('All preloaded ads exhausted for ID: $preloadId');
    },
  ),
);

Detén la precarga de los anuncios

Si no necesitas volver a mostrar anuncios para un ID de carga previa en la sesión, puedes detener la carga previa de anuncios. Para detener la precarga de anuncios para un ID de precarga específico, llama a destroy con un ID de precarga. Para detener la precarga de todos los precargadores, llama a destroyAll.

void _stopPreloading() async {
  await InterstitialAdPreloader.destroy(_adUnitId);
}

Establece el tamaño del búfer

El tamaño del búfer controla la cantidad de anuncios precargados que se almacenan en la memoria. De forma predeterminada, Google optimiza el tamaño del búfer para equilibrar el consumo de memoria y la latencia de publicación de anuncios. Si tu app muestra anuncios antes de que se cargue el siguiente, puedes establecer un tamaño de búfer personalizado para aumentar la cantidad de anuncios que se conservan en la memoria.

InterstitialAdPreloader.start(
  preloadId: _adUnitId,
  preloadConfiguration: PreloadConfiguration(
    adUnitId: _adUnitId,
    bufferSize: 3,
  ),
  callback: const PreloadCallback(),
);

Límites de la caché de precarga

Google Mobile Ads Flutter Plugin aplica un límite para toda la app en la cantidad total de anuncios precargados en todas las unidades de anuncios y los IDs de precarga:

  • Límite predeterminado: Google Mobile Ads Flutter Plugin contiene un máximo de 6 anuncios precargados en la memoria. Este límite se comparte entre todos los formatos y los IDs de precarga.
  • Te recomendamos que mantengas un tamaño de búfer de dos para cada ID de carga previa.