Setelan Global

Class MobileAds menyediakan setelan global untuk Google Mobile Ads SDK.

Memunculkan peristiwa iklan di thread utama Unity

Google Mobile Ads SDK memunculkan peristiwa pada 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. Tindakan 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;
    }
}

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.

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

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.

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

Pengompresian Android

Opsi publikasi Unity ini memungkinkan Anda mengaktifkan minimisasi kode java. Jika mengaktifkan minifikasi, Anda juga harus membuat file proguard kustom agar class tetap dirujuk oleh SDK.

  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 *; }

Menonaktifkan pelaporan kerusakan

Google Mobile Ads SDK mengumpulkan laporan error untuk tujuan proses debug dan analisis. Anda dapat menonaktifkan pelaporan error ini dengan kode berikut. Bagian berikut menjelaskan cara menonaktifkan pelaporan error di Android dan iOS.

Android

Tambahkan tag <meta-data> dengan DISABLE_CRASH_REPORTING ditetapkan ke true dalam file AndroidManifest.xml aplikasi Anda:

<manifest>
   <application>
       <meta-data
           android:name="com.google.android.gms.ads.flag.DISABLE_CRASH_REPORTING"
           android:value="true" />
   </application>
</manifest>

iOS

Panggil metode DisableSDKCrashReporting untuk menonaktifkan laporan error di iOS:

void Awake() {
  MobileAds.DisableSDKCrashReporting();
}