Iklan banner yang dapat diciutkan

Iklan banner yang dapat diciutkan adalah iklan banner yang mula-mula disajikan dengan overlay, dengan tombol untuk menciutkannya ke ukuran banner yang diminta sebelumnya. Iklan banner yang dapat diciutkan dimaksudkan untuk meningkatkan performa iklan anchor yang jika tidak memiliki ukuran yang lebih kecil. Panduan ini menunjukkan cara mengaktifkan banner yang dapat diciutkan untuk penempatan iklan banner yang ada.

Prasyarat

Penerapan

Pastikan tampilan banner Anda ditentukan dengan ukuran yang Anda inginkan agar dilihat pengguna dalam status banner reguler (diciutkan). Sertakan parameter tambahan dalam permintaan iklan dengan collapsible sebagai kunci dan penempatan iklan sebagai nilai.

Penempatan yang dapat diciutkan menentukan cara wilayah yang diperluas di-anchor ke iklan banner.

Nilai Placement Perilaku Kasus penggunaan yang dimaksudkan
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 ditempatkan di bagian bawah layar.

Jika iklan yang dimuat adalah banner yang dapat diciutkan, banner tersebut akan menampilkan banner yang dapat diciutkan ditempatkan di atas secara langsung 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

Untuk aplikasi yang mengonfigurasi pemuatan ulang otomatis untuk iklan banner dalam Antarmuka web AdMob, dengan iklan banner yang dapat diciutkan diminta untuk slot banner, pemuatan ulang iklan berikutnya tidak akan meminta iklan banner yang dapat diciutkan. Hal ini karena menampilkan banner yang dapat diciutkan pada setiap muat ulang dapat berdampak negatif pada pengalaman pengguna.

Jika ingin memuat iklan banner lain yang dapat diciutkan di lain waktu, Anda dapat memuat iklan secara manual dengan permintaan yang berisi parameter yang dapat diciutkan.

Periksa apakah iklan yang dimuat dapat diciutkan

Iklan banner yang tidak dapat diciutkan memenuhi syarat untuk ditampilkan untuk permintaan banner yang dapat diciutkan guna memaksimalkan performa. Panggil isCollapsible untuk memeriksa apakah banner terakhir yang dimuat dapat diciutkan. Jika permintaan gagal dimuat dan banner sebelumnya dapat diciutkan, API akan menampilkan true.

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 versi beta titik. Iklan yang ditayangkan melalui mediasi ditampilkan sebagai iklan banner normal yang tidak dapat diciutkan.