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 khusus untuk musik atau efek suara), mengungkapkan volume aplikasi ke Google Mobile Ads SDK memungkinkan iklan video untuk mengikuti 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, akan 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 layar pembuka aplikasi, banner, interstisial, reward, dan interstisial, 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 ini contoh cara melaporkan volume aplikasi relatif ke SDK:

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_my);
    
    MobileAds.initialize(this, new OnInitializationCompleteListener() {
        @Override
        public void onInitializationComplete(InitializationStatus initializationStatus) {}
    });
    
    // Set app volume to be half of current device volume.
    MobileAds.setAppVolume(0.5f);
    ...
}

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)
    
    MobileAds.initialize(this) {}
    
    // 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 akan 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 fitur bisukan audio. 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) saat 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()