Menyiapkan iklan native

Iklan native memberi Anda aset iklan individual, seperti judul, gambar, dan teks perintah, yang dapat Anda tata dan atur agar sesuai dengan desain visual aplikasi Anda. Untuk menangani pelacakan klik, tayangan, dan pemutaran media, Google Mobile Ads SDK for React Native menyediakan komponen berikut:

Untuk mengetahui detail tentang cara menampilkan iklan native sesuai kebijakan, lihat Iklan native yang menggunakan native advanced.

Halaman ini membahas cara memuat satu dan beberapa iklan native, mengelola memori dan siklus proses iklan, serta mengaktifkan akselerasi hardware untuk iklan video di Android.

Prasyarat

Sebelum melanjutkan, lakukan hal berikut:

Android

Format Contoh ID unit iklan
Native ca-app-pub-3940256099942544/2247696110
Video native ca-app-pub-3940256099942544/1044960115

iOS

Format Contoh ID unit iklan
Native ca-app-pub-3940256099942544/3986624511
Video native ca-app-pub-3940256099942544/2521693316

Memuat iklan

Untuk memuat iklan native, panggil metode NativeAd.load dengan objek NativeAdRequest yang berisi ID unit iklan Anda. Metode ini menampilkan promise yang di-resolve dengan objek NativeAd yang dimuat atau ditolak dengan objek LoadAdError.

Contoh berikut memuat satu iklan native, menampilkan iklan yang dimuat jika berhasil, dan mencatat pesan error ke dalam log jika gagal:

export async function loadNativeAd(adUnitId: string): Promise<NativeAd | null> {
  try {
    const ad = await NativeAd.load({adUnitId});
    return ad;
  } catch (error) {
    const loadError = error as LoadAdError;
    console.error('Failed to load native ad:', loadError.message);
    return null;
  }
}

Saat memuat dan mengelola iklan native, sebaiknya lakukan hal berikut:

  • Batasi iklan yang dimuat: Aset iklan native menggunakan memori. Hanya muat iklan yang akan dilihat pengguna, seperti satu hingga dua penempatan iklan berikutnya, daripada memuat iklan dalam jumlah besar sekaligus.
  • Membersihkan iklan yang dilepas: Saat Anda menghapus atau mengganti iklan dari layar, atau saat komponen yang memuatnya dilepas, panggil metode ad.destroy. Metode ini merilis resource dan memori yang digunakan iklan.
  • Tampilkan iklan yang dimuat dalam waktu satu jam: Masa berlaku materi iklan native akan berakhir setelah 60 menit. Jika Anda belum menampilkan iklan yang dimuat dalam satu jam, hancurkan iklan dan minta iklan lain.

Opsional: Memuat beberapa iklan

Untuk memuat beberapa iklan dalam satu permintaan, panggil metode NativeAd.loadAds dengan objek NativeAdRequest, jumlah iklan yang akan diminta, dan objek NativeAdLoadCallback. Permintaan dapat berisi hingga lima iklan.

Contoh berikut meminta beberapa iklan native dan menangani setiap iklan yang dimuat, error pemuatan, dan penyelesaian permintaan menggunakan callback:

export function loadMultipleNativeAds(adUnitId: string, numAds: number): void {
  NativeAd.loadAds({adUnitId}, numAds, {
    // Called when an individual native ad finishes loading.
    onNativeAdLoad: (ad) => {
      console.log('Loaded native ad:', ad.headline);
    },
    // Called when an individual native ad fails to load.
    onAdFailedToLoad: (error) => {
      console.error('Failed to load native ad:', error.message);
    },
    // Called when all requested ads have finished loading.
    onAdLoadingCompleted: () => {
      console.log('All requested native ads finished loading.');
    },
  });
}

Jika Anda menampilkan iklan di feed yang dapat di-scroll, muat iklan terlebih dahulu. Proses ini memungkinkan rendering iklan saat pengguna membuka iklan.

Mengaktifkan akselerasi hardware

Untuk menampilkan iklan video di tampilan iklan native di Android, aktifkan akselerasi hardware.

Secara default, Android mengaktifkan akselerasi hardware. Aplikasi mungkin menonaktifkan akselerasi hardware secara global. Jika aplikasi Anda menonaktifkan akselerasi hardware secara global, aktifkan setelan untuk class Activity yang menampilkan iklan.

Jika Anda mengaktifkan akselerasi hardware secara global, dan aplikasi Anda tidak berfungsi seperti yang diharapkan, kontrol akselerasi hardware untuk setiap aktivitas. Untuk mengaktifkan atau menonaktifkan akselerasi hardware, gunakan atribut android:hardwareAccelerated untuk elemen application dan activity dalam file AndroidManifest.xml Anda.

Contoh berikut mengaktifkan akselerasi hardware secara global untuk aplikasi dan menonaktifkan setelan 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>

Langkah berikutnya

Setelah memuat iklan, render iklan di UI React Native menggunakan komponen NativeAdView dan NativeAdMediaView. Untuk mengetahui detailnya, lihat Menampilkan iklan native.