MobileAds

public 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

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

Métodos públicos

static void

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

static @Nullable InitializationStatus

Obtiene el estado de inicialización del SDK.

static @NonNull RequestConfiguration

Obtiene el RequestConfiguration global.

static VersionInfo

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

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

static void

Abre la IU del inspector de anuncios.

static void
openDebugMenu(Context context, String adUnitId)

Abre el menú de depuración.

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.

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 integrados en la app dentro de este CustomTabsSession.

static void

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.

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
)

Comienza a precargar anuncios para las configuraciones determinadas.

Constantes

ERROR_DOMAIN

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

Métodos públicos

disableMediationAdapterInitialization

public static void disableMediationAdapterInitialization(Context context)

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

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

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 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.

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 esta función.

Parámetros
Context context

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

String adUnitId

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

putPublisherFirstPartyIdEnabled

public static boolean putPublisherFirstPartyIdEnabled(boolean enabled)

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

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

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 integrados en la app dentro de este CustomTabsSession. Esto solo creará una instancia de CustomTabsSession y, si vuelves a ejecutarlo, se anulará la sesión existente.

Parámetros
@NonNull Context context

El Context en el que se ejecuta el SDK

@NonNull CustomTabsClient client

CustomTabsClient que se usó para crear la instancia CustomTabsSession

@NonNull String origin

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

@Nullable CustomTabsCallback callback

CustomTabsCallback opcional para recibir devoluciones de llamadas .

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

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 integrados 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 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
boolean muted

Es verdadero si la app está silenciada; de lo contrario, es falso. 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 otras salidas de audio.

Advertencia: Si bajas el volumen de audio de tu app, 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 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 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
@NonNull Context context

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 invocará cuando cambie la disponibilidad de los anuncios para cada configuración de carga previa.