Memuat iklan native

Pilih platform: Android iOS Flutter Unity Android (Lama)

Iklan native adalah aset iklan yang ditampilkan kepada pengguna melalui komponen UI yang merupakan bagian asli dari platform. Elemen ini ditampilkan menggunakan jenis tampilan yang sama dengan yang sudah Anda gunakan untuk membuat tata letak, dan dapat diformat agar sesuai dengan desain visual aplikasi Anda.

Saat iklan native dimuat, aplikasi Anda akan menerima objek iklan yang berisi asetnya, dan aplikasi—bukan Google Mobile Ads SDK (Legacy)—yang kemudian bertanggung jawab untuk menampilkannya.

Secara umum, ada dua bagian yang menentukan keberhasilan penerapan iklan native: Memuat iklan menggunakan SDK, lalu menampilkan konten iklan di aplikasi Anda.

Halaman ini menunjukkan cara menggunakan SDK untuk memuat iklan native.

Prasyarat

Sebelum melanjutkan, siapkan Google Mobile Ads SDK (Legacy).

Selalu melakukan pengujian dengan iklan percobaan

Saat membangun dan menguji aplikasi, pastikan Anda menggunakan iklan percobaan, bukan iklan produksi langsung.

Cara termudah untuk memuat iklan pengujian adalah dengan menggunakan ID unit iklan pengujian khusus kami untuk iklan native di Android:

/21775744923/example/native

Unit iklan ini telah dikonfigurasi secara khusus guna menampilkan iklan percobaan untuk setiap permintaan. Anda dapat menggunakannya di aplikasi Anda sendiri saat melakukan coding, pengujian, dan proses debug. Pastikan Anda menggantinya dengan ID unit iklan Anda sendiri sebelum memublikasikan aplikasi.

Untuk mengetahui detail tentang iklan pengujian Google Mobile Ads SDK (Legacy), lihat Mengaktifkan iklan pengujian.

Memuat iklan

Iklan native dimuat dengan class AdLoader, yang memiliki class Builder sendiri untuk menyesuaikannya selama pembuatan. Dengan menambahkan pemroses ke AdLoader saat membuatnya, aplikasi menentukan jenis iklan native yang siap diterima. AdLoader kemudian hanya meminta jenis tersebut.

Membuat AdLoader

Kode berikut menunjukkan cara membuat AdLoader yang dapat memuat iklan native:

Java

// It is recommended to call AdLoader.Builder on a background thread.
new Thread(
        () -> {
          AdLoader adLoader =
              new AdLoader.Builder(context, "AD_UNIT_ID")
                  .forNativeAd(
                      new NativeAd.OnNativeAdLoadedListener() {
                        @Override
                        // The native ad loaded successfully. You can show the ad.
                        public void onNativeAdLoaded(@NonNull NativeAd nativeAd) {}
                      })
                  .withAdListener(
                      new AdListener() {
                        @Override
                        // The native ad load failed. Check the adError message for failure
                        // reasons.
                        public void onAdFailedToLoad(@NonNull LoadAdError adError) {}
                      })
                  // Use the NativeAdOptions.Builder class to specify individual options
                  // settings.
                  .withNativeAdOptions(new NativeAdOptions.Builder().build())
                  .build();
        })
    .start();
NativeAdSnippets.java

Kotlin

// It is recommended to call AdLoader.Builder on a background thread.
CoroutineScope(Dispatchers.IO).launch {
  val adLoader =
    AdLoader.Builder(context, "AD_UNIT_ID")
      .forNativeAd { nativeAd ->
        // The native ad loaded successfully. You can show the ad.
      }
      .withAdListener(
        object : AdListener() {
          override fun onAdFailedToLoad(adError: LoadAdError) {
            // The native ad load failed. Check the adError message for failure reasons.
          }
        }
      )
      // Use the NativeAdOptions.Builder class to specify individual options settings.
      .withNativeAdOptions(NativeAdOptions.Builder().build())
      .build()
}
NativeAdSnippets.kt

Ganti AD_UNIT_ID dengan ID perangkat pengujian Anda.

Peringatan: Mencoba memuat iklan baru dari metode onAdFailedToLoad() sangat tidak dianjurkan. Jika Anda harus memuat iklan dari onAdFailedToLoad(), batasi percobaan ulang pemuatan iklan untuk menghindari panggilan iklan yang terus gagal dalam situasi seperti konektivitas jaringan yang terbatas.

Metode forNativeAd() bertanggung jawab untuk menyiapkan AdLoader untuk format NativeAd. Saat iklan berhasil dimuat, metode onNativeAdLoaded() objek pemroses akan dipanggil.

Menyiapkan AdListener dengan AdLoader (opsional)

Saat membuat AdLoader, fungsi withAdListener menetapkan AdListener untuk loader. Metode ini menggunakan AdListener sebagai satu-satunya parameter, yang menerima callback dari AdLoader saat peristiwa siklus proses iklan terjadi:

Java

adLoaderBuilder.withAdListener(
    // Override AdListener callbacks here.
    new AdListener() {});
NativeAdSnippets.java

Kotlin

adLoaderBuilder.withAdListener(
  // Override AdListener callbacks here.
  object : AdListener() {}
)
NativeAdSnippets.kt

Permintaan iklan

Tips: Anda dapat menggunakan panggilan pemuatan iklan untuk membuat cache iklan pramuat sebelum Anda berencana menayangkannya, sehingga iklan dapat ditayangkan dengan latensi nol saat diperlukan. Karena masa berlaku iklan berakhir setelah satu jam, Anda harus menghapus cache ini dan memuat ulang dengan iklan baru setiap jam.

Setelah Anda selesai membuat AdLoader, saatnya menggunakannya untuk meminta iklan. Ada dua metode yang tersedia untuk ini: loadAd() dan loadAds().

Poin Penting: Metode loadAds() hanya berfungsi dengan iklan Google. Untuk iklan yang dimediasi, gunakan loadAd().

loadAd()

Metode ini mengirimkan permintaan untuk satu iklan.

Java

adLoader.loadAd(new AdManagerAdRequest.Builder().build());
NativeAdSnippets.java

Kotlin

adLoader.loadAd(AdManagerAdRequest.Builder().build())
NativeAdSnippets.kt

loadAds()

Metode ini mengirimkan permintaan untuk beberapa iklan (hingga lima):

Java

// Load three native ads.
adLoader.loadAds(new AdManagerAdRequest.Builder().build(), 3);
NativeAdSnippets.java

Kotlin

// Load three native ads.
adLoader.loadAds(AdManagerAdRequest.Builder().build(), 3)
NativeAdSnippets.kt

Kedua metode menggunakan objek AdManagerAdRequest sebagai parameter pertamanya. Ini adalah class AdManagerAdRequest yang sama yang digunakan oleh banner dan interstisial, dan Anda dapat menggunakan metode class AdManagerAdRequest untuk menambahkan informasi penargetan, seperti yang Anda lakukan dengan format iklan lainnya.

Memuat beberapa iklan (opsional)

Metode loadAds() menggunakan parameter tambahan: jumlah iklan yang harus dicoba dimuat oleh SDK untuk permintaan tersebut. Jumlah ini dibatasi hingga lima, dan tidak ada jaminan bahwa SDK akan menampilkan jumlah iklan yang diminta secara tepat.

Iklan Google yang ditampilkan akan berbeda satu sama lain, meskipun iklan dari inventaris yang direservasi atau pembeli pihak ketiga tidak dijamin unik.

Jangan gunakan metode loadAds() jika Anda menggunakan mediasi, karena permintaan untuk beberapa iklan native tidak berfungsi untuk ID unit iklan yang telah dikonfigurasi untuk mediasi.

Callback

Setelah panggilan ke loadAd(), satu callback dibuat ke metode pemroses yang ditentukan sebelumnya untuk mengirimkan objek iklan native atau melaporkan error.

Merilis resource

Pastikan untuk menggunakan metode destroy() pada iklan native yang dimuat. Tindakan ini akan merilis resource yang digunakan dan mencegah kebocoran memori.

Poin Penting: destroy() harus dipanggil di semua iklan, meskipun tidak digunakan atau direferensikan.

Pastikan semua referensi NativeAd dihancurkan dalam metode onDestroy() aktivitas Anda.

Dalam callback onNativeAdLoaded, pastikan untuk menghancurkan iklan native yang ada yang akan didereferensikan.

Pemeriksaan penting lainnya adalah apakah aktivitas dihancurkan dan jika demikian, panggil destroy() pada iklan yang ditampilkan dan segera tampilkan:

Java

nativeAd.destroy();
NativeAdSnippets.java

Kotlin

nativeAd.destroy()
NativeAdSnippets.kt

Praktik terbaik

Ikuti aturan berikut saat memuat iklan.

• Aplikasi yang menggunakan iklan native dalam daftar harus menyimpan daftar iklan ke dalam cache terlebih dahulu (pra-cache).

• Saat melakukan pra-cache iklan, hapus cache dan muat ulang setelah satu jam.

• Jangan panggil loadAd() di AdLoader sampai permintaan pertama selesai dimuat.

• Batasi menyimpan iklan native ke dalam cache hanya sesuai keperluan. Misalnya, saat melakukan pra-cache, hanya simpan iklan yang langsung terlihat di layar ke cache. Iklan native memiliki jejak memori yang besar, dan menyimpan iklan native ke dalam cache tanpa menghancurkannya akan menyebabkan penggunaan memori yang berlebihan.

• Hancurkan iklan native jika tidak lagi digunakan.

Akselerasi hardware untuk iklan video

Agar iklan video berhasil ditampilkan di tampilan iklan native, akselerasi hardware harus diaktifkan.

Akselerasi hardware diaktifkan secara default, tetapi beberapa aplikasi mungkin memilih untuk menonaktifkannya. Jika hal ini berlaku untuk aplikasi Anda, sebaiknya aktifkan akselerasi hardware untuk class Aktivitas yang menggunakan iklan.

Mengaktifkan akselerasi hardware

Jika aplikasi Anda tidak berperilaku sebagaimana mestinya saat akselerasi hardware diaktifkan secara global, Anda juga dapat mengontrolnya untuk aktivitas tertentu. Untuk mengaktifkan atau menonaktifkan akselerasi hardware, gunakan atribut android:hardwareAccelerated untuk elemen <application> dan <activity> di AndroidManifest.xml Anda. Contoh berikut mengaktifkan akselerasi hardware untuk keseluruhan aplikasi, tetapi menonaktifkannya untuk satu aktivitas:

<application android:hardwareAccelerated="true">
    <!-- For activities that use ads, hardwareAcceleration should be true. -->
    <activity android:hardwareAccelerated="true" />
    <!-- For activities that don't use ads, hardwareAcceleration can be false. -->
    <activity android:hardwareAccelerated="false" />
</application>
HardwareAccelerationSnippet.xml

Lihat panduan akselerasi HW untuk mengetahui informasi selengkapnya tentang opsi untuk mengontrol akselerasi hardware. Perhatikan bahwa tampilan iklan individual tidak dapat diaktifkan untuk akselerasi hardware jika Aktivitas dinonaktifkan, sehingga Aktivitas itu sendiri harus mengaktifkan akselerasi hardware.

Menampilkan iklan Anda

Setelah Anda memuat iklan, langkah terakhir adalah menampilkannya kepada pengguna. Untuk mengetahui informasi selengkapnya, lihat Native Advanced atau Iklan native layar penuh.