Menyiapkan iklan banner

Tampilan banner adalah iklan gambar atau teks persegi panjang yang menempati ruang di layar. Iklan banner tetap muncul di layar saat pengguna berinteraksi dengan aplikasi, dan iklan dapat dimuat ulang secara otomatis setelah jangka waktu tertentu. Jika periklanan seluler merupakan hal yang baru bagi Anda, iklan Banner adalah pilihan pertama yang baik. Studi kasus.

Panduan ini menunjukkan cara mengintegrasikan tampilan banner ke dalam aplikasi Unity. Selain cuplikan kode dan petunjuk, panduan ini juga menyertakan informasi tentang cara menentukan ukuran banner dengan benar dan link ke referensi tambahan.

Prasyarat

Sebelum melanjutkan, siapkan Google Mobile Ads Unity Plugin.

Selalu melakukan pengujian dengan iklan percobaan

Contoh kode berikut berisi ID unit iklan yang dapat Anda gunakan untuk meminta iklan percobaan. ID unit iklan ini telah dikonfigurasi secara khusus agar menampilkan iklan percobaan, bukan iklan produksi, untuk setiap permintaan, sehingga aman digunakan.

Namun, setelah Anda mendaftarkan aplikasi di antarmuka web AdMob dan membuat ID unit iklan Anda sendiri untuk digunakan di aplikasi, konfigurasikan perangkat Anda secara eksplisit sebagai perangkat pengujian selama pengembangan.

Melakukan inisialisasi Google Mobile Ads Unity Plugin

Sebelum memuat iklan, pastikan aplikasi Anda melakukan inisialisasi Google Mobile Ads Unity Plugin dengan memanggil MobileAds.Initialize(). Hal ini hanya perlu dilakukan sekali, idealnya saat aplikasi diluncurkan.

using GoogleMobileAds;
using GoogleMobileAds.Api;

public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize Google Mobile Ads Unity Plugin.
        MobileAds.Initialize((InitializationStatus initStatus) =>
        {
            // This callback is called once the MobileAds SDK is initialized.
        });
    }
}

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

Contoh BannerView

Contoh kode berikut menjelaskan cara menggunakan tampilan banner. Dalam contoh ini, buat instance tampilan banner, gunakan AdRequest untuk memuat iklan ke dalam tampilan banner, lalu perluas kemampuannya dengan menangani peristiwa siklus proses.

Membuat tampilan banner

Langkah pertama dalam menggunakan tampilan banner adalah membuat instance tampilan banner.

// Create a 320x50 banner at top of the screen.
bannerView = new BannerView("AD_UNIT_ID", AdSize.Banner, AdPosition.Top);
BannerViewSnippets.cs

Ganti AD_UNIT_ID dengan ID unit iklan Anda.

Konstruktor untuk BannerView memiliki parameter berikut:

• adUnitId: ID unit iklan dari iklan banner yang akan dimuat.
• AdSize: Ukuran banner yang ingin Anda gunakan.
• AdPosition: Posisi tempat tampilan banner harus ditempatkan.

(Opsional) Membuat tampilan banner dengan posisi kustom

Untuk kontrol yang lebih besar atas tempat tampilan banner ditempatkan di layar daripada yang ditawarkan oleh nilai AdPosition, gunakan konstruktor yang memiliki koordinat x dan y sebagai parameter:

// Create a 320x50 banner views at coordinate (0,50) on screen.
bannerView = new BannerView("AD_UNIT_ID", AdSize.Banner, 0, 50);
BannerViewSnippets.cs

Pojok kiri atas tampilan banner diposisikan pada nilai x dan y yang diteruskan ke konstruktor, dengan asal adalah kiri atas layar.

(Opsional) Membuat tampilan banner dengan ukuran kustom

Selain menggunakan konstanta AdSize, Anda juga dapat menentukan ukuran kustom untuk iklan:

// Create a 250x250 banner at the bottom of the screen.
AdSize adSize = new AdSize(250, 250);
bannerView = new BannerView("AD_UNIT_ID", adSize, AdPosition.Bottom);
BannerViewSnippets.cs

Memuat iklan banner

Untuk memuat iklan, buat AdRequest dan teruskan ke metode LoadAd().

// Send a request to load an ad into the banner view.
bannerView.LoadAd(new AdRequest());
BannerViewSnippets.cs

Memproses peristiwa tampilan banner

Untuk menyesuaikan perilaku iklan, Anda dapat menghubungkan ke sejumlah peristiwa dalam siklus proses iklan, seperti memuat, membuka, atau menutup. Untuk memproses peristiwa ini, daftarkan delegasi:

bannerView.OnBannerAdLoaded += () =>
{
    // Raised when an ad is loaded into the banner view.
};
bannerView.OnBannerAdLoadFailed += (LoadAdError error) =>
{
    // Raised when an ad fails to load into the banner view.
};
bannerView.OnAdPaid += (AdValue adValue) =>
{
    // Raised when the ad is estimated to have earned money.
};
bannerView.OnAdImpressionRecorded += () =>
{
    // Raised when an impression is recorded for an ad.
};
bannerView.OnAdClicked += () =>
{
    // Raised when a click is recorded for an ad.
};
bannerView.OnAdFullScreenContentOpened += () =>
{
    // Raised when an ad opened full screen content.
};
bannerView.OnAdFullScreenContentClosed += () =>
{
    // Raised when the ad closed full screen content.
};
BannerViewSnippets.cs

Menghancurkan tampilan banner

Untuk menghancurkan banner, panggil metode Destroy() untuk melepaskan resource:

if (bannerView != null)
{
    // Always destroy the banner view when no longer needed.
    bannerView.Destroy();
    bannerView = null;
}
BannerViewSnippets.cs

Untuk banner yang gagal dimuat, sebaiknya muat ulang banner, bukan menghancurkan dan membuat banner baru. Untuk mengetahui detailnya, lihat Memuat ulang iklan.

Memuat ulang iklan

Jika Anda mengonfigurasi unit iklan untuk dimuat ulang, Anda tidak perlu meminta iklan lain saat iklan gagal dimuat. Google Mobile Ads Unity Plugin mematuhi kecepatan muat ulang yang Anda tentukan di UI AdMob. Jika Anda belum mengaktifkan muat ulang, kirim permintaan baru. Untuk mengetahui detail selengkapnya tentang muat ulang unit iklan, seperti menetapkan kecepatan muat ulang, lihat Menggunakan muat ulang otomatis untuk iklan Banner.

Ukuran spanduk

Banner adaptif besar menyediakan format yang lebih besar yang dirancang untuk tata letak non-scroll. Dibandingkan dengan banner adaptif anchor standar, banner ini memungkinkan tinggi maksimum yang lebih tinggi (hingga 20% dari tinggi layar, antara 50 dan 150 dp). Ruang yang lebih besar ini dioptimalkan untuk konten video.

Tabel berikut mencantumkan ukuran banner standar:

Referensi lainnya

• Contoh HelloWorld: Implementasi minimal semua format iklan.

• Contoh kasus penggunaan