Setelan global

Pilih platform: Android Android iOS Unity

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

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

Direkomendasikan: Menyinkronkan peristiwa iklan secara manual

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

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

rewardedAd.OnAdPaid += (AdValue value) =>
{
    // Log the ad value immediately.
    // Place all time-sensitive code outside of ExecuteInUpdate().
    UnityEngine.Debug.Log($"Received ad value of {value.Value} {value.CurrencyCode}.");

    MobileAdsEventExecutor.ExecuteInUpdate(() =>
    {
        // Interact with UnityEngine objects here.
        // This method is delayed, don't put time sensitive code here.
    });
};

Mengotomatiskan sinkronisasi pada peristiwa iklan

Agar Google Mobile Ads SDK menyinkronkan peristiwa iklan, tetapkan MobileAds.RaiseAdEventsOnUnityMainThread properti 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 volume, 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 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 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, 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.

Persetujuan untuk cookie

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

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

Minifikasi Android

Opsi publikasi Unity ini memungkinkan Anda mengaktifkan minifikasi kode Java. Jika mengaktifkan minifikasi, Anda juga harus membuat file proguard kustom untuk menyimpan class yang direferensikan oleh SDK.

1. Mengaktifkan File Proguard Kustom

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

   • Custom Proguard File

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