Iklan native adalah aset iklan yang ditampilkan kepada pengguna melalui komponen UI yang merupakan native platform. Buku tersebut ditampilkan menggunakan kelas yang sama dengan yang sudah Anda gunakan di storyboard, dan dapat diformat agar cocok dengan desain visual aplikasi Anda. Saat iklan native dimuat, aplikasi Anda menerima objek iklan yang berisi asetnya, dan aplikasi (bukan SDK) kemudian bertanggung jawab untuk menampilkannya. Ini berbeda dengan format iklan lainnya, yang tidak memungkinkan Anda menyesuaikan tampilan iklan.
Panduan ini akan menunjukkan cara menggunakan Google Mobile Ads SDK untuk menerapkan iklan native di aplikasi iOS, serta beberapa hal penting yang perlu dipertimbangkan selama proses berlangsung.
Secara garis besar, ada dua bagian agar berhasil menerapkan iklan native: memuat iklan melalui SDK dan menampilkan konten iklan di aplikasi. Halaman ini membahas pemuatan iklan menggunakan SDK.
Jika Anda sudah berhasil memuat iklan native, dan hanya perlu mengetahui cara menampilkannya, jangan ragu untuk langsung membuka panduan Template Native atau Native Advanced.
Prasyarat
- Selesaikan Panduan memulai.
Selalu uji dengan iklan uji coba
Sebelum memulai, ingat bahwa saat membuat dan menguji aplikasi, Anda harus memastikan bahwa Anda menggunakan iklan pengujian, bukan iklan produksi aktif. Pengujian dengan iklan produksi dapat menyebabkan penangguhan akun.
Cara termudah untuk memuat iklan pengujian adalah menggunakan ID unit iklan pengujian khusus kami untuk semua iklan native lanjutan di iOS:
/6499/example/native
Aplikasi ini telah dikonfigurasi secara khusus guna menampilkan iklan pengujian untuk setiap permintaan, dan Anda bebas menggunakannya dalam aplikasi Anda sendiri saat membuat kode, menguji, dan men-debug. Pastikan Anda menggantinya dengan ID unit iklan Anda sendiri sebelum memublikasikan aplikasi.
Untuk informasi selengkapnya tentang cara kerja iklan pengujian Mobile Ads SDK, lihat Menguji Iklan.
Memuat iklan
Iklan native dimuat melalui objek GADAdLoader
, yang mengirim pesan ke delegasinya sesuai dengan protokol GADAdLoaderDelegate
.
Selain format native yang ditentukan sistem, penayang Google
Ad Manager memiliki opsi untuk membuat format iklan native
mereka sendiri dengan menentukan daftar aset kustom. Ini disebut format iklan native kustom dan dapat digunakan untuk iklan native yang dijual langsung. Format iklan native kustom memungkinkan
penayang meneruskan data terstruktur arbitrer ke aplikasi mereka. Iklan ini
diwakili oleh class GADCustomNativeAd
.
Menginisialisasi loader iklan
Sebelum dapat memuat iklan, Anda harus melakukan inisialisasi loader iklan.
Kode berikut menunjukkan cara menginisialisasi GADAdLoader
:
Swift
adLoader = GADAdLoader(adUnitID: "/6499/example/native", rootViewController: self, adTypes: [ .native ], options: [ ... ad loader options objects ... ]) adLoader.delegate = self
Objective-C
self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"/6499/example/native" rootViewController:rootViewController adTypes:@[ GADAdLoaderAdTypeNative ] options:@[ ... ad loader options objects ... ]]; self.adLoader.delegate = self;
Anda memerlukan ID unit iklan (Anda dapat menggunakan ID pengujian), konstanta untuk diteruskan dalam array adTypes
guna menentukan format native mana yang ingin Anda minta, dan opsi apa pun yang ingin Anda tetapkan dalam parameter options
. Daftar kemungkinan
nilai untuk parameter options
dapat ditemukan di halaman Menyetel Iklan
Opsi Native.
Array adTypes
harus berisi satu atau beberapa konstanta berikut:
Menerapkan delegasi loader iklan
Delegasi loader iklan perlu menerapkan protokol yang khusus untuk jenis iklan Anda. Untuk iklan native:
-
GADNativeAdLoaderDelegate
Protokol ini menyertakan pesan yang dikirim ke delegasi saat iklan native dimuat:Swift
public func adLoader(_ adLoader: GADAdLoader, didReceive nativeAd: GADNativeAd)
Objective-C
- (void)adLoader:(GADAdLoader *)adLoader didReceiveNativeAd:(GADNativeAd *)nativeAd;
GADCustomNativeAdLoaderDelegate
. Protokol ini menyertakan pesan yang dikirim ke delegasi saat iklan template kustom telah dimuat:Swift
func adLoader(_ adLoader: GADAdLoader, didReceive customNativeAd: GADCustomNativeAd)
Objective-C
- (void)adLoader:(GADAdLoader *)adLoader didReceiveCustomNativeAd:(GADCustomNativeAd *) customNativeAd;
Meminta iklan
Setelah GADAdLoader
diinisialisasi, panggil metode loadRequest:
untuk meminta iklan:
Swift
adLoader.load(GAMRequest())
Objective-C
[self.adLoader loadRequest:[GAMRequest request]];
Metode loadRequest:
di GADAdLoader
menerima objek GAMRequest
yang sama seperti banner dan interstisial. Anda dapat menggunakan objek permintaan untuk menambahkan informasi penargetan, seperti yang Anda lakukan dengan jenis iklan lainnya.
Satu GADAdLoader
dapat membuat beberapa permintaan, tetapi hanya jika permintaan tersebut dilakukan
satu per satu. Saat menggunakan kembali GADAdLoader
, pastikan Anda menunggu hingga setiap permintaan
selesai sebelum memanggil loadRequest:
lagi untuk memulai permintaan berikutnya. Jika perlu
meminta beberapa iklan secara paralel, Anda selalu dapat menggunakan beberapa objek
GADAdLoader
.
Kapan harus meminta iklan
Aplikasi yang menampilkan iklan native bebas memintanya sebelum waktu benar ditampilkan. Dalam banyak kasus, ini adalah praktik yang direkomendasikan. Aplikasi yang menampilkan daftar item dengan campuran iklan native, misalnya, dapat memuat iklan native untuk seluruh daftar dengan mengetahui bahwa beberapa iklan native hanya akan ditampilkan setelah pengguna men-scroll tampilan dan beberapa iklan lainnya mungkin tidak ditampilkan sama sekali.
Meskipun mengambil data iklan merupakan teknik yang sangat bagus, Anda tidak boleh menyimpan iklan lama selamanya tanpa menampilkannya. Objek iklan native apa pun yang telah dipertahankan tanpa ditampilkan selama lebih dari satu jam harus dihapus dan diganti dengan iklan baru dari permintaan baru.
Menangani permintaan yang gagal
Protokol di atas memperluas protokol GADAdLoaderDelegate
, yang menentukan pesan yang dikirim saat iklan gagal dimuat.
Swift
public func adLoader(_ adLoader: GADAdLoader, didFailToReceiveAdWithError error: NSError)
Objective-C
- (void)adLoader:(GADAdLoader *)adLoader didFailToReceiveAdWithError:(NSError *)error;
Dapatkan notifikasi tentang peristiwa iklan native
Agar mendapatkan pemberitahuan tentang peristiwa yang terkait dengan interaksi iklan native, tetapkan properti delegasi untuk iklan native:
Swift
nativeAd.delegate = self
Objective-C
nativeAd.delegate = self;
Lalu, terapkan
GADNativeAdDelegate
untuk menerima panggilan delegasi berikut:
Swift
func nativeAdDidRecordImpression(_ nativeAd: GADNativeAd) { // The native ad was shown. } func nativeAdDidRecordClick(_ nativeAd: GADNativeAd) { // The native ad was clicked on. } func nativeAdWillPresentScreen(_ nativeAd: GADNativeAd) { // The native ad will present a full screen view. } func nativeAdWillDismissScreen(_ nativeAd: GADNativeAd) { // The native ad will dismiss a full screen view. } func nativeAdDidDismissScreen(_ nativeAd: GADNativeAd) { // The native ad did dismiss a full screen view. } func nativeAdWillLeaveApplication(_ nativeAd: GADNativeAd) { // The native ad will cause the application to become inactive and // open a new application. }
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 application to become inactive and // open a new application. }
Tampilkan iklan Anda
Setelah Anda memuat iklan, yang tersisa hanyalah menampilkannya kepada pengguna. Buka panduan Native Advanced untuk melihat caranya.