MobileAds

Kotlin |Java

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

Métodos públicos
`static void`	`disableMediationAdapterInitialization(Context context)` Llama antes de `initialize` o de la primera solicitud de anuncio para inhabilitar la inicialización del adaptador de mediación.
`static @Nullable InitializationStatus`	`getInitializationStatus()` Obtiene el estado de inicialización del SDK.
`static @NonNull RequestConfiguration`	`getRequestConfiguration()` Obtiene el `RequestConfiguration` global.
`static VersionInfo`	`getVersion()` Obtiene la versión externa (por ejemplo, 20.6.0) del SDK de anuncios de Google para dispositivos móviles.
`static void`	`@RequiresPermission(value = Manifest.permission.INTERNET) initialize(Context context)` Inicializa el SDK de anuncios de Google para dispositivos móviles.
`static void`	`initialize(Context context, OnInitializationCompleteListener listener)` Inicializa el SDK de anuncios de Google para dispositivos móviles.
`static void`	`openAdInspector(Context context, OnAdInspectorClosedListener listener)` Abre la IU del inspector de anuncios.
`static void`	`openDebugMenu(Context context, String adUnitId)` Abre el menú de depuración.
`static boolean`	`putPublisherFirstPartyIdEnabled(boolean enabled)` 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.
`static @Nullable CustomTabsSession`	`registerCustomTabsSession( @NonNull Context context, @NonNull CustomTabsClient client, @NonNull String origin, @Nullable CustomTabsCallback callback )` 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`.
`static void`	`registerWebView(@NonNull 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`.
`static void`	`setAppMuted(boolean muted)` Indica si el audio de la aplicación está silenciado.
`static void`	`setAppVolume(float volume)` Establece el volumen de audio de la aplicación.
`static void`	`setRequestConfiguration( @NonNull RequestConfiguration requestConfiguration )` Establece el `RequestConfiguration` global que se usará para cada `AdRequest` durante la sesión de la app.
`static void`	`startPreload( @NonNull Context context, @NonNull List<PreloadConfiguration> preloadConfigurations, @NonNull PreloadCallback preloadCallback )` Este método dejó de estar disponible. En su lugar, usa los elementos `start` o `start`.

Constantes

ERROR_DOMAIN

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

Métodos públicos

disableMediationAdapterInitialization

public static void disableMediationAdapterInitialization(Context context)

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

public static @Nullable InitializationStatus getInitializationStatus()

Obtiene el estado de inicialización del SDK.

getRequestConfiguration

public static @NonNull RequestConfiguration getRequestConfiguration()

Obtiene el RequestConfiguration global.

getVersion

public static VersionInfo getVersion()

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

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

public static void initialize(Context context, OnInitializationCompleteListener listener)

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.
`OnInitializationCompleteListener listener`	Es una devolución de llamada que se invocará cuando se complete la inicialización.

openAdInspector

public static void openAdInspector(Context context, OnAdInspectorClosedListener listener)

Abre la IU del inspector de anuncios.

openDebugMenu

public static void openDebugMenu(Context context, String adUnitId)

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.
`String adUnitId`	Es cualquier ID de bloque de anuncios de Ad Manager asociado a tu aplicación.

putPublisherFirstPartyIdEnabled

public static boolean putPublisherFirstPartyIdEnabled(boolean enabled)

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
`boolean enabled`	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

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

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
`@NonNull Context context`	Es el `Context` en el que se ejecuta el SDK.
`@NonNull CustomTabsClient client`	`CustomTabsClient` que se usó para crear la instancia de `CustomTabsSession`.
`@NonNull String origin`	Es la cadena que se usa como origen en el vínculo de recurso digital para la verificación.
`@Nullable CustomTabsCallback callback`	`CustomTabsCallback` opcional para recibir devoluciones de llamada de `CustomTabsSession`.

Muestra
`@Nullable 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

public static void registerWebView(@NonNull 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.

setAppMuted

public static void setAppMuted(boolean muted)

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
`boolean muted`	Es verdadero si la app está silenciada y falso en caso contrario. La configuración predeterminada es "false".

setAppVolume

public static void setAppVolume(float volume)

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

public static void setRequestConfiguration(
    @NonNull RequestConfiguration requestConfiguration
)

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

startPreload

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

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
`@NonNull Context context`	Es el `Context` en el que se ejecuta el SDK.
`@NonNull List<PreloadConfiguration> preloadConfigurations`	Son los parámetros de configuración para precargar anuncios.
`@NonNull PreloadCallback preloadCallback`	Es una devolución de llamada que se invoca cuando cambia la disponibilidad de anuncios para cada configuración de precarga.