Mulai

Plugin Google Mobile Ads Unity memungkinkan developer Unity menayangkan iklan seluler Google di aplikasi Android dan 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

• Menggunakan Unity 2019.4 atau yang lebih tinggi
• Untuk men-deploy ke iOS
  • Xcode 15.3 atau yang lebih baru
  • Menargetkan iOS 12.0 atau yang lebih tinggi
  • CocoaPods
• Untuk men-deploy ke Android
  • API level Android minimum 21 atau yang lebih tinggi
  • Menargetkan Android API level 34 atau yang lebih tinggi

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

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

Mengimpor plugin Mobile Ads untuk Unity

OpenUPM-CLI

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

openupm add com.google.ads.mobile

Menghapus .unitypackage aset plugin

Jika bermigrasi dari penggunaan .unitypackage ke 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. Buka setelan pengelola paket dengan memilih opsi menu Unity Edit > Project Settings > Package Manager.

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 dan tekan Install.

Menghapus .unitypackage aset plugin

Jika bermigrasi dari penggunaan .unitypackage ke 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 terbaru dari GitHub.
2. Impor file .unitypackage dengan memilih opsi menu Unity Assets > Import package > Custom Package, lalu mengimpor semua item.

Menyertakan dependensi eksternal

Plugin Google Mobile Ads Unity didistribusikan dengan library Unity Play Services Resolver. Library ini dimaksudkan untuk digunakan oleh plugin Unity apa pun yang memerlukan akses ke library khusus Android, seperti AAR, atau CocoaPods iOS. Hal ini memberi plugin Unity kemampuan untuk mendeklarasikan dependensi, yang kemudian akan otomatis di-resolve dan disalin ke dalam project Unity Anda.

Penting: Gunakan Google Mobile Ads SDK terbaru agar Anda memiliki akses ke semua fitur kepatuhan privasi.

Ikuti langkah-langkah berikut untuk memastikan project Anda menyertakan semua dependensi:

Android

Buka Project Settings > Player > Android > Publishing Settings > Build dan pilih:

• Template Gradle Utama Kustom
• Template Properti Gradle Kustom

Di editor Unity, pilih Assets > External Dependency Manager > Android Resolver > Resolve agar library External Dependency Manager Unity menyalin dependensi yang dideklarasikan ke direktori Assets/Plugins/Android aplikasi Unity Anda.

iOS

Unity untuk iOS menggunakan CocoaPods untuk mengidentifikasi dan mengelola dependensi. Lihat dokumentasi CocoaPods untuk mengetahui persyaratan atau langkah pemecahan masalah tertentu yang terkait dengan dependensi iOS Anda.

Dependensi plugin Google Mobile Ads Unity tercantum di Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml.

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.

Menginisialisasi SDK

Sebelum memuat iklan, aplikasi harus melakukan inisialisasi Google Mobile Ads SDK dengan memanggil MobileAds.Initialize(). Langkah ini hanya perlu dilakukan sekali, idealnya saat peluncuran aplikasi.

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

Berikut adalah contoh cara memanggil Initialize() dalam metode Start() skrip yang dilampirkan ke GameObject:

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(initStatus => { });
    }
}

Jika Anda menggunakan mediasi, tunggu hingga callback terjadi sebelum memuat iklan untuk memastikan semua adaptor mediasi diinisialisasi.

Memilih format iklan

Google Mobile Ads SDK kini disertakan dalam aplikasi Unity Anda saat di-deploy ke platform Android atau iOS. Sekarang Anda 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 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, seperti setelah menyelesaikan level di aplikasi game.

Menerapkan iklan interstisial

Native

Iklan native adalah iklan yang memungkinkan Anda menyesuaikan cara aset seperti judul dan panggilan untuk bertindak ditampilkan di aplikasi Anda. 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, serta menentukan nilai reward dan item 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 permintaan 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

Pembukaan aplikasi

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

Menerapkan iklan layar pembuka aplikasi