Paramètres globaux

La classe MobileAds fournit des paramètres généraux pour le SDK Google Mobile Ads (bêta).

Contrôle du volume des annonces vidéo

Si votre application dispose de ses propres commandes de contrôle du volume (telles que des volumes de musique ou d'effet audio personnalisés), la communication du volume de l'application au SDK Google Mobile Ads (bêta) permet aux annonces vidéo de respecter les paramètres de volume de l'application. Elles permettent de s'assurer que les utilisateurs verront les annonces vidéo avec le volume audio prévu.

Le volume de l'appareil, contrôlé via les boutons de volume ou le curseur de volume au niveau de l'OS, 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'annonce à l'ouverture, bannière, interstitiel, avec récompense et interstitiel avec récompense, vous pouvez signaler le volume relatif de l'application au SDK via la méthode statique setUserControlledAppVolume(). Les valeurs valides du volume de l'annonce sont comprises entre 0.0 (silencieux) et 1.0 (volume actuel de l'appareil). Voici un exemple de la façon dont vous pouvez signaler le volume relatif de l'application au SDK :

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)

  val backgroundScope = CoroutineScope(Dispatchers.IO)
  backgroundScope.launch {
    // Initialize Google Mobile Ads SDK (beta) on a background thread.
    MobileAds.initialize(
      this@MainActivity,
      // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
      InitializationConfig.Builder("SAMPLE_APP_ID").build()
    ) {}
    
    // Set app volume to be half of current device volume.
    MobileAds.setUserControlledAppVolume(0.5f)
  }
}

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);

  new Thread(
          () -> {
            // Initialize Google Mobile Ads SDK (beta) on a background thread.
            MobileAds.initialize(
                this,
                // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
                new InitializationConfig.Builder("SAMPLE_APP_ID")
                    .build(),
                initializationStatus -> {
                });
            
            // Set app volume to be half of current device volume.
            MobileAds.setUserControlledAppVolume(0.5f);
          })
      .start();
}

Pour informer le SDK que le volume de l'application a été coupé, utilisez la méthode setUserMutedApp() :

Kotlin

MobileAds.setUserMutedApp(true)

Java

MobileAds.setUserMutedApp(true);

Par défaut, le volume de l'application est défini sur 1 (le volume actuel de l'appareil), et le son de l'application n'est pas coupé.

Remarque : Les annonces vidéo qui ne peuvent pas être diffusées avec le son désactivé ne sont pas renvoyées pour les demandes d'annonces effectuées lorsque le volume de l'application est signalé comme étant désactivé ou défini sur la valeur 0. Cela peut empêcher la diffusion d'un sous-ensemble du pool d'annonces vidéo plus large.

Consentement pour les cookies

Si votre application a des exigences particulières, vous pouvez définir l'option SharedPreferences gad_has_consent_for_cookies. Le SDK activera les annonces limitées (LTD) lorsque la préférence gad_has_consent_for_cookies sera définie sur zéro.

Kotlin

val sharedPrefs = PreferenceManager.getDefaultSharedPreferences(context)
// Set the value to 0 to enable limited ads.
sharedPrefs.edit().putInt("gad_has_consent_for_cookies", 0).apply()

Java

Context activity = getActivity();
SharedPreferences sharedPreferences =
  PreferenceManager.getDefaultSharedPreferences(activity);
// Set the value to 0 to enable limited ads.
sharedPreferences.edit().putInt("gad_has_consent_for_cookies", 0).apply();