Esta página foi traduzida pela API Cloud Translation.

MobileAds

Kotlin |Java

public 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
`static final 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.

Métodos públicos
`static void`	`disableMediationAdapterInitialization(Context context)` Chame antes de `initialize` ou da primeira solicitação de anúncio para desativar a inicialização do adaptador de mediação.
`static @Nullable InitializationStatus`	`getInitializationStatus()` Recebe o status de inicialização do SDK.
`static @NonNull RequestConfiguration`	`getRequestConfiguration()` Recebe o `RequestConfiguration` global.
`static VersionInfo`	`getVersion()` Recebe a versão externa (por exemplo, 20.6.0) do SDK dos anúncios para dispositivos móveis do Google.
`static void`	`@RequiresPermission(value = Manifest.permission.INTERNET) initialize(Context context)` Inicializa o SDK dos anúncios para dispositivos móveis do Google.
`static void`	`initialize(Context context, OnInitializationCompleteListener listener)` Inicializa o SDK dos anúncios para dispositivos móveis do Google.
`static void`	`openAdInspector(Context context, OnAdInspectorClosedListener listener)` Abre a interface do Ad Inspector.
`static void`	`openDebugMenu(Context context, String adUnitId)` Abre o menu de depuração.
`static boolean`	`putPublisherFirstPartyIdEnabled(boolean enabled)` 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.
`static @Nullable CustomTabsSession`	`registerCustomTabsSession( @NonNull Context context, @NonNull CustomTabsClient client, @NonNull String origin, @Nullable CustomTabsCallback callback )` 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`.
`static void`	`registerWebView(@NonNull WebView webview)` 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`.
`static void`	`setAppMuted(boolean muted)` Indica se o áudio do aplicativo está desativado.
`static void`	`setAppVolume(float volume)` Define o volume do áudio do aplicativo.
`static void`	`setRequestConfiguration( @NonNull RequestConfiguration requestConfiguration )` Define o `RequestConfiguration` global que será usado para cada `AdRequest` durante a sessão do app.
`static void`	`startPreload( @NonNull Context context, @NonNull List<PreloadConfiguration> preloadConfigurations, @NonNull PreloadCallback preloadCallback )` Inicia o carregamento antecipado de anúncios para as configurações especificadas.

Constantes

ERROR_DOMAIN

public static final 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.

Métodos públicos

disableMediationAdapterInitialization

public static void disableMediationAdapterInitialization(Context context)

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ó deve 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

public static @Nullable InitializationStatus getInitializationStatus()

Recebe o status de inicialização do SDK.

getRequestConfiguration

public static @NonNull RequestConfiguration getRequestConfiguration()

Recebe o RequestConfiguration global.

getVersion

public static VersionInfo getVersion()

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)
public static void initialize(Context context)

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

public static void initialize(Context context, OnInitializationCompleteListener listener)

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.
`OnInitializationCompleteListener listener`	Um callback que será invocado após a conclusão da inicialização.

openAdInspector

public static void openAdInspector(Context context, OnAdInspectorClosedListener listener)

Abre a interface do Ad Inspector.

openDebugMenu

public static void openDebugMenu(Context context, String adUnitId)

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.
`String adUnitId`	Qualquer ID de bloco de anúncios do Ad Manager associado ao seu app.

putPublisherFirstPartyIdEnabled

public static boolean putPublisherFirstPartyIdEnabled(boolean enabled)

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
`boolean enabled`	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. False se não for possível manter.

registerCustomTabsSession

public static @Nullable CustomTabsSession registerCustomTabsSession(
    @NonNull Context context,
    @NonNull CustomTabsClient client,
    @NonNull String origin,
    @Nullable CustomTabsCallback callback
)

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
`@NonNull Context context`	O `Context` em que o SDK está sendo executado.
`@NonNull CustomTabsClient client`	`CustomTabsClient` usado para criar a instância `CustomTabsSession`.
`@NonNull String origin`	String usada como origem no Digital Asset Link para verificação.
`@Nullable CustomTabsCallback callback`	`CustomTabsCallback` opcional para receber callbacks de .

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

registerWebView

public static void registerWebView(@NonNull WebView webview)

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

public static void setAppMuted(boolean muted)

Indica se o áudio do aplicativo está desativado. Afetará o estado inicial de desativação de som 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 anúncios 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
`boolean muted`	Verdadeiro se o app estiver silenciado. Caso contrário, é falso. O padrão é "false".

setAppVolume

public static void setAppVolume(float volume)

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
`float volume`	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

public static void setRequestConfiguration(
    @NonNull RequestConfiguration requestConfiguration
)

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

startPreload

public static void startPreload(
    @NonNull Context context,
    @NonNull List<PreloadConfiguration> preloadConfigurations,
    @NonNull PreloadCallback preloadCallback
)

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
`@NonNull Context context`	O `Context` em que o SDK está sendo executado.
`@NonNull List<PreloadConfiguration> preloadConfigurations`	As configurações para pré-carregar anúncios.
`@NonNull PreloadCallback preloadCallback`	Um callback que será invocado quando a disponibilidade do anúncio mudar para cada configuração de pré-carregamento.