InterstitialAdPreloader

public final class InterstitialAdPreloader


O pré-carregador de anúncios intersticiais.

Resumo

Métodos públicos

static boolean
destroy(String preloadId)

Interrompe o pré-carregamento do preloadId especificado e destrói todos os anúncios pré-carregados associados.

static void

Interrompe o pré-carregamento e destrói os anúncios pré-carregados para todas as configurações de pré-carregamento.

static @Nullable PreloadConfiguration

Esse método foi descontinuado.

Nenhuma substituição.

static Map<StringPreloadConfiguration>

Esse método foi descontinuado.

Nenhuma substituição.

static int

Retorna o número de anúncios disponíveis para o ID de pré-carga especificado.

static boolean
isAdAvailable(String preloadId)

Determina se pelo menos um anúncio está disponível para o preloadId especificado.

static @Nullable InterstitialAd
pollAd(String preloadId)

Retorna um anúncio pré-carregado de start ou start e o remove do cache.

static boolean
start(String preloadId, PreloadConfiguration preloadConfiguration)

Começa a pré-carregar anúncios para os preloadId e PreloadConfiguration especificados.

static boolean
start(
    String preloadId,
    PreloadConfiguration preloadConfiguration,
    PreloadCallbackV2 preloadCallback
)

Começa a pré-carregar anúncios para o preloadId, PreloadConfiguration e .

Métodos públicos

destruir

public static boolean destroy(String preloadId)

Interrompe o pré-carregamento do preloadId especificado e destrói todos os anúncios pré-carregados associados.

Parâmetros
String preloadId

O ID de pré-carregamento da configuração a ser destruída.

Retorna
boolean

true se uma configuração de pré-carga ativa foi destruída. Retorna false se não houver uma configuração de pré-carregamento ativa para o preloadId especificado.

destroyAll

public static void destroyAll()

Interrompe o pré-carregamento e destrói os anúncios pré-carregados para todas as configurações de pré-carregamento.

getConfiguration

public static @Nullable PreloadConfiguration getConfiguration(String preloadId)

Retorna o anúncio intersticial PreloadConfiguration associado a este preloadId ou nulo se não houver um.

Parâmetros
String preloadId

O ID de pré-carga vinculado a essa configuração.

Retorna
@Nullable PreloadConfiguration

O PreloadConfiguration do ID de pré-carga especificado ou null se não houver uma configuração para o ID de pré-carga especificado.

getConfigurations

public static Map<StringPreloadConfigurationgetConfigurations()

Retorna um mapa de todos os anúncios intersticiais PreloadConfigurations, com chave pelo ID de pré-carga associado.

Retorna
Map<StringPreloadConfiguration>

As configurações de anúncios intersticiais ou um mapa vazio se não houver pré-carregadores.

getNumAdsAvailable

public static int getNumAdsAvailable(String preloadId)

Retorna o número de anúncios disponíveis para o ID de pré-carga especificado.

Parâmetros
String preloadId

O ID de pré-carga para verificar a disponibilidade.

Retorna
int

O número de anúncios disponíveis para o ID de pré-carga especificado.

isAdAvailable

public static boolean isAdAvailable(String preloadId)

Determina se pelo menos um anúncio está disponível para o preloadId especificado.

Parâmetros
String preloadId

O ID de pré-carga para verificar a disponibilidade.

Retorna
boolean

true se houver um anúncio disponível para o ID de pré-carga especificado. Caso contrário, false.

pollAd

public static @Nullable InterstitialAd pollAd(String preloadId)

Retorna um anúncio pré-carregado de start ou start e o remove do cache.

Esse pode ser qualquer um dos anúncios pré-carregados para preloadId. A ordem retornada não corresponde necessariamente à ordem dos eventos onAdPreloaded.

Parâmetros
String preloadId

O ID de pré-carga do anúncio.

Retorna
@Nullable InterstitialAd

Um anúncio intersticial para o ID de pré-carregamento especificado ou null se nenhum anúncio estiver disponível.

start

public static boolean start(String preloadId, PreloadConfiguration preloadConfiguration)

Começa a pré-carregar anúncios para os preloadId e PreloadConfiguration especificados.

O SDK continua pré-carregando anúncios até atingir o número especificado por getBufferSize, tentando manter o buffer cheio durante toda a sessão.

Se um PreloadConfiguration já tiver sido iniciado com preloadId, esse método se tornará uma operação nula e retornará false.

Parâmetros
String preloadId

Um identificador de string para este PreloadConfiguration. Use esse identificador ao chamar pollAd para receber um anúncio para essa configuração.

PreloadConfiguration preloadConfiguration

A configuração para pré-carregar anúncios.

Retorna
boolean

true se o pré-carregamento foi iniciado, false se o preloadId estiver em uso.

start

public static boolean start(
    String preloadId,
    PreloadConfiguration preloadConfiguration,
    PreloadCallbackV2 preloadCallback
)

Começa a pré-carregar anúncios para o preloadId, PreloadConfiguration e .

O SDK continua pré-carregando anúncios até atingir o número especificado por getBufferSize, tentando manter o buffer cheio durante toda a sessão.

Para cada solicitação de anúncio, o SDK aciona um callback onAdPreloaded quando o pré-carregamento é bem-sucedido ou um callback onAdFailedToPreload se o pré-carregamento falhar. O SDK repete automaticamente as solicitações com falha.

Se um PreloadConfiguration já tiver sido iniciado com o preloadId especificado, esse método não fará nada e vai retornar false. se torna uma operação nula e retorna false.

Parâmetros
String preloadId

Uma string que identifica de forma exclusiva este PreloadConfiguration. Use esse identificador ao chamar pollAd para recuperar um anúncio pré-carregado para essa configuração.

PreloadConfiguration preloadConfiguration

A configuração que determina como os anúncios são pré-carregados.

PreloadCallbackV2 preloadCallback

Um callback a ser invocado quando a disponibilidade de anúncios mudar para o PreloadConfiguration especificado.

Retorna
boolean

true se o pré-carregamento foi iniciado, false se o preloadId estiver em uso.