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 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 otimiza a ordem do cache para oferecer 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 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, Google Mobile Ads Unity 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:

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 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é estar pronto para mostrar um anúncio. Manter os anúncios no cache permite que Google Mobile Ads Unity 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:

// 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");

Detectar 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, 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.

// 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é-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 para cada ID de pré-carregamento.