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 berukuran lebih besar, lebih tinggi, dan tidak menggunakan tinggi tetap. Banner adaptif inline memiliki tinggi variabel. Banner ini mungkin 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 scroll:

Diagram yang menunjukkan perbedaan antara 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:

Menerapkan banner adaptif inline

Untuk menerapkan banner adaptif inline, Anda harus 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 loadInlineAdaptiveBannerAd(adView: AdView, activity: Activity) {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  val bannerWidth = 320
  val adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(activity, bannerWidth)
  val adRequest = BannerAdRequest.Builder(AD_UNIT_ID, adSize).build()

  adView.loadAd(
    adRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        Log.d(TAG, "Inline adaptive banner ad loaded.")
      }

      override fun onAdFailedToLoad(adError: LoadAdError) {
        Log.d(TAG, "Inline adaptive banner ad failed to load: $adError")
      }
    },
  )
}

Java

private void loadInlineAdaptiveBannerAd(@NonNull AdView adView, @NonNull Activity activity) {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  int bannerWidth = 320;
  AdSize adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(activity, bannerWidth);
  BannerAdRequest adRequest = new BannerAdRequest.Builder(AD_UNIT_ID, adSize).build();

  adView.loadAd(
      adRequest,
      new AdLoadCallback<BannerAd>() {
        @Override
        public void onAdLoaded(@NonNull BannerAd bannerAd) {
          Log.d(TAG, "Inline adaptive banner ad loaded.");
        }

        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          Log.d(TAG, "Inline adaptive banner ad failed to load: " + adError);
        }
      });
}

Ganti AD_UNIT_ID dengan ID unit iklan Anda.

Tetapkan ukuran iklan yang lebih kecil dari atau sama dengan ukuran layar perangkat. Untuk menentukan ukuran layar maksimum, gunakan metode Resources.getDisplayMetrics. Dimensi objek AdSize menggunakan piksel kepadatan mandiri (dp). Saat membandingkan, konversikan ukuran layar dari piksel ke dp. Untuk mengetahui detail tentang batasan ukuran, lihat Persyaratan ukuran permintaan iklan.

Menetapkan tata letak banner adaptif inline

Untuk melakukan pramuat iklan banner adaptif inline untuk tata letak tertentu, gunakan metode berikut:

Jika aplikasi Anda mendukung tampilan potret dan lanskap, dan Anda ingin melakukan pramuat iklan banner adaptif di 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).