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 di thread yang berbeda dengan thread utama Unity. Jika Anda menerapkan peristiwa iklan dan berinteraksi dengan objek Unity, Anda harus menyinkronkan peristiwa Mobile Ads SDK dengan thread utama Unity.

Sinkronkan peristiwa iklan dengan thread utama Unity secara manual, atau otomatis, dengan membiarkan Google Mobile Ads SDK menangani sinkronisasi.

Menyinkronkan peristiwa iklan secara manual

Untuk menyinkronkan peristiwa iklan, gunakan metode ExecuteInUpdate secara manual di thread utama. Anda harus menggunakan metode ini saat properti RaiseAdEventsOnUnityMainThread dinonaktifkan dan berinteraksi dengan objek UnityEngine.

Contoh berikut mencatat thread latar belakang dan menjalankan tindakan untuk berinteraksi dengan objek UnityEngine:

rewardedAd.OnAdPaid += (AdValue value) =>
{
    // Log the ad value immediately.
    UnityEngine.Debug.Log($"Received ad value of {value.Value} {value.CurrencyCode}.");

    MobileAdsEventExecutor.ExecuteInUpdate(() =>
    {
        // Interact with UnityEngine objects here.
    });
};

Mengotomatiskan sinkronisasi pada peristiwa iklan

Agar Google Mobile Ads SDK menyinkronkan peristiwa iklan, tetapkan properti MobileAds.RaiseAdEventsOnUnityMainThread ke true:

...
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 kustom untuk musik atau efek suara, pengungkapan volume aplikasi ke Google Mobile Ads SDK memungkinkan iklan video mematuhi 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 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() sebelum memuat iklan. 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 disetel ke senyap, panggil metode SetApplicationMuted() sebelum memuat iklan:

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

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

Izin untuk cookie

Jika aplikasi Anda memiliki persyaratan khusus, Anda dapat menyetel 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);

Pengecilan Android

Opsi penerbitan Unity ini memungkinkan Anda mengaktifkan penyusutan kode java. Jika mengaktifkan pengecilan, Anda juga perlu membuat file proguard kustom untuk menyimpan class yang dirujuk oleh SDK.

1. Aktifkan 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 error

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.

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

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

Mendapatkan versi plugin Unity

Untuk mendapatkan versi Unity SDK, jalankan perintah berikut:

// Get the unity SDK version.
Debug.Log("Unity SDK Version: " + MobileAds.GetVersion());

Mendapatkan versi platform

Google Mobile Ads SDK untuk Unity bergantung pada SDK platform Android dan iOS. Untuk mendapatkan versi SDK platform, jalankan perintah berikut:

// Get the underlying platform SDK version.
Debug.Log("Platform SDK Version: " + MobileAds.GetPlatformVersion());