Tuỳ chọn quảng cáo gốc

Chọn nền tảng: Android iOS

Quảng cáo gốc có nhiều tính năng nâng cao giúp bạn tuỳ chỉnh thêm và mang lại trải nghiệm quảng cáo tốt nhất có thể. Hướng dẫn này cho bạn biết cách sử dụng các tính năng nâng cao của quảng cáo gốc.

Điều kiện tiên quyết

Chế độ kiểm soát thành phần

Phần này trình bày chi tiết cách tuỳ chỉnh các thành phần mẫu quảng cáo trong quảng cáo gốc. Bạn có thể chỉ định tỷ lệ khung hình ưu tiên cho thành phần nội dung nghe nhìn và cách tải xuống cũng như hiển thị thành phần hình ảnh.

Các nút điều khiển tỷ lệ khung hình ưu tiên cho nội dung nghe nhìn

Các nút điều khiển tỷ lệ khung hình của nội dung nghe nhìn cho phép bạn chỉ định lựa chọn ưu tiên về tỷ lệ khung hình của mẫu quảng cáo.

Đặt GADNativeAdMediaAdLoaderOptions mediaAspectRatio bằng GADMediaAspectRatio.

  • Khi chưa đặt, quảng cáo được trả về có thể có tỷ lệ khung hình bất kỳ.

  • Khi đặt, bạn sẽ có thể cải thiện trải nghiệm người dùng bằng cách chỉ định loại tỷ lệ khung hình ưu tiên.

Ví dụ sau đây hướng dẫn SDK ưu tiên hình ảnh hoặc video trả về có tỷ lệ khung hình cụ thể.

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

Thay thế nativeAdUnitID bằng mã đơn vị quảng cáo của bạn.

Chế độ kiểm soát việc tải hình ảnh xuống

Chế độ kiểm soát việc tải hình ảnh xuống cho phép bạn quyết định xem SDK sẽ trả về thành phần hình ảnh hay chỉ URI.

Đặt GADNativeAdImageAdLoaderOptions disableImageLoading bằng giá trị BOOL.

  • Theo mặc định, chế độ kiểm soát việc tải hình ảnh xuống sẽ bị tắt.

  • Khi bị vô hiệu hoá, SDK Quảng cáo của Google trên thiết bị di động sẽ điền cả hình ảnh và URI cho bạn.

  • Khi được bật, SDK chỉ điền URI, cho phép bạn tải hình ảnh thực xuống theo ý bạn.

Ví dụ sau đây hướng dẫn SDK chỉ trả về 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

Chế độ kiểm soát trọng tải hình ảnh

Một số quảng cáo có một loạt hình ảnh thay vì chỉ một hình ảnh. Sử dụng tính năng này để cho biết liệu ứng dụng của bạn đã sẵn sàng hiển thị tất cả hình ảnh hay chỉ một hình ảnh.

  • Theo mặc định, các chế độ kiểm soát tải trọng hình ảnh sẽ bị tắt.

  • Khi bị vô hiệu hoá, ứng dụng của bạn sẽ chỉ thị cho SDK chỉ cung cấp hình ảnh đầu tiên cho mọi thành phần có chứa một loạt hình ảnh.

  • Khi được bật, ứng dụng của bạn cho biết rằng ứng dụng đã sẵn sàng hiển thị tất cả hình ảnh cho mọi thành phần có nhiều hình ảnh.

Ví dụ sau đây hướng dẫn SDK trả về nhiều thành phần hình ảnh.

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

Vị trí đặt biểu tượng Lựa chọn quảng cáo

Phần này trình bày chi tiết cách đặt lớp phủ AdChoices. Bạn có thể đặt vị trí của chú thích ở một trong bốn góc hoặc hiển thị chú thích trong một khung hiển thị tuỳ chỉnh.

Chế độ kiểm soát vị trí của biểu tượng Lựa chọn quảng cáo

Các chế độ kiểm soát vị trí của biểu tượng Lựa chọn quảng cáo cho phép bạn chọn góc để hiển thị biểu tượng Lựa chọn quảng cáo.

Đặt GADNativeAdViewAdOptions preferredAdChoicesPosition bằng giá trị GADAdChoicesPosition.

  • Nếu bạn không đặt, vị trí biểu tượng Lựa chọn quảng cáo sẽ được đặt ở trên cùng bên phải.

  • Nếu được đặt, biểu tượng Lựa chọn quảng cáo sẽ được đặt ở vị trí tuỳ chỉnh theo yêu cầu.

Ví dụ sau đây minh hoạ cách đặt vị trí hình ảnh Lựa chọn quảng cáo tuỳ chỉnh.

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

Chế độ xem tuỳ chỉnh Lựa chọn quảng cáo

Tính năng chế độ xem tuỳ chỉnh Lựa chọn quảng cáo cho phép bạn đặt biểu tượng Lựa chọn quảng cáo ở một vị trí tuỳ chỉnh. Điều này khác với chế độ kiểm soát vị trí của biểu tượng Lựa chọn quảng cáo, chế độ này chỉ cho phép chỉ định một trong bốn góc.

Đặt thuộc tính GADNativeAd.adChoicesView bằng GADAdChoicesView trước khi kết xuất và nội dung Lựa chọn quảng cáo kết xuất bên trong GADAdChoicesView.

Ví dụ sau đây minh hoạ cách đặt một khung hiển thị Lựa chọn quảng cáo tuỳ chỉnh. Biểu tượng Lựa chọn quảng cáo hiển thị bên trong 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

Điều khiển video

Phần này trình bày chi tiết cách tuỳ chỉnh trải nghiệm phát cho quảng cáo dạng video. Bạn có thể đặt trạng thái tắt tiếng ban đầu và triển khai các chế độ phát tuỳ chỉnh.

Hành vi bắt đầu ở chế độ tắt tiếng

Hành vi bắt đầu ở trạng thái tắt tiếng cho phép bạn tắt hoặc bật âm thanh bắt đầu của video.

Đặt GADVideoOptions startMuted bằng giá trị BOOL.

  • Hành vi bắt đầu ở chế độ tắt tiếng được bật theo mặc định.

  • Khi bị tắt, ứng dụng của bạn yêu cầu video phải bắt đầu bằng âm thanh.

  • Khi được bật, ứng dụng của bạn sẽ yêu cầu video bắt đầu ở chế độ tắt tiếng.

Ví dụ sau đây cho thấy cách bắt đầu video với âm thanh không bị tắt tiếng.

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

Bộ điều khiển chế độ phát tuỳ chỉnh

Nhờ đó, bạn có thể yêu cầu bộ điều khiển đầu vào video tuỳ chỉnh để phát, tạm dừng hoặc tắt tiếng video.

Đặt GADVideoOptions customControlsRequested bằng giá trị BOOL.

  • Bộ điều khiển chế độ phát tuỳ chỉnh bị tắt theo mặc định.

  • Khi tắt chế độ này, video của bạn sẽ hiển thị các nút điều khiển đầu vào do SDK kết xuất.

Nếu quảng cáo có nội dung video và bạn đã bật các chế độ kiểm soát tuỳ chỉnh, thì bạn nên hiển thị các chế độ kiểm soát tuỳ chỉnh cùng với quảng cáo, vì quảng cáo sẽ không tự hiển thị bất kỳ chế độ kiểm soát nào. Sau đó, các chế độ kiểm soát có thể gọi các phương thức có liên quan trên

GADVideoController.

Ví dụ sau đây cho biết cách yêu cầu một video có chế độ điều khiển phát tuỳ chỉnh.

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

Kiểm tra xem bạn đã bật chế độ kiểm soát tuỳ chỉnh hay chưa

Vì không biết liệu quảng cáo được trả về có cho phép bộ điều khiển video tuỳ chỉnh hay không tại thời điểm yêu cầu, nên bạn phải kiểm tra xem quảng cáo đó có bật bộ điều khiển tuỳ chỉnh hay không.

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

Hiển thị bộ điều khiển video tuỳ chỉnh

Hiển thị bộ điều khiển video tuỳ chỉnh theo các phương pháp hay nhất sau:

  1. Hiển thị chế độ xem các chế độ kiểm soát tuỳ chỉnh dưới dạng phần tử con của chế độ xem quảng cáo gốc. Phương pháp này cho phép các phép tính khả năng xem theo phương pháp đo lường mở coi các chế độ kiểm soát tuỳ chỉnh là thành phần che khuất chấp nhận được.
  2. Tránh hiển thị một lớp phủ vô hình trên toàn bộ khung hiển thị nội dung nghe nhìn. Lớp phủ chặn các lượt nhấp vào chế độ xem nội dung nghe nhìn, ảnh hưởng tiêu cực đến hiệu suất của quảng cáo gốc. Thay vào đó, hãy tạo một lớp phủ nhỏ, chỉ đủ lớn để chứa các nút điều khiển.

Cử chỉ nhấp tuỳ chỉnh

Thao tác nhấp tuỳ chỉnh là một tính năng của quảng cáo gốc, cho phép thao tác vuốt trên chế độ xem quảng cáo được đăng ký dưới dạng lượt nhấp vào quảng cáo. Thanh này được thiết kế để hoạt động với những ứng dụng dùng cử chỉ vuốt để điều hướng nội dung. Hướng dẫn này trình bày cách bật cử chỉ nhấp tuỳ chỉnh trên quảng cáo gốc.

Khởi chạy một thực thể GADNativeAdCustomClickGestureOptions bằng hướng vuốt mà bạn đã chọn. Bạn cũng cần cho biết liệu bạn có muốn cho phép lượt nhấn được tính là lượt nhấp hay không.

  • Cử chỉ nhấp tuỳ chỉnh bị tắt theo mặc định.

  • Khi chế độ này bị tắt, chỉ những lượt nhấn mới được tính là lượt nhấp.

  • Khi được bật, cử chỉ vuốt sẽ được tính là lượt nhấp và bạn có thể chỉ định liệu thao tác nhấn có được tính là lượt nhấp hay không.

Ví dụ sau đây minh hoạ cách triển khai một cử chỉ vuốt tuỳ chỉnh sang phải và duy trì hành vi nhấn thông thường.

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

Theo dõi các sự kiện cử chỉ vuốt

Khi một lượt nhấp bằng cử chỉ vuốt được ghi lại, SDK quảng cáo trên thiết bị di động của Google sẽ gọi phương thức uỷ quyền nativeAdDidRecordSwipeGestureClick: trên GADNativeAdDelegate, ngoài phương thức uỷ quyền nativeAdDidRecordClick: hiện có.

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

Dàn xếp

Cử chỉ nhấp tuỳ chỉnh chỉ hoạt động trên những quảng cáo gốc mà SDK quảng cáo trên thiết bị di động của Google hiển thị. Những nguồn quảng cáo yêu cầu SDK của bên thứ ba để hiển thị sẽ không phản hồi chế độ cài đặt hướng nhấp chuột tuỳ chỉnh.