Iklan Native

Pilih platform: Android (beta) Baru Android iOS Flutter Unity

Iklan native adalah aset iklan yang ditampilkan kepada pengguna melalui komponen UI yang merupakan bagian asli dari platform. Elemen ini ditampilkan menggunakan class yang sama dengan yang sudah Anda gunakan dalam storyboard, 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—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

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 percobaan adalah dengan menggunakan ID unit iklan percobaan khusus kami untuk iklan native di iOS:

ca-app-pub-3940256099942544/3986624511

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 percobaan Google Mobile Ads SDK, lihat Mengaktifkan iklan percobaan.

Memuat iklan

Iklan native dimuat dengan class GADAdLoader, yang mengirim pesan ke delegasinya sesuai dengan protokol GADAdLoaderDelegate.

Melakukan inisialisasi loader iklan

Sebelum dapat memuat iklan, Anda harus melakukan inisialisasi loader iklan. Kode berikut menunjukkan cara melakukan inisialisasi GADAdLoader:

Swift

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  // The UIViewController parameter is optional.
  rootViewController: self,
  // To receive native ads, the ad loader's delegate must
  // conform to the NativeAdLoaderDelegate protocol.
  adTypes: [.native],
  // Use nil for default options.
  options: nil)
NativeAdSnippets.swift

Ganti nativeAdUnitID dengan ID unit iklan Anda.

Objective-C

self.adLoader =
    [[GADAdLoader alloc] initWithAdUnitID:"kNativeAdUnitID"
                       // The UIViewController parameter is optional.
                       rootViewController:self
                                  // To receive native ads, the ad loader's delegate must
                                  // conform to the NativeAdLoaderDelegate protocol.
                                  adTypes:@[ GADAdLoaderAdTypeNative ]
                                  // Use nil for default options.
                                  options:nil];
NativeAdSnippets.m

Ganti kNativeAdUnitID dengan ID unit iklan Anda.

Anda memerlukan ID unit iklan (Anda dapat menggunakan ID pengujian), konstanta untuk diteruskan dalam array adTypes guna menentukan format native yang ingin Anda minta, dan opsi yang ingin Anda tetapkan dalam parameter options. Daftar kemungkinan nilai untuk parameter options dapat ditemukan di halaman Menetapkan Opsi Iklan Native.

Array adTypes harus berisi konstanta ini :

Menerapkan delegasi loader iklan

Delegasi loader iklan harus menerapkan protokol khusus untuk jenis iklan Anda. Untuk iklan native, protokol GADNativeAdLoaderDelegate menyertakan pesan yang dikirim ke delegasi saat iklan native telah dimuat.

Swift

func adLoader(_ adLoader: AdLoader, didReceive nativeAd: NativeAd) {
  // To be notified of events related to the native ad interactions, set the delegate property
  // of the native ad
  nativeAd.delegate = self

  // TODO: Display the native ad.
}
NativeAdSnippets.swift

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader didReceiveNativeAd:(GADNativeAd *)nativeAd {
  // To be notified of events related to the native ad interactions, set the delegate property
  // of the native ad
  nativeAd.delegate = self;

  // TODO: Display the native ad.
}
NativeAdSnippets.m

Meminta iklan

Setelah GADAdLoader diinisialisasi, panggil metode loadRequest:-nya untuk meminta iklan:

Swift

adLoader.load(Request())
NativeAdSnippets.swift

Objective-C

[self.adLoader loadRequest:[GADRequest request]];
NativeAdSnippets.m

Metode loadRequest: di GADAdLoader menerima objek GADRequest yang sama dengan banner dan iklan interstisial. Anda dapat menggunakan objek permintaan untuk menambahkan informasi penargetan, seperti yang Anda lakukan dengan jenis iklan lainnya.

Memuat beberapa iklan (opsional)

Untuk memuat beberapa iklan dalam satu permintaan, tetapkan objek GADMultipleAdsAdLoaderOptions saat melakukan inisialisasi GADAdLoader.

Swift

let multipleAdOptions = MultipleAdsAdLoaderOptions()
multipleAdOptions.numberOfAds = 5
adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  // The UIViewController parameter is optional.
  rootViewController: self,
  adTypes: [.native],
  options: [multipleAdOptions])
NativeAdSnippets.swift

Objective-C

GADMultipleAdsAdLoaderOptions *multipleAdOptions = [[GADMultipleAdsAdLoaderOptions alloc] init];
multipleAdOptions.numberOfAds = 5;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"kNativeAdUnitID"
                                   // The UIViewController parameter is optional.
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ multipleAdOptions ]];
NativeAdSnippets.m

Jumlah iklan per permintaan dibatasi hingga lima, dan tidak dijamin bahwa SDK akan menampilkan jumlah iklan yang diminta secara tepat.

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

Jangan gunakan class GADMultipleAdsAdLoaderOptions jika Anda menggunakan mediasi, karena permintaan untuk beberapa iklan native tidak berfungsi untuk ID unit iklan yang telah dikonfigurasi untuk mediasi.

Menentukan kapan pemuatan selesai

Setelah aplikasi memanggil loadRequest:, aplikasi dapat memperoleh hasil permintaan menggunakan panggilan ke:

Permintaan untuk satu iklan akan menghasilkan satu panggilan ke salah satu metode tersebut.

Permintaan untuk beberapa iklan akan menghasilkan setidaknya satu callback ke metode di atas, tetapi tidak lebih dari jumlah maksimum iklan yang diminta.

Selain itu, GADAdLoaderDelegate menawarkan callback adLoaderDidFinishLoading. Metode delegasi ini menunjukkan bahwa pemuat iklan telah selesai memuat iklan dan tidak ada iklan atau error lain yang akan dilaporkan untuk permintaan tersebut. Berikut contoh cara menggunakannya saat memuat beberapa iklan native sekaligus:

Swift

func adLoaderDidFinishLoading(_ adLoader: AdLoader) {
  // The adLoader has finished loading ads.
}
NativeAdSnippets.swift

Objective-C

- (void)adLoaderDidFinishLoading:(GADAdLoader *)adLoader {
  // The adLoader has finished loading ads.
}
NativeAdSnippets.m

Menangani permintaan yang gagal

Protokol ini memperluas protokol GADAdLoaderDelegate, yang menentukan pesan yang dikirim saat iklan gagal dimuat.

Swift

func adLoader(_ adLoader: AdLoader, didFailToReceiveAdWithError error: any Error) {
  // The adLoader failed to receive an ad.
}
NativeAdSnippets.swift

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader didFailToReceiveAdWithError:(NSError *)error {
  // The adLoader failed to receive an ad.
}
NativeAdSnippets.m

Mendapatkan notifikasi peristiwa iklan native

Agar mendapatkan notifikasi peristiwa yang terkait dengan interaksi iklan native, tetapkan properti delegasi iklan native:

Swift

// Set the delegate before making an ad request.
adLoader.delegate = self
NativeAdSnippets.swift

Objective-C

// Set the delegate before making an ad request.
self.adLoader.delegate = self;
NativeAdSnippets.m

Kemudian, terapkan GADNativeAdDelegate untuk menerima panggilan delegasi berikut:

Swift

func nativeAdDidRecordImpression(_ nativeAd: NativeAd) {
  // The native ad was shown.
}

func nativeAdDidRecordClick(_ nativeAd: NativeAd) {
  // The native ad was clicked on.
}

func nativeAdWillPresentScreen(_ nativeAd: NativeAd) {
  // The native ad will present a full screen view.
}

func nativeAdWillDismissScreen(_ nativeAd: NativeAd) {
  // The native ad will dismiss a full screen view.
}

func nativeAdDidDismissScreen(_ nativeAd: NativeAd) {
  // The native ad did dismiss a full screen view.
}

func nativeAdWillLeaveApplication(_ nativeAd: NativeAd) {
  // The native ad will cause the app to become inactive and
  // open a new app.
}
NativeAdSnippets.swift

Objective-C

- (void)nativeAdDidRecordImpression:(GADNativeAd *)nativeAd {
  // The native ad was shown.
}

- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
  // The native ad was clicked on.
}

- (void)nativeAdWillPresentScreen:(GADNativeAd *)nativeAd {
  // The native ad will present a full screen view.
}

- (void)nativeAdWillDismissScreen:(GADNativeAd *)nativeAd {
  // The native ad will dismiss a full screen view.
}

- (void)nativeAdDidDismissScreen:(GADNativeAd *)nativeAd {
  // The native ad did dismiss a full screen view.
}

- (void)nativeAdWillLeaveApplication:(GADNativeAd *)nativeAd {
  // The native ad will cause the app to become inactive and
  // open a new app.
}
NativeAdSnippets.m

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 loadRequest: lagi di GADAdLoader hingga permintaan sebelumnya selesai dimuat, seperti yang ditunjukkan oleh adLoaderDidFinishLoading:.

  • 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.

Menampilkan iklan Anda

Setelah Anda memuat iklan, langkah terakhir adalah menampilkannya kepada pengguna. Buka panduan Native Advanced kami untuk melihat caranya.