Iklan native memiliki banyak fitur lanjutan yang memungkinkan Anda memberikan dan mendapatkan pengalaman iklan sebaik mungkin. Panduan ini menunjukkan cara menggunakan fitur lanjutan iklan native.
Prasyarat
- Integrasikan Format iklan native.
Kontrol aset
Kontrol rasio aspek media pilihan
Kontrol Rasio Aspek Media memungkinkan Anda menentukan preferensi untuk rasio aspek materi iklan.
Setel GADNativeAdMediaAdLoaderOptions mediaAspectRatio
dengan GADMediaAspectRatio
.
Jika tidak disetel, iklan yang ditampilkan dapat memiliki rasio aspek media apa pun.
Jika ditetapkan, Anda akan dapat meningkatkan pengalaman pengguna dengan menentukan jenis rasio aspek yang disukai.
Contoh berikut menginstruksikan SDK untuk memilih gambar atau video hasil dengan rasio aspek tertentu.
GADNativeAdMediaAdLoaderOptions *nativeOption = [[GADNativeAdMediaAdLoaderOptions alloc] init];
nativeOption.mediaAspectRatio = GADMediaAspectRatioAny;
GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ nativeOption ]];
Kontrol download gambar
Kontrol download gambar memungkinkan Anda memutuskan apakah aset gambar atau hanya URI yang yang ditampilkan SDK.
SetelGADNativeAdImageAdLoaderOptions disableImageLoading
dengan nilai BOOL
.
Kontrol download gambar dinonaktifkan secara default.
Jika dinonaktifkan, Google Mobile Ads SDK akan mengisi gambar dan URI untuk Anda.
Saat diaktifkan, SDK hanya akan mengisi URI, sehingga Anda dapat mendownload gambar yang sebenarnya sesuai kebijaksanaan Anda.
Contoh berikut menginstruksikan SDK untuk hanya menampilkan URI.
GADNativeAdImageAdLoaderOptions *nativeOption = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOption.disableImageLoading = YES;
GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ nativeOption ]];
Kontrol payload gambar
Beberapa iklan memiliki serangkaian gambar, bukan hanya satu. Gunakan fitur ini untuk menunjukkan apakah aplikasi Anda disiapkan untuk menampilkan semua gambar atau hanya satu gambar.
SetelGADNativeAdImageAdLoaderOptions shouldRequestMultipleImages
dengan nilai BOOL
.
Kontrol payload gambar dinonaktifkan secara default.
Jika dinonaktifkan, aplikasi Anda akan menginstruksikan SDK untuk hanya menyediakan gambar pertama untuk aset apa pun yang berisi serial.
Jika diaktifkan, aplikasi Anda akan menunjukkan bahwa aplikasi siap menampilkan semua gambar untuk setiap aset yang memiliki lebih dari satu aset.
Contoh berikut menginstruksikan SDK untuk menampilkan beberapa aset gambar.
GADNativeAdImageAdLoaderOptions *nativeOption = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOption.shouldRequestMultipleImages = YES;
GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ nativeOption ]];
Penempatan AdChoices
Kontrol posisi AdChoices
Kontrol posisi AdChoices memungkinkan Anda memilih sudut mana yang akan dirender Ikon AdChoices.
Setel GADNativeAdViewAdOptions preferredAdChoicesPosition
dengan GADAdChoicesPosition
dengan sejumlah nilai.
Jika tidak disetel, posisi ikon AdChoices akan disetel di kanan atas.
Jika ditetapkan, AdChoices ditempatkan pada posisi kustom seperti yang diminta.
Contoh berikut menunjukkan cara menetapkan posisi gambar AdChoices kustom.
GADNativeAdViewAdOptions *nativeOptions = [[GADNativeAdViewAdOptions alloc] init];
nativeOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopLeftCorner;
GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ nativeOptions ]];
Tampilan kustom AdChoices
Fitur tampilan kustom AdChoices memungkinkan Anda menempatkan ikon AdChoices di lokasi kustom. Ini berbeda dari kontrol posisi AdChoices, yang hanya memungkinkan spesifikasi dari salah satu dari keempat sudutnya.
Setel GADNativeAd.adChoicesView
properti dengan GADAdChoicesView
sebelum dirender dan konten AdChoices akan dirender di dalam
GADAdChoicesView
.
Contoh berikut menunjukkan cara menetapkan tampilan AdChoices kustom. Tujuan
Ikon AdChoices akan dirender di dalam GADAdChoicesView
.
Objective-C
- (void)adLoader:(GADAdLoader *)adLoader didReceiveNativeAd:(GADNativeAd *)nativeAd {
...
GADAdChoicesView *customAdChoicesView =
[[GADAdChoicesView alloc] initWithFrame: CGRectMake(..., ..., ..., ...)];
[nativeAdView addSubview:customAdChoicesView];
nativeAdView.adChoicesView = customAdChoicesView;
// Associate the native ad view with the native ad object. This is
// required to make the ad clickable.
// Note: this should always be done after populating the ad views.
nativeAdView.nativeAd = nativeAd;
}
Swift
func adLoader(_ adLoader: GADAdLoader, didReceive nativeAd: GADNativeAd) {
refreshAdButton.isEnabled = true
...
// Define a custom position for the AdChoices icon.
let customRect = CGRect(x: 100, y: 100, width: 15, height: 15)
let customAdChoicesView = GADAdChoicesView(frame: customRect)
nativeAdView.addSubview(customAdChoicesView)
nativeAdView.adChoicesView = customAdChoicesView
// Associate the native ad view with the native ad object. This is
// required to make the ad clickable.
// Note: this should always be done after populating the ad views.
nativeAdView.nativeAd = nativeAd;
}
Kontrol video
Mulai perilaku membisukan audio
Perilaku mulai dibisukan memungkinkan Anda menonaktifkan atau mengaktifkan audio awal video.
SetelGADVideoOptions startMuted
dengan nilai BOOL
.
Perilaku mulai dibisukan diaktifkan secara default.
Jika dinonaktifkan, aplikasi Anda akan meminta agar video dimulai dengan audio.
Jika diaktifkan, aplikasi Anda akan meminta agar video dimulai dengan audio dibisukan.
Contoh berikut menunjukkan cara memulai video dengan audio yang dibunyikan.
GADVideoOptions *nativeOptions = [[GADVideoOptions alloc] init];
nativeOptions.startMuted = NO;
GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ nativeOptions ]];
Kontrol pemutaran kustom
Hal ini memungkinkan Anda meminta kontrol input video kustom untuk memutar, menjeda, atau membisukan audio video Anda.
SetelGADVideoOptions customControlsRequested
dengan nilai BOOL
.
Kontrol pemutaran kustom dinonaktifkan secara default.
Jika dinonaktifkan, video Anda akan menampilkan kontrol input yang dirender SDK.
- Jika diaktifkan, Anda dapat menggunakan
GADVideoController play
,GADVideoController pause
, danGADVideoController setMute
untuk mengontrol iklan video.
- Jika iklan memiliki konten video dan kontrol kustom diaktifkan, Anda harus
lalu tampilkan kontrol khusus bersama iklan, karena iklan tidak akan menampilkan
mengendalikan dirinya sendiri. Kontrol kemudian dapat memanggil metode yang relevan di
GADVideoController
Contoh berikut menunjukkan cara meminta video dengan kontrol pemutaran kustom.
GADVideoOptions *nativeOptions = [[GADVideoOptions alloc] init];
nativeOptions.customControlsRequested = YES;
GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ nativeOptions ]];
Periksa apakah kontrol kustom diaktifkan
Karena pada saat permintaan tidak diketahui apakah iklan yang dikembalikan akan mengizinkan kontrol video kustom, Anda harus memeriksa apakah kontrol kustomnya diaktifkan atau tidak.
Objective-C
- (void)adLoader:(GADAdLoader *)adLoader
didReceiveNativeAd:(GADNativeAd*)nativeAd {
GADVideoController *videoController = nativeAd.mediaContent.videoController;
BOOL canShowCustomControls = videoController.customControlsEnabled;
}
Swift
func adLoader(_ adLoader: GADAdLoader, didReceive nativeAd: GADNativeAd) {
let videoController = nativeAd.mediaContent.videoController
let canShowCustomControls = videoController?.customControlsEnabled() == true
}
Gestur klik kustom
Gestur klik kustom adalah fitur iklan native yang memungkinkan geser pada tampilan iklan untuk terdaftar sebagai klik iklan. Alat ini dirancang untuk bekerja dengan aplikasi yang menggunakan tindakan geser {i>gesture <i}untuk navigasi konten. Panduan ini menunjukkan cara mengaktifkan klik kustom gestur pada iklan native Anda.
Melakukan inisialisasi GADNativeAdCustomClickGestureOptions
dengan arah geser yang dipilih. Anda juga perlu
menentukan apakah
Anda ingin ketukan diizinkan sebagai klik.
Gestur klik kustom dinonaktifkan secara default.
Jika dinonaktifkan, hanya ketukan yang akan dihitung sebagai klik.
Jika diaktifkan, gestur geser akan dihitung sebagai klik, dan Anda dapat menentukan apakah ketukan masih dapat dihitung sebagai klik.
Contoh berikut menunjukkan cara menerapkan gestur geser kustom ke ke kanan dan mempertahankan perilaku ketukan normal.
GADNativeAdCustomClickGestureOptions *swipeGestureOptions = [[GADNativeAdCustomClickGestureOptions alloc]
initWithSwipeGestureDirection:UISwipeGestureRecognizerDirectionRight
tapsAllowed:YES];
// The following sample ad unit ID has been enabled for custom click gestures
// and can be used for testing.
self.adLoader = [[GADAdLoader alloc]
initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
rootViewController:self
adTypes:@[ GADAdLoaderAdTypeNative ]
options:@[ swipeGestureOptions ]];
Memproses peristiwa gestur geser
Saat klik gestur geser direkam, Google Mobile Ads SDK akan memanggil
nativeAdDidRecordSwipeGestureClick:
delegasi di GADNativeAdDelegate
, selain nativeAdDidRecordClick:
yang sudah ada
delegasikan.
#pragma mark - GADNativeAdDelegate implementation
// Called when a swipe gesture click is recorded.
- (void)nativeAdDidRecordSwipeGestureClick:(GADNativeAd *)nativeAd {
NSLog(@"A swipe gesture click has occurred.");
}
// Called when a swipe gesture click or a tap click is recorded, as configured in
// GADNativeAdCustomClickGestureOptions.
- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
NSLog(@"A swipe gesture click or tap click has occurred.");
}
Mediasi
Gestur klik kustom hanya berfungsi pada iklan native yang ditangani Google Rendering Ads SDK. Sumber iklan yang memerlukan SDK pihak ketiga untuk tidak merespons setelan rute klik kustom.