Pré-carregamento de anúncios (Beta)

O pré-carregamento de anúncios é um recurso de carregamento de anúncios gerenciado pelo Google no Google Mobile Ads Flutter Plugin que gerencia o carregamento e o armazenamento em cache de anúncios em seu nome. O pré-carregamento de anúncios exige uma mudança na forma como você gerencia o carregamento de anúncios. Para otimizar a performance usando o pré-carregamento de anúncios, desative o armazenamento em cache personalizado e delegue essa responsabilidade ao Google Mobile Ads Flutter Plugin.

O pré-carregamento de anúncios oferece os seguintes benefícios em relação ao carregamento manual:

  • Gerenciamento de referências:mantém os anúncios carregados para que você não precise manter as referências até que esteja tudo pronto para mostrá-los.
  • Recarga automática:carrega automaticamente um novo anúncio quando você retira um do cache.
  • Novas tentativas gerenciadas:repete automaticamente as solicitações com falha usando a espera exponencial.
  • Processamento de expiração:atualiza automaticamente os anúncios antes que eles expirem (geralmente após uma hora).
  • Otimização de cache:se você usar um tamanho de cache maior que um, o Google Mobile Ads Flutter Plugin vai otimizar a ordem do cache para veicular o melhor anúncio.

Neste guia, explicamos como configurar anúncios pré-carregados, verificar a disponibilidade deles e mostrar o anúncio pré-carregado.

Pré-requisitos

Antes de prosseguir com este tutorial, configure o Google Mobile Ads Flutter Plugin.

Começar a pré-carregar anúncios

Quando o app for iniciado, chame o método start uma vez. Depois de chamar o método start, o Google Mobile Ads Flutter Plugin pré-carrega automaticamente os anúncios e tenta novamente as solicitações com falha para configurações pré-carregadas.

O exemplo a seguir inicia o pré-carregamento de anúncios:

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

Substitua _adUnitId pelo ID do seu bloco de anúncios.

Receber e mostrar o anúncio pré-carregado

Ao usar o pré-carregamento de anúncios, o Google Mobile Ads Flutter Plugin armazena anúncios em cache. Quando quiser mostrar um anúncio, chame o método pollAd. Google Mobile Ads Flutter Plugin recupera um anúncio disponível e pré-carrega automaticamente o próximo anúncio em segundo plano.

Evite chamar o método pollAd até que esteja tudo pronto para mostrar um anúncio. Manter os anúncios no cache permite que o Google Mobile Ads Flutter Plugin atualize automaticamente os anúncios expirados e faça a otimização do cache.

O exemplo a seguir recupera e mostra um anúncio pré-carregado:

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();
  }
}

Verificar a disponibilidade de anúncios pré-carregados

Para verificar a disponibilidade de anúncios, escolha uma das seguintes opções:

Receber a disponibilidade de anúncios pré-carregados

O exemplo a seguir verifica a disponibilidade de anúncios:

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

Detectar a disponibilidade de anúncios pré-carregados

Registre-se para receber notificações de eventos de pré-carregamento quando os anúncios forem pré-carregados, não forem pré-carregados ou o cache de anúncios estiver esgotado.

Os eventos de pré-carregamento são destinados a fins de análise. Nos callbacks de eventos de pré-carregamento:

  • Não chame o start.
  • Evite chamar pollAd, a menos que o anúncio seja mostrado imediatamente.

O exemplo a seguir registra eventos de anúncio:

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');
    },
  ),
);

Interromper o pré-carregamento de anúncios

Se você não precisar mostrar anúncios para um ID de pré-carregamento novamente na sessão, interrompa o pré-carregamento de anúncios. Para interromper o pré-carregamento de anúncios de um ID específico, chame destroy com um ID de pré-carregamento. Para interromper o pré-carregamento de todos os pré-carregadores, chame destroyAll.

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

Definir o tamanho do buffer

O tamanho do buffer controla o número de anúncios pré-carregados mantidos na memória. Por padrão, o Google otimiza o tamanho do buffer para equilibrar o consumo de memória e a latência de veiculação de anúncios. Se o app mostrar anúncios de display antes que o próximo seja carregado, defina um tamanho do buffer personalizado para aumentar o número de anúncios mantidos na memória.

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

Limites de cache de pré-carregamento

O Google Mobile Ads Flutter Plugin aplica um limite em todo o app para o número total de anúncios pré-carregados em todos os blocos de anúncios e IDs de pré-carregamento:

  • Limite padrão: o Google Mobile Ads Flutter Plugin armazena no máximo seis anúncios pré-carregados na memória. Esse limite é compartilhado entre todos os formatos e IDs de pré-carregamento.
  • Recomendamos manter um tamanho de buffer de dois para cada ID de pré-carregamento.