MobileAds

class MobileAds


La clase contiene lógica que se aplica al SDK de anuncios de Google para dispositivos móviles en su totalidad. En este momento, los únicos métodos que se usan son para la inicialización.

Resumen

Constantes

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

Es el nombre de dominio de error predeterminado del SDK de anuncios de Google para dispositivos móviles.

Funciones públicas

java-static Unit

Llama antes de initialize o la primera solicitud de anuncio para inhabilitar la inicialización del adaptador de mediación.

java-static InitializationStatus?

Obtiene el estado de inicialización del SDK.

java-static RequestConfiguration

Obtiene el RequestConfiguration global.

java-static VersionInfo!

Obtiene la versión externa (por ejemplo, 20.6.0) del SDK de anuncios de Google para dispositivos móviles.

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

Inicializa el SDK de anuncios de Google para dispositivos móviles.

java-static Unit

Inicializa el SDK de anuncios de Google para dispositivos móviles.

java-static Unit

Abre la IU del inspector de anuncios.

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

Abre el menú de depuración.

java-static Boolean

Controla si el ID propio del publicador del SDK de anuncios de Google para dispositivos móviles, antes conocido como clave para la misma aplicación, está habilitado.

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

Registra un CustomTabsClient con el SDK de anuncios de Google para dispositivos móviles para mejorar la monetización de anuncios integrados en la app dentro de este CustomTabsClient.CustomTabsSession

java-static Unit

Registra un WebView con el SDK de anuncios de Google para dispositivos móviles para mejorar la monetización de anuncios integrados en la app dentro de este WebView.WebView

java-static Unit

Indica si el audio de la aplicación está silenciado.

java-static Unit

Establece el volumen de audio de la aplicación.

java-static Unit

Establece el RequestConfiguration global que se usará para cada AdRequest durante la sesión de la app.

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

Esta función es obsoleta.

En su lugar, usa start o start.

Constantes

ERROR_DOMAIN

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

Es el nombre de dominio de error predeterminado del SDK de anuncios de Google para dispositivos móviles.

Funciones públicas

disableMediationAdapterInitialization

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

Llama antes de initialize o la primera solicitud de anuncio para inhabilitar la inicialización del adaptador de mediación. Este método es una operación no realizada una vez que se realiza initialize o la primera solicitud de anuncios.

Advertencia: Llamar a este método puede afectar negativamente el rendimiento de tu mediación. Solo se debe llamar a este método si incluyes adaptadores de mediación en tu app, pero no planeas usar la mediación de Google durante esta sesión de la app (por ejemplo, si ejecutas una prueba A/B).

getInitializationStatus

java-static fun getInitializationStatus(): InitializationStatus?

Obtiene el estado de inicialización del SDK.

getRequestConfiguration

java-static fun getRequestConfiguration(): RequestConfiguration

Obtiene el RequestConfiguration global.

getVersion

java-static fun getVersion(): VersionInfo!

Obtiene la versión externa (por ejemplo, 20.6.0) del SDK de anuncios de Google para dispositivos móviles.

No es necesario llamar a initialize antes de esta función.

initialize

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

Inicializa el SDK de anuncios de Google para dispositivos móviles.

Llama a este método lo antes posible después de que se inicie la app para reducir la latencia en la primera solicitud de anuncio de la sesión.

Si no se llama a este método, la primera solicitud de anuncio inicializa automáticamente el SDK de anuncios de Google para dispositivos móviles.

Parámetros
context: Context!

El Context en el que se ejecuta el SDK

initialize

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

Inicializa el SDK de anuncios de Google para dispositivos móviles.

Llama a este método lo antes posible después de que se inicie la app para reducir la latencia en la primera solicitud de anuncio de la sesión.

Si no se llama a este método, la primera solicitud de anuncio inicializa automáticamente el SDK de anuncios de Google para dispositivos móviles.

Parámetros
context: Context!

Es la actividad Context en la que se ejecuta el SDK.

listener: OnInitializationCompleteListener!

Es una devolución de llamada que se invocará cuando se complete la inicialización.

openAdInspector

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

Abre la IU del inspector de anuncios.

openDebugMenu

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

Abre el menú de depuración. Se debe llamar a initialize antes de esta función.

Parámetros
context: Context!

Es la actividad Context en la que se ejecuta el SDK.

adUnitId: String!

Cualquier ID de unidad de anuncios de Ad Manager asociado con tu aplicación

putPublisherFirstPartyIdEnabled

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

Controla si el ID propio del publicador del SDK de anuncios de Google para dispositivos móviles, antes conocido como clave para la misma aplicación, está habilitado.

El ID está habilitado de forma predeterminada. Cuando se inhabilita, el parámetro de configuración se conserva en todas las sesiones de la app y se borra el ID.

Se debe llamar a initialize antes de esta función.

Parámetros
enabled: Boolean

Es un valor booleano verdadero si el ID propio del publicador está habilitado; de lo contrario, es falso.

Muestra
Boolean

Es verdadero si la decisión se conserva correctamente. Es falso si no se conserva.

registerCustomTabsSession

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

Registra un CustomTabsClient con el SDK de anuncios de Google para dispositivos móviles para mejorar la monetización de anuncios integrados en la app dentro de este CustomTabsClient.CustomTabsSession Esto solo creará una instancia de CustomTabsSession y, si vuelves a ejecutarlo, se anulará la sesión existente.

Parámetros
context: Context

El Context en el que se ejecuta el SDK

client: CustomTabsClient

CustomTabsClient que se usó para crear la instancia CustomTabsSession

origin: String

Es la cadena que se usa como origen en el vínculo de recursos digitales para la verificación.

callback: CustomTabsCallback?

CustomTabsCallback opcional para recibir devoluciones de llamada de

Muestra
CustomTabsSession?

Es la instancia de CustomTabsSession que se usará para el intent de pestañas personalizadas cuando se abra una página de pestañas personalizadas.

registerWebView

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

Registra un WebView con el SDK de anuncios de Google para dispositivos móviles para mejorar la monetización de anuncios integrados en la app dentro de este WebView.WebView

setAppMuted

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

Indica si el audio de la aplicación está silenciado. Afecta el estado de silenciamiento inicial de todos los anuncios.

Advertencia: Si silencias tu aplicación, se reducirá la elegibilidad de los anuncios de video y es posible que también disminuyan los ingresos publicitarios de tu app. Solo debes usar esta API si tu app proporciona un control de silenciamiento personalizado al usuario y debes reflejar la decisión de silenciamiento del usuario en esta API.

Parámetros
muted: Boolean

Es verdadero si la app está silenciada; de lo contrario, es falso. La configuración predeterminada es "false".

setAppVolume

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

Establece el volumen de audio de la aplicación. Afecta los volúmenes de audio de todos los anuncios en relación con otras salidas de audio.

Advertencia: Si bajas el volumen de audio de la app, se reducirá la elegibilidad de los anuncios de video y es posible que también disminuyan los ingresos publicitarios de la app. Solo debes usar esta API si tu app proporciona controles de volumen personalizados al usuario y debes reflejar la elección de volumen del usuario en esta API.

Parámetros
volume: Float

el volumen como un número de punto flotante de 0 (silenciado) a 1.0 (volumen multimedia completo) El valor predeterminado es 1.0.

Arroja
java.lang.IllegalArgumentException

Si el volumen está fuera del rango válido

setRequestConfiguration

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

Establece el RequestConfiguration global que se usará para cada AdRequest durante la sesión de la app.

startPreload

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

Comienza a precargar anuncios para las configuraciones determinadas.

Las APIs de carga previa de anuncios se encuentran en una fase alfa limitada. Comunícate con tu administrador de cuentas para obtener más información.

Parámetros
context: Context

El Context en el que se ejecuta el SDK

preloadConfigurations: (Mutable)List<PreloadConfiguration!>

Son los parámetros de configuración para precargar anuncios.

preloadCallback: PreloadCallback

Es una devolución de llamada que se invocará cuando cambie la disponibilidad de los anuncios para cada configuración de carga previa.