Trang này được dịch bởi Cloud Translation API.

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

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

Chế độ 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 nội dung đa phương tiệ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.

Gọi NativeAdOptions.Builder.setMediaAspectRatio() bằng NativeAdOptions.MediaAspectRatio giá trị.

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

NativeAdOptions nativeAdOptions = new NativeAdOptions.Builder()
                              .setMediaAspectRatio(NativeAdOptions.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
                              .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

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

Gọi NativeAdOptions.Builder.setReturnUrlsForImageAssets() với giá trị boolean.

Theo mặc định, chế độ kiểm soát tải hình ảnh xuống bị tắt.
Khi bạn tắt tính năng này, 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 quyết định của riêng mình.

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

NativeAdOptions nativeAdOptions = new NativeAdOptions.Builder()
                                                     .setReturnUrlsForImageAssets(true)
                                                     .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(nativeAdOptions)
                              .forNativeAd(nativeAd -> {
                                List<Uri> imageUris = new ArrayList<>();
                                for (Image image : nativeAd.getImages()) {
                                  imageUris.add(image.getUri());
                                }
                              })
                              .build();

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

Gọi NativeAdOptions.Builder.setRequestMultipleImages() có giá trị boolean.

Theo mặc định, các chế độ kiểm soát tải trọng hình ảnh sẽ bị tắt.
Khi bạn tắt tính năng này, ứ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 loạt hình ảnh.
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.

NativeAdOptions nativeAdOptions = new NativeAdOptions.Builder()
                                                     .setRequestMultipleImages(true)
                                                     .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

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

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

Các chế độ điều khiển 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.

Gọi NativeAdOptions.Builder.setAdChoicesPlacement() với giá trị NativeAdOption.AdChoicesPlacement.

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, 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 đây minh hoạ cách đặt vị trí hình ảnh tuỳ chỉnh cho Lựa chọn quảng cáo.

NativeAdOptions nativeAdOptions = new NativeAdOptions.Builder()
                                                     .setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
                                                     .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

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

Tính năng chế độ xem tuỳ chỉnh của 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 các chế độ kiểm soát vị trí của biểu tượng Lựa chọn quảng cáo, chỉ cho phép chỉ định một trong bốn góc.

Gọi NativeAdView.setAdChoicesView() với giá trị AdChoicesView.

Ví dụ sau minh hoạ cách đặt chế độ xem Lựa chọn quảng cáo tuỳ chỉnh, với Biểu tượng Lựa chọn quảng cáo xuất hiện bên trong AdChoicesView.


public void onNativeAdLoaded(NativeAd ad) {
    NativeAdView nativeAdView = new NativeAdView(getApplicationContext());
    AdChoicesView adChoicesView = new AdChoicesView(this);
    nativeAdView.setAdChoicesView(adChoicesView);
}

Đ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.

Gọi VideoOptions.Builder.setStartMuted() có giá trị boolean.

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 đượ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.

VideoOptions videoOptions = new VideoOptions.Builder()
                                            .setStartMuted(false)
                                            .build();

NativeAdOptions adOptions = new NativeAdOptions.Builder()
                                               .setVideoOptions(videoOptions)
                                               .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(adOptions).build();

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

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

Gọi VideoOptions.Builder.setCustomControlsRequested() với giá trị boolean.

Theo mặc định, chế độ điều khiển chế độ phát tuỳ chỉnh sẽ bị tắt.
Khi tắt, 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à 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 VideoController.

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.

VideoOptions videoOptions = new VideoOptions.Builder()
                                            .setCustomControlsRequested(true)
                                            .build();

NativeAdOptions adOptions = new NativeAdOptions.Builder()
                                               .setVideoOptions(videoOptions)
                                               .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(adOptions).build();

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

Vì không biết tại thời điểm yêu cầu 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, 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.

Java

@Override
public void onNativeAdLoaded(NativeAd nativeAd) {
  MediaContent mediaContent = nativeAd.getMediaContent();
  if (mediaContent != null) {
    VideoController videoController = mediaContent.getVideoController();
    boolean canShowCustomControls = videoController.isCustomControlsEnabled();
  }
}

Kotlin

NativeAd.OnNativeAdLoadedListener { ad ->
  val mediaContent = ad.mediaContent
  if (mediaContent != null) {
    val videoController = mediaContent.videoController
    val canShowCustomControls = videoController.isCustomControlsEnabled
  }
}

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

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

Hiển thị thành phần hiển thị tuỳ chỉnh làm 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 đảm bảo rằng việc tính toán khả năng xem đo lường mở sẽ coi các thành phần điều khiển tuỳ chỉnh là yếu tố che khuất chấp nhận được.
Tránh hiển thị lớp phủ không nhìn thấy được trên toàn bộ chế độ xem nội dung nghe nhìn. Lớp phủ chặn 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 quảng cáo gốc. Thay vào đó, hãy tạo một lớp phủ nhỏ vừa đủ lớn để vừa với các nút điều khiển.

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.

Gọi NativeAdOptions.Builder.enableCustomClickGestureDirection() bằng NativeAdOptions.SwipeGestureDirection và boolean để cho biết liệu bạn có muốn cho phép các thao tác nhấn dưới dạng lượt nhấp hay không.

Các cử chỉ nhấp tuỳ chỉnh bị tắt theo mặc định.
Khi bị tắt, ứng dụng của bạn sẽ hỗ trợ hành vi nhấp chuột thông thường.
Khi bạn bật tuỳ chọn này, ứng dụng của bạn sẽ hỗ trợ các cử chỉ vuốt tuỳ chỉnh.

Ví dụ sau đây triển khai một cử chỉ vuốt tuỳ chỉnh sang phải và giữ nguyên hành vi của thẻ thông thường.

NativeAdOptions adOptions = new NativeAdOptions
    .Builder()
    .enableCustomClickGestureDirection(NativeAdOptions.SWIPE_GESTURE_DIRECTION_RIGHT,
            /* tapsAllowed= */ true)
    .build();

// The following sample ad unit ID has been enabled for custom click gestures
// and can be used for testing.
AdLoader.Builder builder = new AdLoader
    .Builder(this, 'ca-app-pub-3940256099942544/2247696110')
    .withNativeAdOptions(adOptions);

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 Phương thức onAdSwipeGestureClicked() trên AdListener, ngoài phương thức hiện có onAdClicked().

AdLoader adLoader = builder
    .withAdListener(
      new AdListener() {
        // Called when a swipe gesture click is recorded.
        @Override
        public void onAdSwipeGestureClicked() {
          Log.d(TAG, "A swipe gesture click has occurred.")
        }

        // Called when a swipe gesture click or a tap click is recorded, as
        // configured in NativeAdOptions.
        @Override
        public void onAdClicked() {
          Log.d(TAG, "A swipe gesture click or a tap click has occurred.")
        }
      })
    .build();

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.