Setelan Global

Class MobileAds memberikan setelan global untuk Google Mobile Ads SDK.

Meningkatkan peristiwa iklan di thread utama Unity

Google Mobile Ads SDK memunculkan peristiwa di thread yang berbeda dengan thread utama Unity. Jika menerapkan peristiwa iklan dan berinteraksi dengan objek Unity, Anda harus menyinkronkan peristiwa Mobile Ads SDK dengan thread utama Unity.

Jika Anda ingin Mobile Ads SDK menangani masalah threading ini untuk Anda, tetapkan MobileAds.RaiseAdEventsOnUnityMainThread ke true. Hal ini memaksa SDK untuk memunculkan semua peristiwa dan callback di thread utama Unity.

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // When true all events raised by GoogleMobileAds will be raised
        // on the Unity main thread. The default value is false.
        MobileAds.RaiseAdEventsOnUnityMainThread = true;
    }
}

Catatan: Efek samping dari menaikkan peristiwa di thread utama Unity berarti bahwa peristiwa tertentu seperti OnAdFullScreenContentOpened tidak ditampilkan hingga pengguna kembali ke aplikasi.

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 akan 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.

Anda dapat melaporkan volume aplikasi relatif ke Google Mobile Ads SDK dengan memanggil metode SetApplicationVolume(). 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:

// Set app volume to be half of current device volume.
MobileAds.SetApplicationVolume(0.5f);

Peringatan: Menurunkan volume audio aplikasi akan mengurangi kelayakan iklan video dan dapat mengurangi pendapatan iklan aplikasi Anda. Anda hanya boleh menggunakan metode ini jika aplikasi memberikan kontrol volume kustom kepada pengguna, dan volume pengguna ditampilkan dengan benar dalam aplikasi.

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

// Set app to be muted.
MobileAds.SetApplicationMuted(true);

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

Peringatan: Menonaktifkan aplikasi akan mengurangi kelayakan iklan video dan dapat mengurangi pendapatan iklan aplikasi Anda. Anda hanya boleh menggunakan metode ini jika aplikasi menyediakan kontrol bisukan khusus kepada pengguna, dan keputusan membisukan pengguna ditampilkan dengan benar dalam aplikasi.

Izin cookie

Jika aplikasi Anda memiliki persyaratan khusus, Anda dapat menetapkan kunci ApplicationPreferences opsional gad_has_consent_for_cookies ke nol untuk mengaktifkan iklan terbatas (LTD):

// Enable limited ads (LTD)
ApplicationPreferences.SetInt("gad_has_consent_for_cookies", 0);

Minifikasi Android

Dengan opsi publikasi Unity ini, Anda dapat mengaktifkan minifikasi kode java. Jika mengaktifkan minifikasi, Anda juga perlu membuat file proguard kustom agar class yang direferensikan oleh SDK juga perlu dibuat.

1. Mengaktifkan File Proguard Kustom

   Buka Project Settings > Player > Android > Publishing Settings > Build, lalu pilih:

   • File Proguard Kustom

2. Buka /Assets/Plugins/Android/proguard-user.txt dan tambahkan hal berikut:

-keep class com.google.** { public *; }