Genel Ayarlar

MobileAds sınıfı, Google Mobile Ads SDK'sı için genel ayarlar sağlar.

Video reklam ses düzeyi kontrolü

Uygulamanızın kendi ses seviyesi kontrolleri (özel müzik veya ses efekti ses seviyeleri gibi) varsa uygulama ses düzeyini Google Mobile Ads SDK'sına bildirmek, video reklamların uygulama ses seviyesi ayarlarına uymasına olanak tanır. Bu sayede kullanıcılar video reklamları beklenen ses düzeyinde alır.

Cihaz ses çıkışının ses düzeyi, ses düğmeleri veya işletim sistemi düzeyindeki ses düzeyi kaydırma çubuğu aracılığıyla kontrol edilen cihaz ses düzeyiyle belirlenir. Ancak uygulamalar, ses deneyimini özelleştirmek için ses düzeylerini cihaz sesine göre bağımsız olarak ayarlayabilir. Uygulama açılışı, banner, geçiş reklamı, ödüllü reklam ve ödüllü geçiş reklamı biçimleri için statik setAppVolume() yöntemini kullanarak SDK'ya göreli uygulama hacmini bildirebilirsiniz. Geçerli reklam ses seviyesi değerleri 0.0 (sessiz) ile 1.0 (mevcut cihaz ses seviyesi) arasındadır. SDK'ya göreli uygulama hacmini nasıl bildireceğinize dair bir örnek aşağıda verilmiştir:

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

SDK'yı uygulama sesinin kapatıldığını bildirmek için setAppMuted() yöntemini kullanın:

Kotlin

MobileAds.setAppMuted(true)

Java

MobileAds.setAppMuted(true);

Uygulama sesi varsayılan olarak 1 (mevcut cihaz sesi) olarak ayarlanır ve uygulama sessize alınmaz.

Not: Sessiz sesle gösterilmeye uygun olmayan video reklamlar, uygulama ses seviyesi sessiz olarak raporlandığında veya 0 değerine ayarlandığında yapılan reklam istekleri için döndürülmez. Bu, daha geniş video reklam havuzunun bir alt kümesinin yayınlanmasını kısıtlayabilir.

Yerel reklamlar

Sessize alma ayarlarını kontrol etme talimatları için VideoOptions bölümüne bakın. Özel ses düzeyi kontrolü, yerel reklamlarda desteklenmez.

Çerez izni

Uygulamanızın özel gereksinimleri varsa isteğe bağlı SharedPreferences gad_has_consent_for_cookies seçeneğini belirleyebilirsiniz. gad_has_consent_for_cookies tercihi sıfıra ayarlandığında SDK, sınırlı reklamları (SR) etkinleştirir.

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