Iklan banner adaptif inline

Banner adaptif memungkinkan Anda menentukan lebar iklan untuk menentukan ukuran iklan yang optimal untuk setiap perangkat. Tidak seperti banner adaptif anchor, banner adaptif inline lebih besar, lebih tinggi, dan tidak menggunakan tinggi tetap. Banner adaptif inline memiliki tinggi variabel. Banner ini dapat mengisi seluruh layar atau tinggi maksimum yang Anda tentukan.

Panduan ini membahas cara membuat banner adaptif inline dan menetapkan ukuran banner.

Gambar berikut menunjukkan banner adaptif inline dalam konten yang dapat di-scroll:

Diagram yang menunjukkan perbedaan banner adaptif dan banner adaptif inline

Sebelum memulai

Sebelum melanjutkan, pastikan Anda menyiapkan iklan banner.

Untuk melihat contoh banner adaptif inline lengkap, download aplikasi contoh berikut:

Mengimplementasikan banner adaptif inline

Untuk mengimplementasikan banner adaptif inline, Anda menetapkan ukuran iklan, membuat permintaan iklan, dan memuat iklan.

Untuk menentukan ukuran banner adaptif inline, tentukan lebar iklan. Pendekatan umum mencakup hal berikut:

  • Menggunakan lebar layar penuh.
  • Menggunakan lebar tata letak induk yang berisi iklan.
  • Menyesuaikan lebar untuk memperhitungkan area aman perangkat.

Saat membuat objek ukuran iklan, gunakan lebar yang dihitung ini.

Contoh berikut menetapkan ukuran iklan, membuat permintaan iklan, dan memuat iklan:

Kotlin

private fun loadAd() {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  val adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320)

  // Step 1 - Create a BannerAdRequest object with ad unit ID and size.
  val adRequest = BannerAdRequest.Builder("AD_UNIT_ID", adSize).build()

  // Step 2 - Load the ad.
  BannerAd.load(
    adRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        // Assign the loaded ad to the BannerAd object.
        bannerAd = ad
        // Step 3 - Call BannerAd.getView() to get the View and add it
        // to view hierarchy on the UI thread.
        activity?.runOnUiThread {
          binding.bannerViewContainer.addView(ad.getView(requireActivity()))
        }
      }

      override fun onAdFailedToLoad(loadAdError: LoadAdError) {
        bannerAd = null
      }
    }
  )
}

Java

private void loadAd() {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  AdSize adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320);

  // Step 1 - Create a BannerAdRequest object with ad unit ID and size.
  BannerAdRequest adRequest = new BannerAdRequest.Builder("AD_UNIT_ID",
      adSize).build();

  // Step 2 - Load the ad.
  BannerAd.load(
      adRequest,
      new AdLoadCallback<BannerAd>() {
        @Override
        public void onAdLoaded(@NonNull BannerAd ad) {
          // Assign the loaded ad to the BannerAd object.
          bannerAd = ad;
          // Step 3 - Call BannerAd.getView() to get the View and add it
          // to view hierarchy on the UI thread.
          if (getActivity() != null) {
            getActivity()
                .runOnUiThread(() ->
                    binding.bannerViewContainer.addView(ad.getView(getActivity())));
          }
        }

        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          bannerAd = null;
        }
      });
}

Menetapkan tata letak banner adaptif inline

Untuk memuat iklan banner adaptif inline terlebih dahulu untuk tata letak tertentu, gunakan metode berikut:

Jika aplikasi Anda mendukung tampilan potret dan lanskap, dan Anda ingin memuat iklan banner adaptif terlebih dahulu dalam tata letak saat ini, gunakan metode AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width). Metode ini memuat iklan dalam tata letak saat ini.

Membatasi tinggi banner adaptif inline

Secara default, banner adaptif inline yang dibuat tanpa nilai maxHeight memiliki tinggi maksimum yang sama dengan tinggi perangkat. Untuk membatasi tinggi banner adaptif inline, gunakan metode AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight).