Thiết lập các tính năng nâng cao của quảng cáo gốc

Chọn nền tảng: Android (thử nghiệm) Android iOS

Quảng cáo gốc có nhiều tính năng nâng cao cho phép bạn tuỳ chỉnh thêm và tạo trải nghiệm quảng cáo tốt nhất có thể. Hướng dẫn này trình bày 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

• Tích hợp Định dạng quảng cáo gốc.

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.

Chế độ kiểm soát tỷ lệ khung hình ưu tiên của nội dung nghe nhìn

Chế độ kiểm soát 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 cho tỷ lệ khung hình của mẫu quảng cáo.

Đặt GADNativeAdMediaAdLoaderOptions mediaAspectRatio bằng GADMediaAspectRatio.

• Khi bạn không đặt, quảng cáo được trả về có thể có tỷ lệ khung hình của nội dung nghe nhìn bất kỳ.

• Khi bạn đặt, bạn 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 trả về hình ảnh hoặc video có tỷ lệ khung hình cụ thể.

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

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

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 tải hình ảnh xuống

Chế độ kiểm soát 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.

• Chế độ kiểm soát tải hình ảnh xuống ở trạng thái tắt theo mặc định.

• Khi bạn tắt, Google Mobile Ads SDK sẽ điền cả hình ảnh và URI cho bạn.

• Khi được bật, SDK sẽ chỉ điền URI, cho phép bạn tải hình ảnh thực xuống theo quyết định của riêng mình.

Ví dụ sau đây hướng dẫn SDK chỉ trả về URI.

let nativeOptions = NativeAdImageAdLoaderOptions()
nativeOptions.isImageLoadingDisabled = true

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

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 tải trọng 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.

• Chế độ kiểm soát tải trọng hình ảnh ở trạng thái tắt theo mặc định.

• Khi bạn tắt, ứng dụng của bạn sẽ hướng dẫn SDK chỉ cung cấp hình ảnh đầu tiên cho bất kỳ thành phần nào có chứa một loạt hình ảnh.

• Khi bạn 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 bất kỳ thành phần nào 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.

let nativeOptions = NativeAdImageAdLoaderOptions()
nativeOptions.shouldRequestMultipleImages = true

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

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 nhãn 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ủ Lựa chọn quảng cáo. Bạn có thể đặt vị trí của lớp phủ này ở một trong bốn góc hoặc hiển thị lớp phủ này trong một thành phần hiển thị tuỳ chỉnh.

Chế độ kiểm soát vị trí đặt nhãn Lựa chọn quảng cáo

Chế độ kiểm soát vị trí đặt nhãn 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í đặt biểu tượng Lựa chọn quảng cáo sẽ được đặt ở góc trên cùng bên phải.

• Nếu bạn đặt, nhãn 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í tuỳ chỉnh cho hình ảnh Lựa chọn quảng cáo.

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

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

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

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

Thành phần hiển thị tuỳ chỉnh cho nhãn Lựa chọn quảng cáo

Tính năng thành phần hiển thị tuỳ chỉnh cho nhãn 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. Tính năng này khác với chế độ kiểm soát vị trí đặt nhãn Lựa chọn quảng cáo, 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 hiển thị và nội dung Lựa chọn quảng cáo hiển thị bên trong GADAdChoicesView.

Ví dụ sau đây minh hoạ cách đặt thành phần hiển thị tuỳ chỉnh cho nhãn Lựa chọn quảng cáo. Biểu tượng Lựa chọn quảng cáo hiển thị bên trong GADAdChoicesView:

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

- (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 chế độ kiểm soát phát tuỳ chỉnh.

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

Hành vi bắt đầu 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 tắt tiếng được bật theo mặc định.

• Khi bạn tắt, ứng dụng của bạn sẽ yêu cầu video bắt đầu có âm thanh.

• Khi bạn bật, ứng dụng của bạn sẽ yêu cầu video bắt đầu ở trạng thái tắt tiếng.

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

let videoOptions = VideoOptions()
videoOptions.shouldStartMuted = false

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

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

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

Chế độ kiểm soát phát tuỳ chỉnh

Tính năng này cho phép bạn yêu cầu chế độ kiểm soát đầ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.

• Chế độ kiểm soát phát tuỳ chỉnh ở trạng thái tắt theo mặc định.

• Khi tắt, video của bạn sẽ hiển thị các chế độ kiểm soát đầu vào do SDK hiển thị.

• Khi bạn bật, bạn có thể sử dụng GADVideoController play , GADVideoController pause và GADVideoController setMute để kiểm soát quảng cáo dạng video.

Nếu quảng cáo có nội dung video và bạn bật chế độ kiểm soát tuỳ chỉnh, thì bạn nên hiển thị 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 đó, 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 thấy cách yêu cầu video có chế độ kiểm soát phát tuỳ chỉnh.

let videoOptions = VideoOptions()
videoOptions.areCustomControlsRequested = true

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

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 chế độ kiểm soát tuỳ chỉnh đã được bật hay chưa

Vì bạn không biết liệu quảng cáo được trả về có cho phép chế độ kiểm soát 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 đó đã bật chế độ kiểm soát tuỳ chỉnh hay chưa.

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

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

Hiển thị chế độ kiểm soát video tuỳ chỉnh

Hiển thị chế độ kiểm soát video tuỳ chỉnh theo các phương pháp hay nhất sau đây:

1. Hiển thị thành phần hiển thị chế độ kiểm soát tuỳ chỉnh dưới dạng thành phần con của thành phần hiển thị quảng cáo gốc. Phương pháp này cho phép tính toán khả năng xem của tính năng đo lường mở coi chế độ kiểm soát tuỳ chỉnh là thành phần che khuất thân thiện.
2. Tránh hiển thị lớp phủ vô hình trên toàn bộ trung tâm nghe nhìn. Lớp phủ chặn các lượt nhấp vào trung tâm 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ỏ vừa đủ để chứa các chế độ kiểm soát.