Tùy chọn quảng cáo gốc

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

Kiểm soát thành phần

Chế độ kiểm soát tỷ lệ khung hình cho nội dung nghe nhìn ưu tiê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 chính sách này, quảng cáo được trả về có thể có tỷ lệ khung hình nội dung nghe nhìn bất kỳ.

  • Khi đặt giá trị này, 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 một hình ảnh hoặc video trả lại có tỷ lệ khung hình cụ thể.

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

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 thành phần hình ảnh hay chỉ URI được SDK trả về.

Đặt GADNativeAdImageAdLoaderOptions disableImageLoading có giá trị BOOL.
  • Theo mặc định, chế độ kiểm soát việc tải hình ảnh xuống bị tắt.

  • Khi tắt, SDK quảng cáo trên thiết bị di động của Google 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 xuống hình ảnh thực tế theo ý bạn.

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

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 đã được chuẩn bị để hiện toàn bộ hình ảnh hay chỉ một hình ảnh.

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

  • Khi bị 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ỳ nội dung nào chứa một chuỗi.

  • Khi được bật, ứng dụng của bạn sẽ 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ỳ nội dung nào có nhiều hơn một.

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

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

Vị trí Lựa chọn quảng cáo

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

Các tùy chọn kiểm soát vị trí 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 GADAdChoicesPosition giá trị.

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

  • Nếu được đặt, phầ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 minh hoạ cách đặt vị trí hình ảnh Lựa chọn quảng cáo tuỳ chỉnh.

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOptions ]];

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 trong vị trí tùy chỉnh. Điều này khác với các chế độ kiểm soát vị trí Lựa chọn quảng cáo, vốn chỉ cho phép chỉ định một trong bốn góc.

Đặt GADNativeAd.adChoicesView thuộc tính có GADAdChoicesView trước khi hiển thị và nội dung Lựa chọn quảng cáo sẽ hiển thị bên trong GADAdChoicesView.

Ví dụ sau minh hoạ cách đặt chế độ xem Lựa chọn quảng cáo tuỳ chỉnh. Chiến lược phát hành đĩa đơn Biểu tượng Lựa chọn quảng cáo sẽ hiển thị bên trong 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;
}

Điều khiển video

Bắt đầu hành vi tắt tiếng

Chế độ tắt tiếng bắt đầu cho phép bạn tắt hoặc bật âm thanh bắt đầu của video.

Đặt GADVideoOptions startMuted có giá trị BOOL.
  • Chế độ bắt đầu tắt tiếng được bật theo mặc định.

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

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

Ví dụ sau đây trình bày cách bắt đầu video có âm thanh bật tiếng.

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOptions ]];

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

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

Đặt GADVideoOptions customControlsRequested có giá trị BOOL.
  • Bộ điều khiển chế độ phát tuỳ chỉnh bị tắt theo mặc định.

  • Khi bạn tắt tính năng này, video của bạn sẽ hiển thị các chế độ đ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à các chế độ điều khiển tuỳ chỉnh đang được bật, bạn nên thì hiển thị các nút điều khiển tuỳ chỉnh cùng với quảng cáo, vì quảng cáo sẽ không hiển thị bất kỳ tự điều khiển. Sau đó, chế độ kiểm soát có thể gọi các phương thức liên quan trên GADVideoController.

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

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

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOptions ]];

Kiểm tra xem bạn đã bật chế độ điều khiển tuỳ chỉnh hay chưa

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

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
}

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

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

Khởi động GADNativeAdCustomClickGestureOptions thực thể với hướng vuốt đã chọn. Bạn cũng cần cho biết liệu bạn muốn cho phép các thao tác nhấn dưới dạng nhấp chuột.

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

  • Khi bạn tắt tính năng này, 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 vẫn có thể được tính là lượt nhấp hay không.

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

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 ]];

Nghe sự kiện cử chỉ vuốt

Khi lần 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 nativeAdDidRecordSwipeGestureClick: phương thức uỷ quyền trên GADNativeAdDelegate , ngoài nativeAdDidRecordClick: hiện có uỷ quyền.

#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.");
}

Dàn xếp

Cử chỉ nhấp chuột tùy chỉnh chỉ hoạt động trên quảng cáo gốc mà Google Mobile SDK quảng cáo hiển thị. Nguồn quảng cáo cần có SDK của bên thứ ba để hiển thị, không phản hồi với chế độ cài đặt đường nhấp chuột tuỳ chỉnh.