Setelan global

Pilih platform: Android iOS Unity Android (Lama)

Class MobileAds menyediakan setelan global untuk .

Memunculkan peristiwa iklan di thread utama Unity

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

Sinkronkan peristiwa iklan dengan thread utama Unity secara manual, atau otomatis, dengan membiarkan 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:

// Google Mobile Ads events are raised off the Unity main thread.

// This log is executed off the Unity main thread.
// Write all time-sensitive code before ExecuteInUpdate().
Debug.Log("Executing off the Unity main thread.");

// Use ExecuteInUpdate to run code on the main thread, allowing you to
// interact with Unity UI and GameObjects.
// Changed to fully-qualified name to resolve CS0103
GoogleMobileAds.Common.MobileAdsEventExecutor.ExecuteInUpdate(() =>
{
    // This callback may be delayed on Android until the user returns to the app.
    Debug.Log("Executing on the Unity main thread.");

    // Place all code that interacts with Unity UI and GameObjects inside this callback.
    if (_myGameObject != null)
    {
        _myGameObject.SetActive(true);
    }
});

Mengotomatiskan sinkronisasi pada peristiwa iklan

Agar 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, mengungkapkan volume aplikasi ke 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 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.

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

// Enable limited ads
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

mengumpulkan laporan error untuk tujuan analisis dan proses debug. Untuk menonaktifkan pelaporan error, lihat bagian berikut untuk Android dan iOS.

Android

Tambahkan tag <meta-data> dengan DISABLE_CRASH_REPORTING yang 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();
}

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

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