Pré-carregamento de anúncios (Beta)

Selecionar plataforma: iOS Unity Flutter Android (legado)

O pré-carregamento de anúncios é um recurso de carregamento de anúncios gerenciado pelo Google em 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 a Google Mobile Ads Flutter Plugin.

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

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

Este guia aborda a configuração de anúncios de pré-carregamento, a verificação da disponibilidade de anúncios de pré-carregamento e a exibição do anúncio pré-carregado.

Pré-requisitos

Antes de continuar com este tutorial, você deve configurar 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, Google Mobile Ads Flutter Plugin pré-carrega anúncios automaticamente e tenta novamente as solicitações com falha para configurações pré-carregadas.

O exemplo a seguir começa a pré-carregar 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, Google Mobile Ads Flutter Plugin mantém os anúncios armazenados 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 anúncios no cache permite que Google Mobile Ads Flutter Plugin atualize automaticamente anúncios expirados e execute 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 de pré-carregamento

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

Verificar 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 eventos de pré-carregamento para ser notificado 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. Nas funções de callback de eventos de pré-carregamento:

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

O exemplo a seguir registra eventos de anúncios:

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 a pré-carga de anúncios

Se você não precisar mostrar anúncios para um ID de pré-carregamento novamente na sessão, poderá interromper a pré-carga de anúncios. Para interromper a pré-carga de anúncios para um ID de pré-carregamento específico, chame destroy com um ID de pré-carregamento. Para interromper a pré-carga 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 antes que o próximo anúncio seja carregado, você poderá definir um tamanho de 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

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: Google Mobile Ads Flutter Plugin mantém um máximo de seis anúncios pré-carregados na memória. Esse limite é compartilhado em todos os formatos e IDs de pré-carregamento.
  • Recomendamos manter um tamanho de buffer de dois para cada ID de pré-carregamento.