Глобальные настройки

Класс MobileAds предоставляет глобальные настройки для Google Mobile Ads SDK.

Регулятор громкости видеорекламы

Если в вашем приложении есть собственные элементы управления громкостью (например, пользовательская громкость музыки или звуковых эффектов), раскрытие громкости приложения Google Mobile Ads SDK позволяет видеорекламе учитывать настройки громкости приложения. Это гарантирует, что пользователи будут получать видеорекламу с ожидаемой громкостью звука.

Громкость устройства, управляемая с помощью кнопок громкости или ползунка громкости на уровне ОС, определяет громкость вывода звука устройства. Однако приложения могут независимо регулировать уровни громкости относительно громкости устройства, чтобы адаптировать качество звука. Для форматов открытой рекламы, баннеров, межстраничных объявлений, объявлений с вознаграждением и межстраничных объявлений с вознаграждением вы можете сообщить об относительном объеме приложения в SDK с помощью статического метода setAppVolume() . Допустимые значения громкости рекламы варьируются от 0.0 (без звука) до 1.0 (громкость текущего устройства). Вот пример того, как сообщить об относительном объеме приложения в SDK:

Котлин

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

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

Ява

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

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

Чтобы сообщить SDK, что громкость приложения отключена, используйте метод setAppMuted() :

Котлин

MobileAds.setAppMuted(true)

Ява

MobileAds.setAppMuted(true);

По умолчанию для громкости приложения установлено значение 1 (текущая громкость устройства), и звук в приложении не отключен.

Примечание. Видеореклама, которую нельзя показывать с отключенным звуком, не возвращается по запросам объявлений, сделанным, когда громкость приложения указана как отключенная или для нее установлено значение 0 . Это может привести к ограничению показа части более широкого пула видеообъявлений.

Нативная реклама

Инструкции по управлению настройками отключения звука см. в разделе VideoOptions . Пользовательский регулятор громкости не поддерживается для нативной рекламы.

Согласие на использование файлов cookie

Если у вашего приложения есть особые требования, вы можете установить необязательный параметр SharedPreferences gad_has_consent_for_cookies . SDK включит ограниченную рекламу (LTD) , если для параметра gad_has_consent_for_cookies установлено нулевое значение.

Котлин

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