Setelan Global

Class MobileAds menyediakan setelan global untuk Google Mobile Ads SDK.

Kontrol volume iklan video

Jika aplikasi Anda memiliki kontrol volume sendiri (seperti volume musik kustom atau efek suara), mengungkapkan volume aplikasi ke Google Mobile Ads SDK akan memungkinkan iklan video mengikuti setelan volume aplikasi. Hal ini memastikan pengguna menerima iklan video dengan volume audio yang diharapkan.

Volume perangkat, yang dikontrol melalui tombol volume atau penggeser volume tingkat OS, menentukan volume untuk output audio perangkat. Namun, aplikasi dapat menyesuaikan tingkat volume secara independen terhadap volume perangkat untuk menyesuaikan pengalaman audio. Untuk format iklan layar pembuka aplikasi, banner, interstisial, reward, dan interstisial reward, Anda dapat melaporkan volume aplikasi relatif ke SDK melalui metode setAppVolume() statis. Nilai volume iklan yang valid berkisar dari 0.0 (senyap) hingga 1.0 (volume perangkat saat ini). Berikut adalah contoh cara melaporkan volume aplikasi relatif ke 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();
}

Untuk memberi tahu SDK bahwa volume aplikasi telah dibisukan, gunakan metode setAppMuted():

Kotlin

MobileAds.setAppMuted(true)

Java

MobileAds.setAppMuted(true);

Secara default, volume aplikasi disetel ke 1 (volume perangkat saat ini), dan aplikasi tidak dibisukan.

Catatan: Iklan video yang tidak memenuhi syarat untuk ditampilkan dengan audio yang dibisukan tidak ditampilkan untuk permintaan iklan yang dibuat saat volume aplikasi dilaporkan sebagai dibisukan atau disetel ke nilai 0. Hal ini dapat membatasi penayangan sebagian kumpulan iklan video yang lebih luas.

Iklan native

Lihat VideoOptions untuk mengetahui petunjuk cara mengontrol setelan bisukan. Kontrol volume kustom tidak didukung untuk iklan native.

Izin untuk cookie

Jika aplikasi Anda memiliki persyaratan khusus, Anda dapat menetapkan SharedPreferences gad_has_consent_for_cookies opsional. SDK akan mengaktifkan iklan terbatas (LTD) jika preferensi gad_has_consent_for_cookies disetel ke nol.

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