Iklan banner yang dapat diciutkan adalah iklan banner yang awalnya ditampilkan sebagai overlay yang lebih besar, dengan tombol untuk menciutkannya ke ukuran banner yang diminta sebelumnya. Iklan banner yang dapat diciutkan dimaksudkan untuk meningkatkan performa iklan anchor yang berukuran lebih kecil. Panduan ini menunjukkan cara mengaktifkan iklan banner yang dapat diciutkan untuk penempatan banner yang ada.
Prasyarat
- Selesaikan panduan memulai iklan banner.
Penerapan
Pastikan tampilan banner ditentukan dengan ukuran yang Anda inginkan untuk pengguna dalam status banner biasa (dalam keadaan diciutkan). Sertakan parameter tambahan dalam permintaan
iklan dengan collapsible
sebagai kunci dan penempatan iklan sebagai nilai.
Penempatan yang dapat diciutkan menentukan cara anchor wilayah yang diperluas ke iklan banner.
Nilai Placement
|
Perilaku | Kasus penggunaan yang dimaksud |
---|---|---|
top |
Bagian atas iklan yang diperluas sejajar dengan bagian atas iklan yang diciutkan. | Iklan ditempatkan di bagian atas layar. |
bottom |
Bagian bawah iklan yang diperluas sejajar dengan bagian bawah iklan yang diciutkan. | Iklan ini ditempatkan di bagian bawah layar. |
Jika iklan yang dimuat adalah banner yang dapat diciutkan, banner tersebut langsung menampilkan overlay yang dapat diciutkan setelah ditempatkan dalam hierarki tampilan.
Java
private void loadBannerAd() {
adView = new AdView(this);
adView.setAdUnitId("ca-app-pub-3940256099942544/2014213617")
AdSize adSize = getAdSize();
adView.setAdSize(adSize);
// Create an extra parameter that aligns the bottom of the expanded ad to
// the bottom of the bannerView.
Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
AdRequest adRequest = new AdRequest.Builder()
.addNetworkExtrasBundle(AdMobAdapter.class, extras)
.build();
adView.loadAd(adRequest);
}
Kotlin
private fun loadBanner() {adView = AdView(this);
adView.adUnitId = "ca-app-pub-3940256099942544/2014213617"
adView.setAdSize(adSize)
// Create an extra parameter that aligns the bottom of the expanded ad to
// the bottom of the bannerView.
val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest = AdRequest.Builder()
.addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
.build()
adView.loadAd(adRequest)
}
Perilaku pembaruan iklan
Memuat ulang iklan banner yang dapat diciutkan agar muncul setiap 30 hingga 120 detik mungkin terlalu sering, sehingga menyebabkan pengalaman pengguna yang menjengkelkan. Untuk aplikasi yang mengonfigurasi pemuatan ulang otomatis di antarmuka web Ad Manager, sebaiknya hanya tampilkan permintaan iklan pertama sebagai dapat diciutkan, dan iklan banner berikutnya yang dimuat ulang berikutnya di slot tersebut dengan ukuran permintaan asli. Untuk
melakukannya, teruskan UUID sebagai collapsible_request_id
ke permintaan iklan:
Java
extras.putString("collapsible_request_id", UUID.randomUUID().toString());
Kotlin
extras.putString("collapsible_request_id", UUID.randomUUID().toString())
Jika Anda ingin memuat iklan banner lain yang dapat diciutkan nanti dalam sesi yang sama, Anda dapat memuat iklan secara manual dengan permintaan yang berisi parameter 'dapat diciutkan'.
Periksa apakah iklan yang dimuat dapat diciutkan
Panggil isCollapsible
untuk memeriksa apakah banner terakhir yang dimuat dapat diciutkan.
Jika permintaan gagal dimuat dan banner sebelumnya dapat diciutkan, API akan menampilkan true (benar).
Java
public void onAdLoaded() {
Log.i(TAG, String.format("The last loaded banner is %scollapsible.", adView.isCollapsible() ? "" : "not "));
}
Kotlin
fun onAdLoaded() {
Log.i(TAG, "The last loaded banner is ${if (adView.isCollapsible) "" else "not "}collapsible.")
}
Mediasi
Iklan banner yang dapat diciutkan hanya tersedia untuk permintaan Google selama periode beta. Iklan yang ditayangkan melalui mediasi akan tampil seperti iklan banner biasa yang tidak dapat diciutkan.
Perilaku penayangan iklan
Untuk memaksimalkan performa iklan banner, iklan yang tidak mendukung overlay berukuran lebih besar yang dapat diciutkan dapat menampilkan beberapa permintaan banner yang dapat diciutkan dan langsung dirender dalam ukuran banner standar.