Tampilan banner adalah iklan teks atau gambar persegi panjang yang menempati tempat di layar. Iklan tetap berada di layar saat pengguna berinteraksi dengan aplikasi, dan dapat memuat 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 dan petunjuk kode, panduan ini juga menyertakan informasi tentang cara menentukan ukuran banner dengan benar dan link ke referensi tambahan.
Prasyarat
- Selesaikan Panduan memulai.
Selalu uji dengan iklan percobaan
Kode contoh berikut berisi ID unit iklan yang dapat Anda gunakan untuk meminta iklan percobaan. Format 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 unit iklan Anda sendiri ID untuk digunakan di aplikasi Anda, secara eksplisit konfigurasi perangkat Anda sebagai pengujian perangkat selama pengembangan produk.
Android
ca-app-pub-3940256099942544/6300978111
iOS
ca-app-pub-3940256099942544/2934735716
Melakukan inisialisasi Mobile Ads SDK
Sebelum memuat iklan, minta aplikasi Anda melakukan inisialisasi Mobile Ads SDK dengan memanggil
MobileAds.Initialize()
. Tindakan ini hanya perlu dilakukan sekali, idealnya saat aplikasi diluncurkan.
using GoogleMobileAds;
using GoogleMobileAds.Api;
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
public void Start()
{
// Initialize the Google Mobile Ads SDK.
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 sebagai ini akan memastikan bahwa semua adaptor mediasi diinisialisasi.
Contoh BannerView
Kode contoh di bawah menjelaskan cara menggunakan tampilan banner. Dalam contoh ini, Anda
membuat instance tampilan banner, menggunakan
AdRequest
untuk memuat iklan ke dalam tampilan banner, lalu
memperluas kemampuannya dengan menangani peristiwa siklus proses.
Membuat tampilan banner
Langkah pertama dalam menggunakan tampilan banner adalah membuat instance tampilan banner
dalam skrip C# yang dilampirkan ke GameObject
.
// These ad units are configured to always serve test ads.
#if UNITY_ANDROID
private string _adUnitId = "ca-app-pub-3940256099942544/6300978111";
#elif UNITY_IPHONE
private string _adUnitId = "ca-app-pub-3940256099942544/2934735716";
#else
private string _adUnitId = "unused";
#endif
BannerView _bannerView;
/// <summary>
/// Creates a 320x50 banner view at top of the screen.
/// </summary>
public void CreateBannerView()
{
Debug.Log("Creating banner view");
// If we already have a banner, destroy the old one.
if (_bannerView != null)
{
DestroyAd();
}
// Create a 320x50 banner at top of the screen
_bannerView = new BannerView(_adUnitId, AdSize.Banner, AdPosition.Top);
}
Konstruktor untuk BannerView
memiliki hal berikut
parameter:
adUnitId
: ID unit iklan tempatBannerView
akan memuat iklan.AdSize
: Ukuran iklan yang ingin Anda gunakan. Lihat Ukuran banner untuk mengetahui detailnya.AdPosition
: Posisi tempat tampilan banner harus ditempatkan. EnumAdPosition
mencantumkan nilai posisi iklan yang valid.
Perhatikan cara berbagai unit iklan digunakan, bergantung pada platformnya. Anda perlu menggunakan unit iklan iOS untuk membuat permintaan iklan di iOS dan unit iklan Android untuk membuat permintaan di Android.
(Opsional) Membuat tampilan banner dengan posisi kustom
Untuk kontrol yang lebih besar atas lokasi BannerView
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(_adUnitId, AdSize.Banner, 0, 50);
Sudut kiri atas BannerView
adalah
diposisikan pada nilai x dan y yang diteruskan ke konstruktor, dengan asalnya adalah
kiri atas layar.
(Opsional) Membuat tampilan banner dengan ukuran kustom
Selain menggunakan konstanta AdSize
, Anda juga dapat menentukan ukuran kustom
untuk iklan Anda:
// Use the AdSize argument to set a custom size for the ad.
AdSize adSize = new AdSize(250, 250);
_bannerView = new BannerView(_adUnitId, adSize, AdPosition.Bottom);
Memuat iklan banner
Untuk memuat iklan, buat AdRequest
dan teruskan ke
metode LoadAd()
.
/// <summary>
/// Creates the banner view and loads a banner ad.
/// </summary>
public void LoadAd()
{
// create an instance of a banner view first.
if(_bannerView == null)
{
CreateBannerView();
}
// create our request used to load the ad.
var adRequest = new AdRequest();
// send the request to load the ad.
Debug.Log("Loading banner ad.");
_bannerView.LoadAd(adRequest);
}
Memproses peristiwa tampilan banner
Untuk menyesuaikan perilaku iklan, Anda dapat menghubungkan ke sejumlah peristiwa dalam daur hidup iklan, seperti pemuatan, pembukaan, atau penutupan. Untuk mendengarkan peristiwa, daftarkan delegasi:
/// <summary>
/// listen to events the banner view may raise.
/// </summary>
private void ListenToAdEvents()
{
// Raised when an ad is loaded into the banner view.
_bannerView.OnBannerAdLoaded += () =>
{
Debug.Log("Banner view loaded an ad with response : "
+ _bannerView.GetResponseInfo());
};
// Raised when an ad fails to load into the banner view.
_bannerView.OnBannerAdLoadFailed += (LoadAdError error) =>
{
Debug.LogError("Banner view failed to load an ad with error : "
+ error);
};
// Raised when the ad is estimated to have earned money.
_bannerView.OnAdPaid += (AdValue adValue) =>
{
Debug.Log(String.Format("Banner view paid {0} {1}.",
adValue.Value,
adValue.CurrencyCode));
};
// Raised when an impression is recorded for an ad.
_bannerView.OnAdImpressionRecorded += () =>
{
Debug.Log("Banner view recorded an impression.");
};
// Raised when a click is recorded for an ad.
_bannerView.OnAdClicked += () =>
{
Debug.Log("Banner view was clicked.");
};
// Raised when an ad opened full screen content.
_bannerView.OnAdFullScreenContentOpened += () =>
{
Debug.Log("Banner view full screen content opened.");
};
// Raised when the ad closed full screen content.
_bannerView.OnAdFullScreenContentClosed += () =>
{
Debug.Log("Banner view full screen content closed.");
};
}
Menghancurkan tampilan banner
Setelah selesai menggunakan tampilan banner, pastikan untuk memanggil Destroy()
untuk melepaskan
resource.
/// <summary>
/// Destroys the banner view.
/// </summary>
public void DestroyAd()
{
if (_bannerView != null)
{
Debug.Log("Destroying banner view.");
_bannerView.Destroy();
_bannerView = null;
}
}
Selesai. Aplikasi Anda sekarang siap menampilkan iklan banner.
Ukuran spanduk
Tabel di bawah mencantumkan ukuran banner standar.
Ukuran dalam dp (WxT) | Deskripsi | Ketersediaan | Konstanta AdSize |
---|---|---|---|
320x50 | Spanduk Standar | Ponsel dan Tablet | BANNER |
320x100 | Banner Besar | Ponsel dan Tablet | LARGE_BANNER |
300x250 | Persegi Panjang 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 cerdas | Ponsel dan Tablet | SMART_BANNER |
Pelajari Banner Adaptif lebih lanjut, yang dimaksudkan untuk menggantikan Banner Cerdas. |
Referensi lainnya
- Contoh HelloWorld: Implementasi minimal dari semua format iklan.