MobileAds

Kotlin |Java

class MobileAds

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

Resumen

Constantes
`const String!`	`ERROR_DOMAIN = "com.google.android.gms.ads"` Es el nombre de dominio de error predeterminado para el SDK de anuncios de Google para dispositivos móviles.

Funciones públicas
`java-static Unit`	`disableMediationAdapterInitialization(context: Context!)` Llama antes de `initialize` o de la primera solicitud de anuncio para inhabilitar la inicialización del adaptador de mediación.
`java-static InitializationStatus?`	`getInitializationStatus()` Obtiene el estado de inicialización del SDK.
`java-static RequestConfiguration`	`getRequestConfiguration()` Obtiene el `RequestConfiguration` global.
`java-static VersionInfo!`	`getVersion()` 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`	`initialize(context: Context!, listener: OnInitializationCompleteListener!)` Inicializa el SDK de anuncios de Google para dispositivos móviles.
`java-static Unit`	`openAdInspector(context: Context!, listener: OnAdInspectorClosedListener!)` Abre la IU del inspector de anuncios.
`java-static Unit`	`openDebugMenu(context: Context!, adUnitId: String!)` Abre el menú de depuración.
`java-static Boolean`	`putPublisherFirstPartyIdEnabled(enabled: Boolean)` Controla si está habilitado el ID propio del publicador del SDK de anuncios de Google para dispositivos móviles, antes conocido como clave para la misma aplicación.
`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 en la app dentro de este `CustomTabsSession`.
`java-static Unit`	`registerWebView(webview: WebView)` Registra un `WebView` con el SDK de anuncios de Google para dispositivos móviles para mejorar la monetización de anuncios en la app dentro de este `WebView`.
`java-static Unit`	`setAppMuted(muted: Boolean)` Indica si el audio de la aplicación está silenciado.
`java-static Unit`	`setAppVolume(volume: Float)` Establece el volumen de audio de la aplicación.
`java-static Unit`	`setRequestConfiguration(requestConfiguration: RequestConfiguration)` 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 los elementos `start` o `start`.

Constantes

ERROR_DOMAIN

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

Es el nombre de dominio de error predeterminado para el 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 de la primera solicitud de anuncio para inhabilitar la inicialización del adaptador de mediación. Este método no realiza ninguna operación una vez que se llama a initialize o se realiza 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 del lanzamiento de 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 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 del lanzamiento de 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 llamar a esta función.

Parámetros
`context: Context!`	Es la actividad `Context` en la que se ejecuta el SDK.
`adUnitId: String!`	Es cualquier ID de bloque de anuncios de Ad Manager asociado a tu aplicación.

putPublisherFirstPartyIdEnabled

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

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

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

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

Parámetros
`enabled: Boolean`	Es un valor booleano que es verdadero si el ID propio del publicador está habilitado y falso en caso contrario.

Muestra
`Boolean`	Es verdadero si la decisión se persiste correctamente. Es falso si no se puede conservar.

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 en la app dentro de este CustomTabsSession. Esto solo creará una instancia de CustomTabsSession, y volver a ejecutar este comando anulará la sesión existente.

Parámetros
`context: Context`	Es el `Context` en el que se ejecuta el SDK.
`client: CustomTabsClient`	`CustomTabsClient` que se usó para crear la instancia de `CustomTabsSession`.
`origin: String`	Es la cadena que se usa como origen en el vínculo de recurso digital para la verificación.
`callback: CustomTabsCallback?`	`CustomTabsCallback` opcional para recibir devoluciones de llamada de `CustomTabsSession`.

Muestra
`CustomTabsSession?`	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 en la app dentro de este WebView.

setAppMuted

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

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

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

Parámetros
`muted: Boolean`	Es verdadero si la app está silenciada y falso en caso contrario. 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 otros resultados de audio.

Advertencia: Reducir el volumen de audio de tu app disminuye la elegibilidad de los anuncios de video y puede reducir los ingresos publicitarios de tu 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 proporcionadas.

Las APIs de precarga 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`	Es 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 invoca cuando cambia la disponibilidad de anuncios para cada configuración de precarga.