Menggabungkan Permintaan Iklan Banner yang Dirender Kustom dan Iklan Banner

Dengan beberapa perubahan pada kode, Anda dapat menggabungkan iklan native dan banner dalam permintaan iklan.

Prasyarat

• Google Mobile Ads SDK versi 11.0.0 atau yang lebih baru.
• Selesaikan langkah Memulai.

Memuat iklan

Iklan native yang dirender secara kustom dimuat menggunakan class AdLoader, yang memiliki class AdLoader.Builder sendiri untuk menyesuaikannya selama pembuatan. Dengan menambahkan pemroses ke AdLoader saat membuatnya, aplikasi menentukan jenis format iklan yang siap diterima. Kemudian, AdLoader hanya meminta jenis tersebut.

Objek AdLoader juga dapat dikonfigurasi untuk membuat permintaan iklan yang dapat menghasilkan iklan banner atau iklan native. Menambahkan OnAdManagerAdViewLoadedListener ke AdLoader saat membuatnya akan menentukan bahwa iklan banner harus bersaing dengan iklan native untuk memenuhi permintaan.

Kode berikut menunjukkan cara membuat AdLoader yang dapat memuat iklan native atau banner dalam satu permintaan:

Java

AdLoader adLoader = new AdLoader.Builder(context, "/6499/example/nativeandbanner")
    .forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
      @Override
      public void onNativeAdLoaded(NativeAd nativeAd) {
        // Show the ad.
      }
    })
    .forAdManagerAdView(new OnAdManagerAdViewLoadedListener() {
      @Override
      public void onAdManagerAdViewLoaded(AdManagerAdView adView) {
        // Show the banner ad.
      }
    }, AdSize.BANNER, AdSize.MEDIUM_RECTANGLE)
    .withAdListener(new AdListener() {
      @Override
      public void onAdFailedToLoad(LoadAdError error) {
        // Handle the failure by logging, altering the UI, and so on.
      }
    })
    .withAdManagerAdViewOptions(new AdManagerAdViewOptions.Builder()
      // Methods in the AdManagerAdViewOptions.Builder class can be
      // used here to specify individual options settings.
      .build())
    .build();

Kotlin

val adLoader = AdLoader.Builder(this, "/6499/example/nativeandbanner")
    .forNativeAd { nativeAd ->
      // Show the ad.
    }
    .forAdManagerAdView({ adView ->
      // Show the banner ad.
    }, AdSize.BANNER, AdSize.MEDIUM_RECTANGLE)
    .withAdListener(object: AdListener() {
      override fun onAdFailedToLoad(adError: LoadAdError) {
        // Handle the failure by logging, altering the UI, and so on.
      }
    })
    .withAdManagerAdViewOptions(AdManagerAdViewOptions.Builder()
      // Methods in the AdManagerAdViewOptions.Builder class can be
      // used here to specify individual options settings.
      .build())
    .build()

Metode forAdManagerAdView() di atas menyiapkan AdLoader untuk menerima iklan banner. Daftar panjang variabel dari ukuran iklan yang valid harus ditentukan bersama OnAdManagerAdViewLoadedListener saat memanggil forAdManagerAdView().

Untuk membuat permintaan iklan yang valid, minimal satu ukuran iklan yang valid harus ditentukan. Saat iklan banner berhasil dimuat, metode onAdManagerAdViewLoaded() objek pemroses yang ditentukan akan dipanggil.

Poin Penting: Iklan banner hanya dapat dimuat melalui objek AdLoader saat diminta bersama iklan native. Untuk membuat permintaan iklan untuk banner saja, ikuti langkah-langkah yang diuraikan dalam Iklan Banner. Selain itu, banner yang dimuat melalui objek AdLoader tidak dimuat ulang.

Menetapkan AdViewOptions

Fungsi terakhir yang disertakan dalam pembuatan AdLoader di atas adalah metode opsional lainnya, withAdManagerAdViewOptions():

Java

.withAdManagerAdViewOptions(new AdManagerAdViewOptions.Builder()
    // Methods in the AdManagerAdViewOptions.Builder class can be
    // used here to specify individual banner options settings.
    .build()

Kotlin

.withAdManagerAdViewOptions(AdManagerAdViewOptions.Builder()
    // Methods in the AdManagerAdViewOptions.Builder class can be
    // used here to specify individual banner options settings.
    .build()

Objek AdManagerAdViewOptions memungkinkan penayang menetapkan opsi khusus untuk banner yang dimuat oleh AdLoader, seperti:

setManualImpressionsEnabled()

Mengaktifkan pelaporan tayangan manual untuk reservasi Google Ad Manager. Aplikasi yang menggunakan tayangan manual dapat menentukan sendiri kapan tayangan harus dicatat, dan dapat melakukannya dengan memanggil AdManagerAdView.recordManualImpression().