Ustawienia globalne

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

Regulacja 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), podanie głośności aplikacji w pakiecie SDK do reklam mobilnych Google umożliwi reklamom wideo respektowanie ustawień głośności aplikacji. Dzięki temu użytkownicy będą widzieć reklamy wideo z oczekiwaną głośnością dźwięku.

Głośność urządzenia, określana za pomocą przycisków 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 regulować głośność w zależności od głośności urządzenia, aby dostosować wrażenia dźwiękowe. 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 raportować względną liczbę aplikacji SDK za pomocą statycznej metody setAppVolume(). Prawidłowe wartości liczby reklam z zakresu od 0.0 (wyciszone) do 1.0 (aktualna głośność na urządzeniu). Oto przykład, jak zgłosić względną liczbę aplikacji w pakiecie 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)
  }
}

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

Java

MobileAds.setAppMuted(true);

Kotlin

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ą się wyświetlać z wyciszonym dźwiękiem, nie są zwracane w przypadku żądań reklamy wysłanych, gdy głośność w aplikacji została zgłoszona jako wyciszona lub ustawiona na 0. Może to ograniczyć wyświetlanie reklam z niektórych grup reklam wideo.

Reklamy natywne

Instrukcje sterowania ustawieniami wyciszania znajdziesz w sekcji VideoOptions. Niestandardowa regulacja głośności nie jest obecnie obsługiwana w przypadku reklam natywnych.

Zgoda na pliki cookie

Jeśli Twoja aplikacja ma specjalne wymagania, możesz ustawić opcjonalny SharedPreferences gad_has_consent_for_cookies. Pakiet SDK włączy ograniczone wyświetlanie reklam (LTD) gdy ustawienie gad_has_consent_for_cookies ma wartość 0.

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