Pré-carregamento de anúncios (Alfa)

Selecione a plataforma: Android (Beta) Novo Android iOS Unity

O pré-carregamento de anúncios é um recurso de carregamento de anúncios gerenciado pelo Google no 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 de gerenciar o carregamento. 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 Unity 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 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.
  • Repetições gerenciadas:repete automaticamente solicitações com falha usando espera exponencial.
  • Processamento de expiração:atualiza automaticamente os anúncios antes que eles expirem (normalmente após uma hora).
  • Otimização de cache:se você usar um tamanho de cache maior que um, o Google Mobile Ads Unity Plugin otimizará a ordem do cache para veicular o melhor anúncio.

Este guia explica como configurar anúncios de pré-carregamento, verificar a disponibilidade deles e mostrar o anúncio pré-carregado.

Pré-requisitos

Antes de continuar com o tutorial, conclua 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 no início do app. Depois de chamar Preload(), o Google Mobile Ads Unity Plugin faz o pré-carregamento automático de anúncios e tenta novamente as solicitações com falha para configurações pré-carregadas.

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 armazena anúncios 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.

Evite chamar esse método até que esteja tudo pronto para mostrar um anúncio. Manter os anúncios no cache permite que o Google Mobile Ads Unity 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:

// 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:

Receber a disponibilidade de anúncios pré-carregados

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

var isAdAvailable = InterstitialAdPreloader.IsAdAvailable(AD_UNIT_ID);

Detectar a disponibilidade de anúncios pré-carregados

Registre-se para receber notificações 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. Dentro dos callbacks de eventos de pré-carregamento:

  • Não chame o Preload().
  • Evite chamar DequeueAd(), a menos que o anúncio seja mostrado imediatamente.

O exemplo a seguir registra eventos de anúncio:


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.
}

Interromper a pré-carga de anúncios

Se você não precisar mostrar anúncios para um ID de pré-carga novamente na sessão, pare de pré-carregar anúncios. Para interromper o pré-carregamento de anúncios para um ID de pré-carregamento específico, chame Destroy() com um ID de pré-carregamento.

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 da veiculação de anúncios. Se o app mostrar anúncios antes do carregamento do próximo, defina um tamanho de buffer personalizado para aumentar o número de anúncios mantidos na memória. Recomendamos um tamanho de buffer de no máximo quatro.

new PreloadConfiguration
{
    AdUnitId = AD_UNIT_ID,
    Request = new AdRequest(),
    BufferSize = 5
};