Menyiapkan iklan banner

Tampilan banner adalah iklan teks atau gambar persegi panjang yang menempati tempat di layar. Iklan ini tetap berada di layar saat pengguna berinteraksi dengan aplikasi, dan 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

Kode contoh berikut berisi ID unit iklan yang dapat Anda gunakan untuk meminta iklan pengujian. 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 sebagai perangkat pengujian secara eksplisit selama pengembangan.

Melakukan inisialisasi Google Mobile Ads Unity Plugin

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

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 bahwa semua adaptor mediasi diinisialisasi.

Contoh BannerView

Kode contoh 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 untuk 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 penempatan tampilan banner 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

Sudut kiri atas tampilan banner diposisikan pada nilai x dan y yang diteruskan ke konstruktor, dengan titik asal berada di 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 mengaitkan ke sejumlah peristiwa dalam siklus proses iklan, seperti pemuatan, pembukaan, atau penutupan. 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 merilis 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 yang 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 refresh yang Anda tentukan di UI AdMob. Jika Anda belum mengaktifkan refresh, kirim permintaan baru. Untuk mengetahui detail selengkapnya tentang pemuatan ulang unit iklan, seperti menetapkan interval pemuatan ulang, lihat Menggunakan pemuatan ulang otomatis untuk iklan Banner.

Ukuran spanduk

Banner adaptif besar menyediakan format yang lebih besar yang dirancang untuk tata letak yang tidak dapat di-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 dari semua format iklan.

• Contoh kasus penggunaan