Mulai

Panduan ini ditujukan bagi penayang yang ingin memonetisasi aplikasi Unity.

Mengintegrasikan plugin Google Mobile Ads Unity ke dalam aplikasi, yang akan Anda lakukan di sini, adalah langkah pertama untuk menampilkan iklan AdMob dan menghasilkan pendapatan. Setelah integrasi selesai, Anda dapat memilih format iklan (seperti video native atau reward) untuk mendapatkan langkah-langkah implementasi yang mendetail.

Prasyarat

• Menggunakan Unity 2019 atau yang lebih baru
• Untuk men-deploy ke iOS
  • Xcode 14.1 atau versi yang lebih tinggi
  • Menargetkan iOS 11.0 atau yang lebih tinggi
  • CocoaPods
• Untuk men-deploy ke Android
  • Layanan Google Play 18.1.0 atau yang lebih tinggi
  • Menargetkan Android API level 16 atau yang lebih tinggi
• Direkomendasikan: Buat akun AdMob dan daftarkan aplikasi Android dan/atau iOS

Download plugin Unity Mobile Ads

Plugin Unity Google Mobile Ads memungkinkan developer Unity menayangkan Google Mobile Ads dengan mudah 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# dalam project Unity Anda.

Gunakan link di bawah untuk mendownload paket Unity untuk plugin atau melihat kodenya di GitHub.

DOWNLOAD Plugin LIHAT SUMBER

Mengimpor plugin Mobile Ads Unity

Buka project Anda di editor Unity. Pilih Assets > Import Package > Custom Package, lalu temukan file GoogleMobileAdsPlugin.unitypackage yang telah Anda download.

Pastikan semua file dipilih, lalu klik Impor.

Sertakan Mobile Ads SDK

Plugin Unity Google Mobile Ads didistribusikan dengan library Unity Play Resolver Layanan. Library ini dimaksudkan untuk digunakan oleh plugin Unity apa pun yang memerlukan akses ke library khusus Android (mis., AAR) atau CocoaPods iOS. Hal ini memberikan plugin Unity kemampuan untuk mendeklarasikan dependensi, yang kemudian secara otomatis diselesaikan dan disalin ke dalam project Unity Anda.

Ikuti langkah-langkah yang tercantum di bawah untuk memastikan project Anda menyertakan Mobile Ads SDK.

Android

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

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

iOS

Tidak ada langkah tambahan yang diperlukan untuk menyertakan Mobile Ads SDK ke dalam project Unity.

Catatan: Dependensi iOS diidentifikasi menggunakan CocoaPods. CocoaPods berjalan sebagai langkah proses build.

• Saat menggunakan Unity 5.6 dan yang lebih baru, xcworkspace akan dibuat yang menyertakan library dependensi yang diperlukan. Gunakan xcworkspace yang dihasilkan, bukan project Xcode standar.
• Saat menggunakan Unity versi lama, dependensi disertakan dalam project Xcode standar.

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.

Meningkatkan peristiwa iklan di thread utama Unity

Google Mobile Ads SDK terkadang memunculkan peristiwa pada thread yang berbeda dengan thread utama Unity. Hal ini dapat menyebabkan masalah saat berinteraksi dengan objek Unity dari peristiwa yang dikirim dari Google Mobile Ads SDK. Sebagai solusi, Anda mungkin perlu menambahkan kode untuk menyinkronkan peristiwa Mobile Ads SDK dengan thread utama Unity.

Jika Anda ingin Mobile Ads SDK menangani masalah threading ini untuk Anda, tetapkan MobileAds.RaiseAdEventsOnUnityMainThread ke true. Hal ini akan memaksa Mobile Ads SDK memunculkan semua peristiwa dan callback pada thread utama Unity.

...
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;
    }
}

Melakukan inisialisasi Mobile Ads SDK

Sebelum memuat iklan, aplikasi Anda harus menginisialisasi Mobile Ads SDK dengan memanggil MobileAds.Initialize(). Hal ini hanya perlu dilakukan sekali, idealnya saat peluncuran aplikasi.

Peringatan: Iklan dapat dipramuat oleh Mobile Ads SDK atau SDK partner mediasi setelah memanggil MobileAds.Initialize(). Jika Anda perlu mendapatkan izin dari pengguna di Wilayah Ekonomi Eropa (EEA), tetapkan setiap flag khusus permintaan, seperti tagForChildDirectedTreatment atau tag_for_under_age_of_consent, atau ambil tindakan sebelum memuat iklan. Pastikan Anda melakukan hal ini sebelum menginisialisasi 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, karena hal ini akan memastikan bahwa semua adaptor mediasi diinisialisasi.

Pilih format iklan

Mobile Ads SDK kini disertakan di aplikasi Unity Anda saat men-deploy ke platform Android atau iOS. Sekarang Anda siap untuk menerapkan iklan. AdMob menawarkan berbagai format iklan yang berbeda, sehingga Anda dapat memilih salah satu yang paling sesuai dengan kebutuhan pengalaman pengguna Anda.

Banner

Iklan banner adalah iklan gambar atau teks persegi panjang yang menempati lokasi dalam tata letak aplikasi. Iklan ini tetap berada di layar saat pengguna berinteraksi dengan aplikasi, dan dapat diperbarui secara otomatis setelah jangka waktu tertentu. Jika periklanan seluler merupakan hal yang baru bagi Anda, iklan Banner adalah pilihan pertama yang baik.

Menerapkan Banner

Interstisial

Interstisial adalah iklan layar penuh yang menutupi antarmuka aplikasi hingga ditutup oleh pengguna. Fitur ini paling baik digunakan saat jeda alami dalam alur eksekusi aplikasi, seperti di antara level game atau tepat setelah menyelesaikan tugas.

Menerapkan Interstisial

Native

Native adalah format iklan berbasis komponen yang memberi Anda kebebasan untuk menyesuaikan cara aset seperti judul dan pesan ajakan (CTA) ditampilkan dalam aplikasi mereka. Dengan memilih sendiri font, warna, dan detail lainnya, Anda dapat membuat presentasi iklan yang alami dan tidak mengganggu untuk memperkaya pengalaman pengguna.

Menerapkan Iklan Native

Diberikan sebagai reward

Iklan video reward adalah iklan video layar penuh yang dapat ditonton pengguna dengan imbalan reward dalam aplikasi.

Menerapkan Iklan Reward

Meminta otorisasi transparansi pelacakan aplikasi

Untuk menampilkan permintaan otorisasi transparansi pelacakan aplikasi (ATT) untuk mengakses IDFA, gunakan paket Dukungan Iklan iOS 14 Unity.

Kunci aplikasi sama

Prasyarat: Plugin Google Mobile Ads Unity 6.1.0 atau yang lebih tinggi

Google Mobile Ads SDK memperkenalkan kunci aplikasi yang sama untuk membantu Anda menayangkan iklan yang lebih relevan dan dipersonalisasi menggunakan data yang dikumpulkan dari aplikasi yang digunakan pengguna.

Kunci aplikasi sama diaktifkan secara default, tetapi Anda dapat menonaktifkannya dengan API berikut:

public void Start()
    {
        RequestConfiguration requestConfiguration =
            new RequestConfiguration.Builder()
            .SetSameAppKeyEnabled(true).build();
        MobileAds.SetRequestConfiguration(requestConfiguration);

        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(HandleInitCompleteAction);
    }