MobileAds

class MobileAds


A classe contém uma lógica que se aplica ao SDK dos anúncios para dispositivos móveis do Google como um todo. No momento, os únicos métodos são usados para inicialização.

Resumo

Constantes

const String!
ERROR_DOMAIN = "com.google.android.gms.ads"

Nome de domínio de erro padrão para o SDK dos anúncios para dispositivos móveis do Google.

Funções públicas

java-static Unit

Chame antes de initialize ou da primeira solicitação de anúncio para desativar a inicialização do adaptador de mediação.

java-static InitializationStatus?

Recebe o status de inicialização do SDK.

java-static RequestConfiguration

Recebe o RequestConfiguration global.

java-static VersionInfo!

Recebe a versão externa (por exemplo, 20.6.0) do SDK dos anúncios para dispositivos móveis do Google.

java-static Unit
@RequiresPermission(value = Manifest.permission.INTERNET)
initialize(context: Context!)

Inicializa o SDK dos anúncios para dispositivos móveis do Google.

java-static Unit

Inicializa o SDK dos anúncios para dispositivos móveis do Google.

java-static Unit

Abre a interface do Ad Inspector.

java-static Unit
openDebugMenu(context: Context!, adUnitId: String!)

Abre o menu de depuração.

java-static Boolean

Controla se o ID próprio do editor do SDK dos anúncios para dispositivos móveis do Google, anteriormente conhecido como mesma chave de app, está ativado.

java-static CustomTabsSession?
registerCustomTabsSession(
    context: Context,
    client: CustomTabsClient,
    origin: String,
    callback: CustomTabsCallback?
)

Registra um CustomTabsClient com o SDK dos anúncios para dispositivos móveis do Google para melhorar a monetização de anúncios no app dentro desse CustomTabsSession.

java-static Unit

Registra um WebView com o SDK dos anúncios para dispositivos móveis do Google para melhorar a monetização de anúncios no app dentro desse WebView.

java-static Unit

Indica se o áudio do aplicativo está desativado.

java-static Unit

Define o volume do áudio do aplicativo.

java-static Unit

Define o RequestConfiguration global que será usado para cada AdRequest durante a sessão do app.

java-static Unit
startPreload(
    context: Context,
    preloadConfigurations: (Mutable)List<PreloadConfiguration!>,
    preloadCallback: PreloadCallback
)

Essa função foi descontinuada.

Use "start" ou "starto".

Constantes

ERROR_DOMAIN

const val ERROR_DOMAIN = "com.google.android.gms.ads": String!

Nome de domínio de erro padrão para o SDK dos anúncios para dispositivos móveis do Google.

Funções públicas

disableMediationAdapterInitialization

java-static fun disableMediationAdapterInitialization(context: Context!): Unit

Chame antes de initialize ou da primeira solicitação de anúncio para desativar a inicialização do adaptador de mediação. Esse método é um noop quando initialize ou a primeira solicitação de anúncio é feita.

Aviso: chamar esse método pode afetar negativamente a performance da mediação. Esse método só precisa ser chamado se você incluir adaptadores de mediação no app, mas não planeja usar a mediação do Google durante essa sessão do app (por exemplo, se estiver executando um teste A/B).

getInitializationStatus

java-static fun getInitializationStatus(): InitializationStatus?

Recebe o status de inicialização do SDK.

getRequestConfiguration

java-static fun getRequestConfiguration(): RequestConfiguration

Recebe o RequestConfiguration global.

getVersion

java-static fun getVersion(): VersionInfo!

Recebe a versão externa (por exemplo, 20.6.0) do SDK dos anúncios para dispositivos móveis do Google.

initialize não precisa ser chamado antes dessa função.

initialize

@RequiresPermission(value = Manifest.permission.INTERNET)
java-static fun initialize(context: Context!): Unit

Inicializa o SDK dos anúncios para dispositivos móveis do Google.

Chame esse método o mais cedo possível após o lançamento do app para reduzir a latência na primeira solicitação de anúncio da sessão.

Se esse método não for chamado, a primeira solicitação de anúncio vai inicializar automaticamente o SDK dos anúncios para dispositivos móveis do Google.

Parâmetros
context: Context!

O Context em que o SDK está sendo executado.

initialize

java-static fun initialize(context: Context!, listener: OnInitializationCompleteListener!): Unit

Inicializa o SDK dos anúncios para dispositivos móveis do Google.

Chame esse método o mais cedo possível após o lançamento do app para reduzir a latência na primeira solicitação de anúncio da sessão.

Se esse método não for chamado, a primeira solicitação de anúncio vai inicializar automaticamente o SDK dos anúncios para dispositivos móveis do Google.

Parâmetros
context: Context!

A atividade Context em que o SDK está sendo executado.

listener: OnInitializationCompleteListener!

Um callback que será invocado após a conclusão da inicialização.

openAdInspector

java-static fun openAdInspector(context: Context!, listener: OnAdInspectorClosedListener!): Unit

Abre a interface do Ad Inspector.

openDebugMenu

java-static fun openDebugMenu(context: Context!, adUnitId: String!): Unit

Abre o menu de depuração. initialize precisa ser chamado antes dessa função.

Parâmetros
context: Context!

A atividade Context em que o SDK está sendo executado.

adUnitId: String!

Qualquer ID de bloco de anúncios do Ad Manager associado ao seu app.

putPublisherFirstPartyIdEnabled

java-static fun putPublisherFirstPartyIdEnabled(enabled: Boolean): Boolean

Controla se o ID próprio do editor do SDK dos anúncios para dispositivos móveis do Google, anteriormente conhecido como mesma chave de app, está ativado.

O ID é ativado por padrão. Quando desativada, a configuração é mantida nas sessões do app e o ID é limpo.

initialize precisa ser chamado antes dessa função.

Parâmetros
enabled: Boolean

Booleano verdadeiro se o ID próprio do publisher estiver ativado. Caso contrário, será falso.

Retorna
Boolean

Verdadeiro se a decisão for mantida. Falso se não for possível manter.

registerCustomTabsSession

java-static fun registerCustomTabsSession(
    context: Context,
    client: CustomTabsClient,
    origin: String,
    callback: CustomTabsCallback?
): CustomTabsSession?

Registra um CustomTabsClient com o SDK dos anúncios para dispositivos móveis do Google para melhorar a monetização de anúncios no app dentro desse CustomTabsSession. Isso vai criar apenas uma instância de CustomTabsSession, e a reexecução vai substituir a sessão atual.

Parâmetros
context: Context

O Context em que o SDK está sendo executado.

client: CustomTabsClient

CustomTabsClient usado para criar a instância CustomTabsSession.

origin: String

String usada como origem no Digital Asset Link para verificação.

callback: CustomTabsCallback?

CustomTabsCallback opcional para receber callbacks de .

Retorna
CustomTabsSession?

Uma instância CustomTabsSession para ser usada na intent de guias personalizadas ao abrir uma página de guias personalizadas.

registerWebView

java-static fun registerWebView(webview: WebView): Unit

Registra um WebView com o SDK dos anúncios para dispositivos móveis do Google para melhorar a monetização de anúncios no app dentro desse WebView.

setAppMuted

java-static fun setAppMuted(muted: Boolean): Unit

Indica se o áudio do aplicativo está desativado. Afetará o estado inicial de silenciamento de todos os anúncios.

Aviso: desativar o som do seu aplicativo reduz a qualificação de anúncios em vídeo e pode diminuir a receita de publicidade do app. Use essa API apenas se o app oferecer um controle de desativação personalizado para o usuário e reflita a decisão de desativação do usuário nessa API.

Parâmetros
muted: Boolean

Verdadeiro se o app estiver silenciado, falso caso contrário. O padrão é "false".

setAppVolume

java-static fun setAppVolume(volume: Float): Unit

Define o volume do áudio do aplicativo. Afeta os volumes de áudio de todos os anúncios em relação a outras saídas de áudio.

Aviso: reduzir o volume do áudio do app reduz a qualificação dos anúncios em vídeo e pode diminuir a receita de anúncios do app. Use essa API somente se o app oferecer controles de volume personalizados ao usuário e reflita a escolha de volume do usuário nessa API.

Parâmetros
volume: Float

o volume como um número flutuante de 0 (mudo) a 1,0 (volume de mídia total). O padrão é 1,0

Gera
java.lang.IllegalArgumentException

se o volume estiver fora do intervalo válido

setRequestConfiguration

java-static fun setRequestConfiguration(requestConfiguration: RequestConfiguration): Unit

Define o RequestConfiguration global que será usado para cada AdRequest durante a sessão do app.

startPreload

java-static fun startPreload(
    context: Context,
    preloadConfigurations: (Mutable)List<PreloadConfiguration!>,
    preloadCallback: PreloadCallback
): Unit

Inicia o carregamento antecipado de anúncios para as configurações especificadas.

As APIs de pré-carregamento de anúncios estão em uma versão Alfa limitada. Entre em contato com seu gerente de contas para saber mais.

Parâmetros
context: Context

O Context em que o SDK está sendo executado.

preloadConfigurations: (Mutable)List<PreloadConfiguration!>

As configurações para pré-carregar anúncios.

preloadCallback: PreloadCallback

Um callback que será invocado quando a disponibilidade do anúncio mudar para cada configuração de pré-carregamento.