Pré-carregamento de anúncios (Beta)

Selecione a plataforma: iOS Unity Flutter Android (legada)

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 o desempenho 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:retém 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 este tutorial, configure o Google Mobile Ads Unity Plugin.

Começar a pré-carregar anúncios

Quando o app for iniciado, chame o método Preload uma vez. Depois de chamar o método 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 inicia o pré-carregamento de 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 o método DequeueAd. Google Mobile Ads Unity Plugin recupera um anúncio disponível e pré-carrega automaticamente o próximo anúncio em segundo plano.

Evite chamar o método DequeueAd até que você esteja pronto para mostrar um anúncio. Manter os anúncios no cache permite que o Google Mobile Ads Unity Plugin atualize automaticamente 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 com sucesso, 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 o pré-carregamento 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. Para interromper a pré-carga de 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 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.

// Define a PreloadConfiguration and set the buffer size to 2 preloaded ads.
new PreloadConfiguration
{
    AdUnitId = "AD_UNIT_ID",
    Request = new AdRequest(),
    BufferSize = 2
};

Limites de cache de pré-carga

O Google Mobile Ads Unity Plugin impõe 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 armazena no máximo seis anúncios pré-carregados na memória. Esse limite é compartilhado entre todos os formatos e IDs de pré-carga.
  • Recomendamos manter um tamanho de buffer de dois para cada ID de pré-carga.