Menyiapkan Plugin Google Mobile Ads Unity

Pilih platform: Android iOS Unity Flutter Android (Legacy)

Plugin Google Mobile Ads Unity memungkinkan developer Unity menayangkan iklan seluler Google di aplikasi Android dan aplikasi iOS tanpa harus menulis kode Java atau Objective-C. Plugin ini menyediakan antarmuka C# untuk meminta iklan yang digunakan oleh skrip C# di project Unity Anda.

Panduan ini ditujukan untuk penayang yang ingin memonetisasi aplikasi Unity.

Prasyarat

• Gunakan Unity Editor 2019.4 atau yang lebih tinggi.
  • Sebaiknya gunakan versi 2022.2 atau yang lebih tinggi.
• Untuk men-deploy ke iOS
  • Xcode 16.0 atau yang lebih tinggi
  • Targetkan iOS 13.0 atau yang lebih tinggi
  • CocoaPods
• Untuk men-deploy ke Android
  • Android API level minimum 24 atau yang lebih tinggi
  • Targetkan Android API level 35 atau yang lebih tinggi

• Direkomendasikan: Buat akun AdMob dan daftarkan aplikasi Android atau iOS

Android API level ditetapkan di Setelan Project > Player > Android > Other Settings > Other Settings.

Mengimpor plugin Mobile Ads for Unity

OpenUPM-CLI

Jika telah menginstal OpenUPM CLI, Anda dapat menginstal registry OpenUPM dengan perintah berikut:

openupm add com.google.ads.mobile

Menghapus aset plugin .unitypackage

Jika bermigrasi dari penggunaan .unitypackage ke penggunaan OpenUPM, Anda harus meng-uninstal aset secara manual dari lokasi lama. Hapus direktori berikut yang diimpor dari .unitypackage:

• Assets/ExternalDependencyManager
• Assets/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM dengan UI

1. Buka setelan pengelola paket dengan memilih opsi menu Unity Edit > Setelan Project > Pengelola Paket.

2. Tambahkan OpenUPM sebagai registry cakupan ke jendela Package Manager:

   Name: OpenUPM
   URL: https://package.openupm.com
   Scopes: com.google
   

3. Buka menu pengelola paket dengan memilih opsi menu Unity Window > Package Manager.

4. Tetapkan drop-down cakupan pengelola untuk memilih My Registries.

   

5. Pilih paket Google Mobile Ads for Unity dari daftar paket, lalu tekan Install.

Menghapus aset plugin .unitypackage

Jika bermigrasi dari penggunaan .unitypackage ke penggunaan OpenUPM, Anda harus meng-uninstal aset secara manual dari lokasi lama. Hapus direktori berikut yang diimpor dari .unitypackage:

• Assets/ExternalDependencyManager
• Assets/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM

1. Ambil tag versi rilis terbaru. Tag yang ditampilkan, tidak termasuk awalan v, adalah versi Google Mobile Ads Unity Plugin.

   • macOS dan Linux

     curl -sS https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest | jq -r '.tag_name'

   • Windows PowerShell

     (Invoke-RestMethod -Uri "https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest").tag_name
     

2. Ubah file Packages/manifest.json untuk menambahkan registry dan dependensi cakupan OpenUPM menggunakan versi yang diperoleh dari perintah sebelumnya:

   {
     "scopedRegistries": [
       {
         "name": "google",
         "url": "https://package.openupm.com",
         "scopes": [
           "com.google"
         ]
       }
     ],
     "dependencies": {
       "com.google.ads.mobile": "11.6.0"
     }
   }
   

Menghapus aset plugin .unitypackage

Jika bermigrasi dari penggunaan .unitypackage ke penggunaan OpenUPM, Anda harus meng-uninstal aset secara manual dari lokasi lama. Hapus direktori berikut yang diimpor dari .unitypackage:

• Assets/ExternalDependencyManager
• Assets/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

Mengimpor dari GitHub

1. Download rilis .unitypackage dari GitHub.
2. Impor file .unitypackage dengan memilih opsi menu Unity Assets > Import package > Custom Package dan mengimpor semua item.

Opsional: Menonaktifkan Pengelola Dependensi Eksternal

Jika mengelola library Android dan iOS dengan alat build Anda sendiri, Anda dapat menonaktifkan paket com.unity.external-dependency-manager:

Di Unity Editor, pilih Window > Package Manager dan hapus paket External Dependency Manager (com.unity.external-dependency-manager). Menghapus paket ini akan menghapus centang pada Enable External Dependency Manager di Assets > Google Mobile Ads > Settings.

Catatan: Menghapus file GoogleMobileAdsSettings.asset akan mereset setelan Anda dan menginstal ulang paket com.unity.external-dependency-manager pada pemuatan Editor atau impor berikutnya. Untuk menginstal ulang paket nanti, pilih Assets > Google Mobile Ads > Settings dan pilih Enable External Dependency Manager.

Menginstal Pengelola Dependensi Eksternal lama

Jika project Anda menggunakan Unity 2022.2 atau yang lebih lama, Anda dapat menginstal paket com.google.external-dependency-manager lama Google setelah menonaktifkan paket Unity:

• Download file .unitypackage terbaru dari halaman rilis Pengelola Dependensi Eksternal untuk Unity dan pilih Assets > Import Package > Custom Package.

• Jalankan perintah OpenUPM CLI berikut:

  openupm add com.google.external-dependency-manager

Mengonfigurasi dependensi native secara manual

Jika tidak menggunakan paket Pengelola Dependensi Eksternal, tambahkan library yang diperlukan dari file Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml dan Assets/GoogleMobileAds/Editor/GoogleUmpDependencies.xml ke file build Anda:

• Untuk Android, pilih Edit > Setelan Project > Player > Android > Publishing Settings > Build dan aktifkan Custom Main Gradle Template. Tambahkan library yang diperlukan dari file GoogleMobileAdsDependencies.xml dan GoogleUmpDependencies.xml ke blok dependencies di file Assets/Plugins/Android/mainTemplate.gradle:

  implementation 'com.google.android.gms:play-services-ads:25.5.0'
  implementation 'com.google.android.ump:user-messaging-platform:4.0.0'
  

  Tambahkan juga paket androidx.constraintlayout:constraintlayout, androidx.lifecycle:lifecycle-process, dan androidx.fragment:fragment menggunakan versi di file GoogleMobileAdsDependencies.xml.

• Untuk iOS, ekspor project Xcode Anda. Tambahkan pod yang diperlukan dari file GoogleMobileAdsDependencies.xml dan GoogleUmpDependencies.xml ke file Podfile di folder project yang diekspor:

  pod 'Google-Mobile-Ads-SDK'
  pod 'GoogleUserMessagingPlatform'
  

  Kemudian, jalankan perintah berikut di folder project iOS yang diekspor:

  pod install --repo-update

Menetapkan ID aplikasi AdMob

Di editor Unity, pilih Assets > Google Mobile Ads > Settings dari menu.

Masukkan ID aplikasi AdMob Android dan iOS Anda di setiap kolom.

Google Mobile Ads Unity Plugin menyimpan setelan ini sebagai teks dalam file konfigurasi Assets/GoogleMobileAds/Resources/GoogleMobileAdsSettings.asset.

Menginisialisasi SDK

Sebelum memuat iklan, pastikan aplikasi Anda menginisialisasi Google Mobile Ads Unity Plugin dengan memanggil MobileAds.Initialize(). Tindakan ini hanya perlu dilakukan sekali, sebaiknya saat peluncuran aplikasi.

Peringatan: Iklan dapat dipramuat oleh Google Mobile Ads Unity Plugin atau partner mediasi SDK setelah memanggil MobileAds.Initialize(). Jika Anda perlu mendapatkan izin dari pengguna di Wilayah Ekonomi Eropa (EEA), Inggris Raya (UK), atau Swiss, tetapkan flag khusus permintaan, seperti tagForChildDirectedTreatment atau tag_for_under_age_of_consent, atau lakukan tindakan lain sebelum memuat iklan. Pastikan Anda melakukannya sebelum menginisialisasi Google Mobile Ads Unity Plugin.

Berikut contoh cara memanggil MobileAds.Initialize():

MobileAds.Initialize((InitializationStatus initstatus) =>
{
    if (initstatus == null)
    {
        Debug.LogError("Google Mobile Ads initialization failed.");
        return;
    }

    Debug.Log("Google Mobile Ads initialization complete.");

    MobileAdsEventExecutor.ExecuteInUpdate(() =>
    {
        // Interact with UnityEngine objects on the main thread here.
    });
});
GoogleMobileAdsController.cs

Berinteraksi dengan objek Unity di thread utama

Google Mobile Ads Unity Plugin memunculkan peristiwa iklan di thread latar belakang. Jika callback iklan berinteraksi dengan objek Unity, seperti UnityEngine, jadwalkan pekerjaan tersebut secara eksplisit di thread utama Unity menggunakan metode MobileAdsEventExecutor.ExecuteInUpdate. Untuk mengetahui detail penerapan, lihat Memunculkan peristiwa iklan di thread utama Unity.

Memilih format iklan

Google Mobile Ads Unity Plugin kini disertakan dalam aplikasi Unity Anda saat men-deploy ke platform Android atau iOS. Anda kini siap menerapkan iklan. AdMob menawarkan berbagai format iklan yang berbeda, sehingga Anda dapat memilih format yang memberikan pengalaman pengguna terbaik.

Banner

Unit iklan banner menampilkan iklan persegi panjang yang menempati sebagian tata letak aplikasi. Iklan ini dapat otomatis diperbarui setelah jangka waktu tertentu. Artinya, pengguna akan melihat iklan baru secara berkala, meskipun mereka tetap berada di layar yang sama di aplikasi Anda. Unit iklan banner juga merupakan format iklan yang paling mudah untuk diterapkan.

Menerapkan iklan banner

Interstisial

Unit iklan interstisial menampilkan iklan satu halaman penuh di aplikasi. Tempatkan iklan ini pada jeda dan transisi yang alami di antarmuka aplikasi Anda, misalnya setelah menyelesaikan level dalam aplikasi game.

Menerapkan iklan interstisial

Native

Iklan native adalah iklan yang memungkinkan Anda menyesuaikan cara aset seperti judul dan ajakan (call to action) ditampilkan di aplikasi. Dengan menata gaya iklan sendiri, Anda dapat membuat tampilan iklan yang tampak alami dan tidak mengganggu untuk memperkaya pengalaman pengguna.

Menerapkan iklan native

Reward

Unit iklan reward memungkinkan pengguna bermain game, mengikuti survei, atau menonton video untuk mendapatkan reward dalam aplikasi, seperti koin, nyawa tambahan, atau poin. Anda dapat menetapkan reward yang berbeda untuk unit iklan yang berbeda, dan menentukan item dan nilai reward yang diterima pengguna.

Menerapkan iklan reward

Interstisial reward

Interstisial reward adalah jenis format iklan berinsentif yang baru yang memungkinkan Anda menawarkan reward, seperti koin atau nyawa tambahan, untuk iklan yang muncul otomatis selama transisi aplikasi secara alami.

Berbeda dengan iklan reward, pengguna tidak diwajibkan untuk memilih melihat interstisial reward.

Sebagai ganti dialog keikutsertaan pada iklan reward, interstisial reward memerlukan layar pengantar yang mengumumkan reward dan memberikan pengguna kesempatan untuk memilih tidak ikut jika mereka menginginkannya.

Menerapkan iklan interstisial reward

Layar pembuka aplikasi

Layar pembuka aplikasi adalah format iklan yang muncul saat pengguna membuka atau beralih kembali ke aplikasi Anda. Overlay iklan akan ditempatkan di layar pemuatan.

Menerapkan iklan di layar pembuka aplikasi