Paramètres généraux

Sélectionnez une plate-forme : Android (bêta) Android iOS Unity

La classe MobileAds fournit des paramètres globaux pour GMA Next-Gen SDK.

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 divulgation du volume de l'application au GMA Next-Gen SDK permet aux annonces vidéo de respecter les paramètres de volume de l'application. Les utilisateurs verront ainsi les annonces vidéo avec le volume audio prévu.

Le volume de l'appareil, contrôlé par 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, bannières, interstitielles, avec récompense et interstitielles avec récompense, vous pouvez signaler le volume relatif de l'application au SDK à l'aide de la méthode statique setUserControlledAppVolume(). Les valeurs de volume d'annonce valides sont comprises entre 0.0 (silencieux) et 1.0 (volume actuel de l'appareil). Voici un exemple de signalement du volume relatif de l'application au SDK :

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

  val backgroundScope = CoroutineScope(Dispatchers.IO)
  backgroundScope.launch {
    // Initialize GMA Next-Gen SDK 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)
  }
}

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

  new Thread(
          () -> {
            // Initialize GMA Next-Gen SDK 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() :

MobileAds.setUserMutedApp(true)

MobileAds.setUserMutedApp(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é.

Consentement aux cookies

Si votre application présente des exigences particulières, vous pouvez définir le facultatif SharedPreferences gad_has_consent_for_cookies. Le SDK activera les annonces limitées lorsque la préférence gad_has_consent_for_cookies est définie sur zéro.

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

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();