Opsi iklan native

Pilih platform: Android iOS

Iklan Native memiliki banyak fitur lanjutan yang memungkinkan Anda melakukan penyesuaian tambahan dan menciptakan pengalaman iklan terbaik. Panduan ini menunjukkan cara menggunakan fitur lanjutan iklan native.

Prasyarat

Kontrol aset

Bagian ini menjelaskan cara menyesuaikan aset materi iklan di iklan native Anda. Anda memiliki opsi untuk menentukan rasio aspek pilihan untuk aset media dan cara aset gambar didownload dan ditampilkan.

Kontrol rasio aspek media pilihan

Kontrol Rasio Aspek Media memungkinkan Anda menentukan preferensi untuk rasio aspek materi iklan.

Tetapkan GADNativeAdMediaAdLoaderOptions mediaAspectRatio dengan GADMediaAspectRatio.

  • Jika tidak disetel, iklan yang ditampilkan dapat memiliki rasio aspek media apa pun.

  • Jika disetel, Anda dapat meningkatkan kualitas pengalaman pengguna dengan menentukan jenis rasio aspek yang disukai.

Contoh berikut menginstruksikan SDK untuk memilih gambar atau video yang ditampilkan dengan rasio aspek tertentu.

Swift

let nativeOptions = NativeAdMediaAdLoaderOptions()
nativeOptions.mediaAspectRatio = .any

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdMediaAdLoaderOptions *nativeOptions = [[GADNativeAdMediaAdLoaderOptions alloc] init];
nativeOptions.mediaAspectRatio = GADMediaAspectRatioAny;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

Ganti nativeAdUnitID dengan ID unit iklan Anda.

Kontrol download gambar

Kontrol download gambar memungkinkan Anda memutuskan apakah aset gambar atau hanya URI yang ditampilkan oleh SDK.

Tetapkan GADNativeAdImageAdLoaderOptions disableImageLoading dengan nilai BOOL.

  • Kontrol download gambar dinonaktifkan secara default.

  • Jika dinonaktifkan, Google Mobile Ads SDK akan mengisi gambar dan URI untuk Anda.

  • Jika diaktifkan, SDK hanya akan mengisi URI, sehingga Anda dapat mendownload gambar sebenarnya sesuai keinginan Anda.

Contoh berikut menginstruksikan SDK untuk menampilkan hanya URI.

Swift

let nativeOptions = NativeAdImageAdLoaderOptions()
nativeOptions.isImageLoadingDisabled = true

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdImageAdLoaderOptions *nativeOptions = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOptions.disableImageLoading = YES;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

Kontrol payload gambar

Beberapa iklan memiliki serangkaian gambar, bukan hanya satu gambar. Gunakan fitur ini untuk menunjukkan apakah aplikasi Anda siap menampilkan semua gambar atau hanya satu gambar.

  • Kontrol payload gambar dinonaktifkan secara default.

  • Jika dinonaktifkan, aplikasi Anda akan menginstruksikan SDK untuk menyediakan hanya gambar pertama untuk aset apa pun yang berisi rangkaian.

  • Jika diaktifkan, aplikasi Anda menunjukkan bahwa aplikasi siap menampilkan semua gambar untuk aset apa pun yang memiliki lebih dari satu gambar.

Contoh berikut menginstruksikan SDK untuk menampilkan beberapa aset gambar.

Swift

let nativeOptions = NativeAdImageAdLoaderOptions()
nativeOptions.shouldRequestMultipleImages = true

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdImageAdLoaderOptions *nativeOptions = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOptions.shouldRequestMultipleImages = YES;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

Penempatan AdChoices

Bagian ini menjelaskan cara memosisikan overlay AdChoices. Anda memiliki opsi untuk menyetel penempatannya di salah satu dari empat sudut atau merendernya dalam tampilan kustom.

Kontrol posisi AdChoices

Kontrol posisi AdChoices memungkinkan Anda memilih sudut tempat ikon AdChoices ditampilkan.

Tetapkan GADNativeAdViewAdOptions preferredAdChoicesPosition dengan nilai GADAdChoicesPosition.

  • Jika tidak disetel, posisi ikon AdChoices akan disetel ke kanan atas.

  • Jika disetel, AdChoices ditempatkan di posisi kustom sesuai permintaan.

Contoh berikut menunjukkan cara menetapkan posisi gambar AdChoices kustom.

Swift

let nativeOptions = NativeAdViewAdOptions()
nativeOptions.preferredAdChoicesPosition = .topRightCorner

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdViewAdOptions *nativeOptions = [[GADNativeAdViewAdOptions alloc] init];
nativeOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopRightCorner;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];
NativeAdOptionsSnippets.m

Tampilan kustom AdChoices

Fitur tampilan kustom AdChoices memungkinkan Anda memosisikan ikon AdChoices di lokasi kustom. Hal ini berbeda dengan kontrol posisi AdChoices, yang hanya memungkinkan penentuan salah satu dari empat sudut.

Tetapkan properti GADNativeAd.adChoicesView dengan GADAdChoicesView sebelum rendering dan konten AdChoices dirender di dalam GADAdChoicesView.

Contoh berikut menunjukkan cara menyetel tampilan AdChoices kustom. Ikon AdChoices dirender di dalam GADAdChoicesView:

Swift

private func createAdChoicesView(nativeAdView: NativeAdView) {
  // Define a custom position for the AdChoices icon.
  let customRect = CGRect(x: 100, y: 100, width: 15, height: 15)
  let customAdChoicesView = AdChoicesView(frame: customRect)
  nativeAdView.addSubview(customAdChoicesView)
  nativeAdView.adChoicesView = customAdChoicesView
}
NativeAdOptionsSnippets.swift

Objective-C

- (void)createAdChoicesViewWithNativeAdView:(GADNativeAdView *)nativeAdView {
  // Define a custom position for the AdChoices icon.
  CGRect customRect = CGRectMake(100, 100, 15, 15);
  GADAdChoicesView *customAdChoicesView = [[GADAdChoicesView alloc] initWithFrame:customRect];
  [nativeAdView addSubview:customAdChoicesView];
  nativeAdView.adChoicesView = customAdChoicesView;
}
NativeAdOptionsSnippets.m

Kontrol video

Bagian ini menjelaskan cara menyesuaikan pengalaman pemutaran untuk iklan video. Anda memiliki opsi untuk menyetel status bisu awal dan menerapkan kontrol pemutaran kustom.

Perilaku mulai membisukan

Perilaku mulai tanpa suara memungkinkan Anda menonaktifkan atau mengaktifkan audio awal video.

Tetapkan GADVideoOptions startMuted dengan nilai BOOL.

  • Perilaku mulai dalam mode senyap diaktifkan secara default.

  • Jika dinonaktifkan, aplikasi Anda meminta video harus dimulai dengan audio.

  • Jika diaktifkan, aplikasi Anda akan meminta agar video dimulai dengan audio dibisukan.

Contoh berikut menunjukkan cara memulai video dengan audio yang tidak dibisukan.

Swift

let videoOptions = VideoOptions()
videoOptions.shouldStartMuted = false

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [videoOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADVideoOptions *videoOptions = [[GADVideoOptions alloc] init];
videoOptions.startMuted = NO;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ videoOptions ]];
NativeAdOptionsSnippets.m

Kontrol pemutaran kustom

Dengan demikian, Anda dapat meminta kontrol input video kustom untuk memutar, menjeda, atau membisukan video.

Tetapkan GADVideoOptions customControlsRequested dengan nilai BOOL.

  • Kontrol pemutaran kustom dinonaktifkan secara default.

  • Jika dinonaktifkan, video Anda akan menampilkan kontrol input yang dirender SDK.

Jika iklan memiliki konten video dan kontrol kustom diaktifkan, Anda harus menampilkan kontrol kustom bersama iklan, karena iklan tidak akan menampilkan kontrol apa pun. Kontrol kemudian dapat memanggil metode yang relevan pada

GADVideoController.

Contoh berikut menunjukkan cara meminta video dengan kontrol pemutaran kustom.

Swift

let videoOptions = VideoOptions()
videoOptions.areCustomControlsRequested = true

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [videoOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADVideoOptions *videoOptions = [[GADVideoOptions alloc] init];
videoOptions.customControlsRequested = YES;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ videoOptions ]];
NativeAdOptionsSnippets.m

Memeriksa apakah kontrol kustom diaktifkan

Karena tidak diketahui pada waktu permintaan apakah iklan yang ditampilkan akan mengizinkan kontrol video kustom, Anda harus memeriksa apakah kontrol kustom diaktifkan.

Swift

private func checkCustomControlsEnabled(nativeAd: NativeAd) -> Bool {
  let videoController = nativeAd.mediaContent.videoController
  return videoController.areCustomControlsEnabled
}
NativeAdOptionsSnippets.swift

Objective-C

- (BOOL)checkCustomControlsEnabledWithNativeAd:(GADNativeAd *)nativeAd {
  GADVideoController *videoController = nativeAd.mediaContent.videoController;
  return videoController.customControlsEnabled;
}
NativeAdOptionsSnippets.m

Merender kontrol video kustom

Render kontrol video kustom menggunakan praktik terbaik berikut:

  1. Tampilkan tampilan kontrol kustom sebagai turunan dari tampilan iklan native. Pendekatan ini memungkinkan perhitungan visibilitas pengukuran terbuka mempertimbangkan kontrol kustom sebagai penghalang yang tidak mengganggu.
  2. Hindari merender overlay yang tidak terlihat di seluruh tampilan media. Overlay memblokir klik pada tampilan media, sehingga berdampak negatif pada performa iklan native. Sebagai gantinya, buat overlay kecil yang cukup besar untuk memuat kontrol.

Gestur klik kustom

Gestur klik kustom adalah fitur iklan native yang memungkinkan gesekan pada tampilan iklan dicatat sebagai klik iklan. Fitur ini didesain untuk berfungsi dengan aplikasi yang menggunakan gestur geser untuk navigasi konten. Panduan ini menunjukkan cara mengaktifkan gestur klik kustom di iklan native Anda.

Lakukan inisialisasi instance GADNativeAdCustomClickGestureOptions dengan arah geser yang Anda pilih. Anda juga perlu menunjukkan 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 mengimplementasikan gestur geser kustom ke kanan dan mempertahankan perilaku ketuk normal.

Swift

let swipeGestureOptions = NativeAdCustomClickGestureOptions(
  swipeGestureDirection: .right,
  tapsAllowed: true)

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [swipeGestureOptions])
NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdCustomClickGestureOptions *swipeGestureOptions =
    [[GADNativeAdCustomClickGestureOptions alloc]
        initWithSwipeGestureDirection:UISwipeGestureRecognizerDirectionRight
                          tapsAllowed:YES];

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ swipeGestureOptions ]];
NativeAdOptionsSnippets.m

Memproses peristiwa gestur geser

Saat klik gestur geser direkam, Google Mobile Ads SDK memanggil metode delegasi nativeAdDidRecordSwipeGestureClick: di GADNativeAdDelegate , selain metode delegasi nativeAdDidRecordClick: yang ada.

Swift

// Called when a swipe gesture click is recorded, as configured in
// NativeAdCustomClickGestureOptions.
func nativeAdDidRecordSwipeGestureClick(_ nativeAd: NativeAd) {
  print("A swipe gesture click has occurred.")
}

// Called when a swipe gesture click or a tap click is recorded.
func nativeAdDidRecordClick(_ nativeAd: NativeAd) {
  print("A swipe gesture click or tap click has occurred.")
}
NativeAdOptionsSnippets.swift

Objective-C

// Called when a swipe gesture click is recorded, as configured in
// GADNativeAdCustomClickGestureOptions.
- (void)nativeAdDidRecordSwipeGestureClick:(GADNativeAd *)nativeAd {
  NSLog(@"A swipe gesture click has occurred.");
}

// Called when a swipe gesture click or a tap click is recorded.
- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
  NSLog(@"A swipe gesture click or tap click has occurred.");
}
NativeAdOptionsSnippets.m

Mediasi

Gestur klik kustom hanya berfungsi pada iklan native yang dirender oleh Google Mobile Ads SDK. Sumber iklan yang memerlukan SDK pihak ketiga untuk rendering, tidak merespons setelan arah klik kustom.