La classe MobileAds
fournit des paramètres généraux pour le SDK Google Mobile Ads.
Contrôle du volume des annonces vidéo
Si votre application possède ses propres commandes de volume (telles que des volumes de musique ou d'effets sonores personnalisés), le fait de divulguer le volume de l'application au SDK Google Mobile Ads permet aux annonces vidéo de respecter les paramètres de volume de l'application. Cela permet de s'assurer que les utilisateurs reçoivent des annonces vidéo au volume audio attendu.
Le volume de l'appareil, contrôlé via les boutons de volume ou le curseur de volume au niveau du système d'exploitation, détermine le volume de la sortie audio de l'appareil. Toutefois, les applications peuvent ajuster indépendamment les niveaux de volume par rapport au volume de l'appareil pour personnaliser l'expérience audio. Pour les formats d'annonces à l'ouverture d'une application, de bannières, d'interstitiels, d'annonces avec récompense et d'interstitiels avec récompense, vous pouvez signaler le volume relatif de l'application au SDK via la méthode statique setAppVolume()
. Les valeurs valides pour le volume d'annonces sont comprises entre 0.0
(silencieux) et 1.0
(volume actuel de l'appareil). Voici un exemple de procédure à suivre pour signaler le volume relatif de l'application au SDK:
Java
@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_my); new Thread( () -> { // Initialize the 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(); }
Kotlin
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) val backgroundScope = CoroutineScope(Dispatchers.IO) backgroundScope.launch { // Initialize the 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) } }
Pour informer le SDK que le volume de l'application a été coupé, utilisez la méthode setAppMuted()
:
Java
MobileAds.setAppMuted(true);
Kotlin
MobileAds.setAppMuted(true)
Par défaut, le volume de l'application est défini sur 1
(volume actuel de l'appareil), et le son de l'application n'est pas coupé.
Annonces natives
Pour savoir comment contrôler les paramètres de désactivation du son, consultez VideoOptions
. Le contrôle personnalisé du volume n'est actuellement pas compatible avec les annonces natives.
Consentement pour les cookies
Si votre application présente des exigences particulières, vous pouvez définir la gad_has_consent_for_cookies
SharedPreferences
facultative. Le SDK active
les annonces limitées (LTD)
lorsque la préférence gad_has_consent_for_cookies
est définie sur zéro.
Java
Context activity = getActivity(); SharedPreferences sharedPreferences = PreferenceManager.getDefaultSharedPreferences(activity); sharedPreferences.edit().putInt("gad_has_consent_for_cookies", 0).apply();
Kotlin
val sharedPrefs = PreferenceManager.getDefaultSharedPreferences(context) sharedPrefs.edit().putInt("gad_has_consent_for_cookies", 0).apply()