Pré-carregamento de anúncios (Alfa)

Selecionar plataforma: Android Novo Android iOS Unity

O pré-carregamento de anúncios é um recurso gerenciado pelo Google em Google Mobile Ads Unity 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 Unity 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 Unity Plugin otimizará 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 o tutorial, você precisa concluir os seguintes itens:

Começar a pré-carregar anúncios

Para começar a pré-carregar anúncios, chame Preload(). Chame esse método apenas uma vez por ID de pré-carregamento. Recomendamos que você chame o método quando a sessão do app começar. Depois de chamar Preload(), Google Mobile Ads Unity Plugin pré-carrega anúncios automaticamente e tenta novamente as solicitações com falha para esses IDs de pré-carregamento.

O exemplo a seguir começa a pré-carregar anúncios:

var preloadConfiguration = new PreloadConfiguration
{
    AdUnitId = AD_UNIT_ID,
    Request = new AdRequest(),
};

// Start the preloading initialization process after MobileAds.Initialize().
InterstitialAdPreloader.Preload(
    // The Preload ID can be any unique string to identify this configuration.
    AD_UNIT_ID,
    preloadConfiguration);

Receber e mostrar o anúncio pré-carregado

Ao usar o pré-carregamento de anúncios, Google Mobile Ads Unity Plugin mantém os anúncios armazenados em cache. Quando quiser mostrar um anúncio, chame DequeueAd(). Google Mobile Ads Unity Plugin recupera o anúncio disponível e pré-carrega automaticamente o próximo anúncio em segundo plano.

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

// DequeueAd returns the next available ad and loads another ad in the background.
var ad = InterstitialAdPreloader.DequeueAd(AD_UNIT_ID);

if (ad != null)
{
    // [Optional] Interact with the ad object as needed.
    ad.OnAdPaid += (AdValue value) =>
    {
        Debug.Log($"Ad paid: {value.CurrencyCode} {value.Value}");
        // [Optional] Send the impression-level ad revenue information to your preferred
        // analytics server directly within this callback.
    };

    // Do not hold onto preloaded ads, always show a preloaded ad immediately.
    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:

var isAdAvailable = InterstitialAdPreloader.IsAdAvailable(AD_UNIT_ID);

Ouvir a disponibilidade de anúncios pré-carregados

Registre-se para eventos de pré-carregamento para receber notificações quando os anúncios forem pré-carregados com sucesso, falharem ao pré-carregar 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 Preload().
  • Evite chamar DequeueAd() a menos que o anúncio seja mostrado imediatamente.

O exemplo a seguir registra eventos de anúncios:


void StartPreloadWithCallbacks()
{
    var preloadConfiguration = new PreloadConfiguration
    {
        AdUnitId = AD_UNIT_ID,
        Request = new AdRequest(),
    };

    // Start the preloading initialization process after MobileAds.Initialize().
    InterstitialAdPreloader.Preload(
        // The Preload ID can be any unique string to identify this configuration.
        AD_UNIT_ID,
        preloadConfiguration,
        onAdPreloaded,
        onAdFailedToPreload,
        onAdsExhausted);
}

void onAdPreloaded(string preloadId, ResponseInfo responseInfo)
{
    Debug.Log($"Preload ad configuration {preloadId} was preloaded.");
}

void onAdFailedToPreload(string preloadId, AdError adError)
{
    string errorMessage = $"Preload ad configuration {preloadId} failed to " +
                          $"preload with error : {adError.GetMessage()}.";
    Debug.Log(errorMessage);
}

void onAdsExhausted(string preloadId)
{
    Debug.Log($"Preload ad configuration {preloadId} was exhausted");
    // [Important] Don't call Preload() or DequeueAd() from onAdsExhausted.
}

Parar de pré-carregar anúncios

Se você não precisar mostrar anúncios para um ID de pré-carregamento novamente na sessão, poderá parar de pré-carregar anúncios. Para parar de pré-carregar anúncios para um ID de pré-carregamento específico, chame Destroy() com um ID de pré-carregamento. Para parar de pré-carregar todos os pré-carregadores, chame DestroyAll().

InterstitialAdPreloader.Destroy(AD_UNIT_ID);
InterstitialAdPreloader.DestroyAll();

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. Recomendamos um tamanho de buffer de dois ou três.

Limites de cache de pré-carregamento

Google Mobile Ads Unity 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 Unity 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 ou três por ID de pré-carregamento.
new PreloadConfiguration
{
    AdUnitId = AD_UNIT_ID,
    Request = new AdRequest(),
    BufferSize = 5
};