Para analizar nuestros productos y proporcionar comentarios sobre ellos, únete al canal oficial de Ad Manager en Discord, en el servidor Google Advertising and Measurement Community.
La clase MobileAds proporciona parámetros de configuración globales para el SDK de anuncios de Google para dispositivos móviles.
Control de volumen para anuncios de video
Si tu app tiene sus propios controles de volumen (como volúmenes personalizados de música o efectos de sonido), divulgar el volumen de la app al SDK de anuncios de Google para dispositivos móviles permite que los anuncios de video respeten la configuración de volumen de la app. Esto garantiza que los usuarios reciban anuncios de video con el volumen de audio esperado.
El volumen del dispositivo, controlado por medio de los botones de volumen o el control deslizante de volumen del sistema operativo, determina el volumen de la salida de audio del dispositivo. Sin embargo, las apps pueden ajustar de forma independiente los niveles de volumen en relación con el volumen del dispositivo para personalizar la experiencia de audio. En el caso de los formatos de anuncios de aplicación abierta, banner, intersticial, recompensado y recompensado intersticial, puedes informar el volumen relativo de la app al SDK a través del método estático setAppVolume(). Los valores válidos del volumen del anuncio varían de 0.0 (silencio) a 1.0 (volumen actual del dispositivo). A continuación, se muestra un ejemplo de cómo informar el volumen relativo de la app al SDK:
Kotlin
overridefunonCreate(savedInstanceState:Bundle?){super.onCreate(savedInstanceState)valbackgroundScope=CoroutineScope(Dispatchers.IO)backgroundScope.launch{// Initialize Google Mobile Ads SDK on a background thread.MobileAds.initialize(this@MainActivity){}// Set app volume to be half of current device volume.MobileAds.setAppVolume(0.5f)}}
Java
@OverrideprotectedvoidonCreate(BundlesavedInstanceState){super.onCreate(savedInstanceState);newThread(()->{// Initialize Google Mobile Ads SDK on a background thread.MobileAds.initialize(this,initializationStatus->{});// Set app volume to be half of current device volume.MobileAds.setAppVolume(0.5f);}).start();}
Para informar al SDK que se silenció el volumen de la app, usa el método setAppMuted():
Kotlin
MobileAds.setAppMuted(true)
Java
MobileAds.setAppMuted(true);
De forma predeterminada, el volumen de la app se establece en 1 (el volumen actual del dispositivo) y la app no está silenciada.
Anuncios nativos
Consulta VideoOptions para obtener instrucciones sobre cómo controlar la configuración de silencio. El control de volumen personalizado no es compatible con los anuncios nativos.
Consentimiento para cookies
Si tu app tiene requisitos especiales, puedes establecer el SharedPreferencesgad_has_consent_for_cookies opcional. El SDK habilitará los anuncios limitados (LTD) cuando la preferencia gad_has_consent_for_cookies se establezca en cero.
Kotlin
valsharedPrefs=PreferenceManager.getDefaultSharedPreferences(context)// Set the value to 0 to enable limited ads.sharedPrefs.edit().putInt("gad_has_consent_for_cookies",0).apply()
Java
Contextactivity=getActivity();SharedPreferencessharedPreferences=PreferenceManager.getDefaultSharedPreferences(activity);// Set the value to 0 to enable limited ads.sharedPreferences.edit().putInt("gad_has_consent_for_cookies",0).apply();
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-05 (UTC)"],[[["\u003cp\u003eThe \u003ccode\u003eMobileAds\u003c/code\u003e class provides global settings for the Google Mobile Ads SDK, including video ad volume and consent for cookies.\u003c/p\u003e\n"],["\u003cp\u003eYou can control video ad volume by setting the app volume relative to the device volume using \u003ccode\u003eMobileAds.setAppVolume()\u003c/code\u003e and muting with \u003ccode\u003eMobileAds.setAppMuted()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eWhen app volume is reported as muted or 0, video ads ineligible to be shown muted may not be returned, potentially limiting ad serving.\u003c/p\u003e\n"],["\u003cp\u003eFor native ads, video mute settings are controlled through \u003ccode\u003eVideoOptions\u003c/code\u003e, and custom volume control is not supported.\u003c/p\u003e\n"],["\u003cp\u003eTo enable limited ads due to specific consent requirements, set the \u003ccode\u003egad_has_consent_for_cookies\u003c/code\u003e SharedPreferences value to 0.\u003c/p\u003e\n"]]],[],null,["Select platform: [Android](/ad-manager/mobile-ads-sdk/android/global-settings \"View this page for the Android platform docs.\") [iOS](/ad-manager/mobile-ads-sdk/ios/global-settings \"View this page for the iOS platform docs.\") [Unity](/ad-manager/mobile-ads-sdk/unity/global-settings \"View this page for the Unity platform docs.\")\n\n\u003cbr /\u003e\n\nThe `MobileAds` class provides global settings for Google Mobile Ads SDK.\n\nVideo ad volume control\n\nIf your app has its own volume controls (such as custom music or sound effect\nvolumes), disclosing app volume to Google Mobile Ads SDK allows video ads to\nrespect app volume settings. This ensures users receive video ads with the\nexpected audio volume.\n\nThe device volume, controlled through volume buttons or OS-level volume slider,\ndetermines the volume for device audio output. However, apps can independently\nadjust volume levels relative to the device volume to tailor the audio\nexperience. For app open, banner, interstitial, rewarded, and rewarded\ninterstitial ad formats, you can report the relative app volume to the SDK\nthrough the static `setAppVolume()` method. Valid ad volume values range from\n`0.0` (silent) to `1.0` (current device volume). Here's an example of how to\nreport the relative app volume to the SDK: \n\nKotlin \n\n override fun onCreate(savedInstanceState: Bundle?) {\n super.onCreate(savedInstanceState)\n\n val backgroundScope = CoroutineScope(Dispatchers.IO)\n backgroundScope.launch {\n // Initialize Google Mobile Ads SDK on a background thread.\n MobileAds.initialize(this@MainActivity) {}\n \n // Set app volume to be half of current device volume.\n MobileAds.setAppVolume(0.5f)\n }\n }\n\nJava \n\n @Override\n protected void onCreate(Bundle savedInstanceState) {\n super.onCreate(savedInstanceState);\n\n new Thread(\n () -\u003e {\n // Initialize Google Mobile Ads SDK on a background thread.\n MobileAds.initialize(this, initializationStatus -\u003e {});\n \n // Set app volume to be half of current device volume.\n MobileAds.setAppVolume(0.5f);\n })\n .start();\n }\n\nTo inform the SDK that the app volume has muted, use the `setAppMuted()`\nmethod: \n\nKotlin \n\n MobileAds.setAppMuted(true)\n\nJava \n\n MobileAds.setAppMuted(true);\n\nBy default, the app volume is set to `1` (the current device volume), and the\napp is not muted.\n| **Note:** Video ads that are ineligible to be shown with muted audio are not returned for ad requests made when the app volume is reported as muted or set to a value of `0`. This may restrict a subset of the broader video ads pool from serving.\n\nNative ads\n\nSee\n[`VideoOptions`](/ad-manager/mobile-ads-sdk/android/native/video-ads#videooptions)\nfor instructions on how to control the mute settings. Custom volume control is\nnot supported for native ads.\n\nConsent for cookies\n\nIf your app has special requirements, you can set the optional\n[`SharedPreferences`](//developer.android.com/reference/android/content/SharedPreferences)\n`gad_has_consent_for_cookies`. The SDK will enable\n\n[limited ads (LTD)](//support.google.com/admanager/answer/9882911)\n\nwhen the `gad_has_consent_for_cookies` preference is set to zero. \n\nKotlin \n\n val sharedPrefs = PreferenceManager.getDefaultSharedPreferences(context)\n // Set the value to 0 to enable limited ads.\n sharedPrefs.edit().putInt(\"gad_has_consent_for_cookies\", 0).apply()\n\nJava \n\n Context activity = getActivity();\n SharedPreferences sharedPreferences =\n PreferenceManager.getDefaultSharedPreferences(activity);\n // Set the value to 0 to enable limited ads.\n sharedPreferences.edit().putInt(\"gad_has_consent_for_cookies\", 0).apply();"]]