Mulai

Panduan ini ditujukan untuk 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 memperoleh pendapatan. Setelah integrasi selesai, Anda dapat memilih format iklan (seperti video reward atau native) untuk mendapatkan langkah-langkah implementasi yang mendetail.

Prasyarat

• Menggunakan Unity 2019 atau yang lebih tinggi
• Untuk men-deploy ke iOS
  • Xcode 13.2.1 atau versi yang lebih tinggi
  • Menargetkan iOS 10.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 Mobile Ads Unity

Plugin Google Mobile Ads Unity memungkinkan developer Unity menayangkan Google Mobile Ads di aplikasi Android dan iOS dengan mudah 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.

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

DOWNLOAD DOWNLOAD LIHAT SUMBER

Mengimpor plugin Mobile Ads Unity

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

Pastikan semua file dipilih dan klik Impor.

Sertakan Mobile Ads SDK

Plugin Unity Google Mobile Ads didistribusikan dengan library Resolver Layanan Play Play. Library ini dimaksudkan untuk digunakan oleh plugin Unity apa pun yang memerlukan akses ke library khusus Android (misalnya, AAR) atau CocoaPods iOS. Library ini memberi plugin Unity kemampuan untuk mendeklarasikan dependensi, yang kemudian secara otomatis diselesaikan dan disalin ke 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 direktori Assets/Plugins/Android aplikasi Unity Anda.

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

iOS

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

Catatan: Dependensi iOS diidentifikasi menggunakan CocoaPods. CocoaPods dijalankan sebagai langkah proses pasca-build.

• Saat menggunakan Unity 5.6 dan yang lebih baru, akan dihasilkan xcworkspace 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.

Mengajukan peristiwa iklan pada thread utama Unity

Unity API tidak aman untuk thread dan akan memunculkan pengecualian jika Anda berinteraksi dengan Unity API dari thread latar belakang apa pun. Akibatnya, Anda harus menyinkronkan peristiwa dan callback Mobile Ads SDK dengan thread utama.

Jika ingin Mobile Ads SDK menangani masalah threading ini untuk Anda, Anda dapat menetapkan MobileAds.RaiseAdEventsOnUnityMainThread ke true. Tindakan ini akan memaksa Mobile Ads SDK memunculkan semua peristiwa dan callback di thread utama Unity untuk Anda.

Menginisialisasi Mobile Ads SDK

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

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), setel 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()
    {
        // When true all events raised by GoogleMobileAds will be invoked
        // on the Unity main thread. The default value is false.
        MobileAds.RaiseAdEventsOnUnityMainThread = true;

        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(initStatus => { });
    }
}

Jika Anda menggunakan mediasi, tunggu hingga callback terjadi sebelum memuat iklan, karena tindakan ini akan memastikan bahwa semua adaptor mediasi diinisialisasi.

Pilih format iklan

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

Banner

Iklan banner adalah iklan gambar atau teks persegi panjang yang menempati suatu tempat 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 pengguna menutupnya. Cara 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 di aplikasinya. 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 dengan menggunakan data yang dikumpulkan dari aplikasi yang digunakan pengguna.

Kunci aplikasi yang 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);
    }