Ustawienia globalne

Klasa MobileAds zawiera ustawienia globalne pakietu SDK do reklam mobilnych Google.

Kontrolowanie głośności reklam wideo

Jeśli aplikacja ma własną regulację głośności (np. głośność niestandardowej muzyki lub efektów dźwiękowych), ujawnienie głośności aplikacji pakietowi SDK do reklam mobilnych Google umożliwia reklamom wideo dostosowanie się do ustawień głośności aplikacji. Dzięki temu użytkownicy będą oglądać reklamy wideo z zamierzonym poziomem głośności.

Głośność wyjścia audio urządzenia, kontrolowana za pomocą przycisków głośności lub suwaka głośności na poziomie systemu operacyjnego, określa głośność wyjścia audio urządzenia. Aplikacje mogą jednak niezależnie dostosowywać poziomy głośności w zależności od głośności urządzenia, aby dostosować jakość dźwięku. W przypadku formatów reklam wyświetlanych przy otwarciu aplikacji, banerów, reklam pełnoekranowych, reklam z nagrodą i reklam pełnoekranowych z nagrodą możesz zgłaszać względną liczbę aplikacji do pakietu SDK za pomocą statycznej metody setAppVolume(). Prawidłowe wartości głośności reklam mieszczą się w zakresie od 0.0 (bez dźwięku) do 1.0 (bieżąca głośność urządzenia). Oto przykład raportowania względnej liczby aplikacji do pakietu SDK:

Kotlin

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

Java

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

Aby poinformować pakiet SDK, że głośność aplikacji została wyciszona, użyj metody setAppMuted():

Kotlin

MobileAds.setAppMuted(true)

Java

MobileAds.setAppMuted(true);

Domyślnie głośność aplikacji jest ustawiona na 1 (bieżąca głośność urządzenia), a aplikacja nie jest wyciszona.

Uwaga: reklamy wideo, które nie mogą być wyświetlane z wyciszeniem dźwięku, nie są zwracane w przypadku żądań reklamy, gdy głośność aplikacji jest zgłoszona jako wyciszona lub ustawiona na wartość 0. Może to ograniczyć wyświetlanie reklam z większej puli reklam wideo.

Reklamy natywne

Instrukcje dotyczące ustawień wyciszenia znajdziesz w VideoOptions. W przypadku reklam natywnych nie można stosować niestandardowej kontroli głośności.

Zgoda na pliki cookie

Jeśli Twoja aplikacja ma specjalne wymagania, możesz ustawić opcjonalne ustawienie SharedPreferences.gad_has_consent_for_cookies Pakiet SDK włączy ograniczone wyświetlanie reklam (LTD), gdy ustawienie opcji gad_has_consent_for_cookies będzie równe 0.

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