Menyiapkan iklan banner

Pilih platform: Android Android iOS Unity Flutter

Tampilan banner adalah iklan gambar atau teks persegi panjang yang menempati tempat 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 Anda baru menggunakan iklan seluler, iklan banner adalah tempat yang tepat untuk memulai. 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 lainnya.

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 untuk 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.

Android

ca-app-pub-3940256099942544/6300978111

iOS

ca-app-pub-3940256099942544/2934735716

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 adapter 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 banner yang akan dimuat.
• AdSize: Ukuran banner yang ingin Anda gunakan.
• AdPosition: Posisi tempat tampilan banner harus ditempatkan.

Catatan: ID unit iklan bergantung pada platform. Gunakan unit iklan iOS untuk membuat permintaan iklan di iOS dan ID unit iklan Android untuk membuat permintaan di Android.

(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

Tips: Anda dapat menggunakan panggilan pemuatan iklan untuk membuat cache iklan pramuat sebelum Anda berencana menayangkannya, sehingga iklan dapat ditayangkan dengan latensi nol saat diperlukan. Karena masa berlaku iklan berakhir setelah satu jam, Anda harus menghapus cache ini dan memuat ulang dengan iklan baru setiap jam.

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 perbarui banner, bukan menghancurkan dan membuat banner baru. Untuk mengetahui detailnya, lihat Memperbarui iklan.

Memperbarui iklan

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

Catatan: Saat menetapkan kecepatan refresh di UI AdMob, refresh otomatis hanya terjadi jika banner terlihat di layar.

Ukuran spanduk

Tabel berikut mencantumkan ukuran banner standar:

Ukuran dalam dp (LxT)	Deskripsi	Ketersediaan	Konstanta AdSize
320x50	Banner Standar	Ponsel dan Tablet	BANNER
320x100	Banner Besar	Ponsel dan Tablet	LARGE_BANNER
300x250	Kotak Sedang IAB	Ponsel dan Tablet	MEDIUM_RECTANGLE
468x60	Banner Ukuran Penuh IAB	Tablet	FULL_BANNER
728x90	Papan Peringkat IAB	Tablet	LEADERBOARD
Lebar yang disediakan x Tinggi adaptif	Banner adaptif	Ponsel dan Tablet	T/A
Lebar layar x 32|50|90	Banner smart	Ponsel dan Tablet	SMART_BANNER
Pelajari lebih lanjut Banner Adaptif, yang dimaksudkan untuk menggantikan Banner Smart.

Catatan: Jika aplikasi Android mencoba memuat banner yang terlalu besar untuk tata letaknya, SDK tidak akan menampilkannya, tetapi akan mencatat pesan error.

Referensi lainnya

• Contoh HelloWorld: Implementasi minimal semua format iklan.

• Contoh kasus penggunaan