Global ayarlar

Platform seçin: Android iOS Unity Android (Eski)

MobileAds sınıfı, GMA Next-Gen SDK için genel ayarlar sağlar.

Video reklam ses kontrolü

Uygulamanızın kendi ses seviyesi kontrolleri (özel müzik veya ses efekti gibi) varsa uygulama ses seviyesini GMA Next-Gen SDK ile paylaşarak video reklamların uygulama ses seviyesi ayarlarına uymasına izin verebilirsiniz. Bu sayede kullanıcılar video reklamları beklenen ses düzeyinde alır.

Ses yüksekliği düğmeleri veya işletim sistemi düzeyindeki ses düzeyi kaydırıcısı aracılığıyla kontrol edilen cihaz ses düzeyi, cihaz ses çıkışının ses düzeyini belirler. Ancak uygulamalar, ses deneyimini özelleştirmek için ses seviyelerini cihaz ses düzeyine 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 göreli uygulama hacmini SDK'ya statik setUserControlledAppVolume() yöntemiyle bildirebilirsiniz. Geçerli reklam ses seviyesi değerleri 0.0 (sessiz) ile 1.0 (mevcut cihaz ses seviyesi) aralığındadır. Uygulamanın göreli ses düzeyini SDK'ya bildirme örneğini aşağıda bulabilirsiniz:

Kotlin

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

Java

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

  new Thread(
          () -> {
            // Initialize GMA Next-Gen SDK on a background thread.
            MobileAds.initialize(
                this,
                // Sample Ad Manager 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();
}

Uygulama sesinin kapatıldığını SDK'ya bildirmek için setUserMutedApp() yöntemini kullanın:

Kotlin

MobileAds.setUserMutedApp(true)

Java

MobileAds.setUserMutedApp(true);

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

Uygulamanızın özel şartları varsa isteğe bağlı SharedPreferences gad_has_consent_for_cookies ayarını yapabilirsiniz. SDK, gad_has_consent_for_cookies tercihi sıfır olarak ayarlandığında 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();