Setelan Global

Class MobileAds memberikan setelan global untuk Google Mobile Ads SDK.

Kontrol volume iklan video

Jika aplikasi Anda memiliki kontrol volume sendiri (seperti musik khusus atau volume efek suara), mengungkapkan volume aplikasi ke Google Mobile Ads SDK memungkinkan iklan video untuk mematuhi setelan volume aplikasi. Tindakan 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 relatif terhadap volume perangkat untuk menyesuaikan pengalaman audio. Untuk format iklan interstisial reward di layar pembuka aplikasi, banner, interstisial, dan 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:

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

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

Java

MobileAds.setAppMuted(true);

Kotlin

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 jika volume aplikasi dilaporkan sebagai dibisukan atau disetel ke nilai 0. Hal ini dapat membatasi penayangan sebagian dari kumpulan iklan video yang lebih luas.

Iklan native

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

Izin 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 ditetapkan ke nol.

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