此页面由 Cloud Translation API 翻译。

原生广告选项

原生广告有很多高级功能，让您可进行更多自定义，打造出尽可能出色的广告体验。本指南介绍了如何使用原生广告的高级功能。

前提条件

集成原生广告格式。

素材资源控件

本部分详细介绍了如何自定义原生广告中的广告素材资源。您可以选择为媒体素材资源指定偏好的宽高比，还可以指定图片素材资源的下载和显示方式。

首选媒体宽高比控件

借助媒体宽高比控件，您可以指定广告素材的宽高比偏好设置。

使用 NativeAd.NativeMediaAspectRatio 值调用 NativeAdRequest.Builder.setMediaAspectRatio()。

如果未设置此控件，则返回的广告可以采用任意媒体宽高比。
如果设置了此控件，您将能够指定首选的宽高比类型来改善用户体验。

以下示例指示 SDK 优先返回具有特定宽高比的图片或视频。

Kotlin

val adRequest = NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  listOf(NativeAd.NativeAdType.NATIVE))
  .setMediaAspectRatio(NativeAd.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
  .build()

Java

NativeAdRequest adRequest = new NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  List.of(NativeAd.NativeAdType.NATIVE))
  .setMediaAspectRatio(NativeAd.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
  .build();

图片下载控件

借助图片下载控件，您可以决定 SDK 是返回图片素材资源还是仅返回 URI。

调用 NativeAdRequest.Builder.disableImageDownloading()。

图片下载控件默认处于停用状态。
停用后，Google 移动广告 SDK（Beta 版）会为您填充图片和 URI。
该控件处于启用状态时，SDK 将仅填充 URI，以便您可自行决定是否下载实际图片。

以下示例指示 SDK 仅返回 URI。

Kotlin

val adRequest = NativeAdRequest.Builder(
    "ca-app-pub-3940256099942544/2247696110",
    listOf(NativeAd.NativeAdType.NATIVE))
    .setMediaAspectRatio(NativeAd.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
    .disableImageDownloading()
    .build()

val adCallback: NativeAdLoaderCallback =
  object : NativeAdLoaderCallback {
    override fun onNativeAdLoaded(nativeAd: NativeAd) {
      // Get the image uri.
      val imageUri = nativeAd.image?.uri
    }
  };

// Load the native ad with the ad request and callback.
NativeAdLoader.load(adRequest, adLoaderCallback);

Java

NativeAdRequest adRequest = new NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  List.of(NativeAd.NativeAdType.NATIVE))
  .disableImageDownloading()
  .build();

NativeAdLoaderCallback adLoaderCallback =
  new NativeAdLoaderCallback() {
    @Override
    public void onNativeAdLoaded(@NonNull NativeAd nativeAd) {
      // Get the image uri.
      Uri imageUri = nativeAd.getImage().getUri();
    }
  };

// Load the native ad with the ad request and callback.
NativeAdLoader.load(adRequest, adLoaderCallback);

图片载荷控件

有些广告包含一系列图片，而不只是一张图片。使用此功能可指明您的应用是可以展示所有图片，还是只能展示一张图片。

图片载荷控件默认处于停用状态。
停用后，您的应用会指示 SDK，对于包含一系列图片的任何素材资源，仅提供第一张图片。
启用后，您的应用会指示它已做好准备，可为包含多张图片的任何素材资源展示所有图片。

以下示例指示 SDK 返回多个图片素材资源。

“广告选项”图标位置

本部分详细介绍了如何定位“广告选项”叠加层。您可以选择将其放置在四个角中的任意一个，也可以在自定义视图中呈现它。

“广告选项”位置控件

借助“广告选项”位置控件，您可以选择在哪个角落呈现“广告选项”图标。

使用 NativeAdRequest.AdChoicesPlacement 值调用 NativeAdRequest.Builder.setAdChoicesPlacement()。

如果未设置此控件，“广告选项”图标位置会设为右上角。
如果设置了此控件，“广告选项”图标会放置在所请求的自定义位置。

以下示例演示了如何设置自定义“广告选项”图标位置。

Kotlin

val adRequest = NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  listOf(NativeAd.NativeAdType.NATIVE))
  .setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
  .build()

Java

NativeAdRequest adRequest = new NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  List.of(NativeAd.NativeAdType.NATIVE))
  .setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
  .build();

“广告选项”自定义视图

借助“广告选项”自定义视图功能，您可以将“广告选项”图标放置在自定义位置。这与“广告选项”位置控件不同，后者仅允许指定放置在四个角中的某一角。

使用 AdChoicesView 值调用 NativeAdView.setAdChoicesView()。

以下示例演示了如何设置自定义“广告选项”视图，其中“广告选项”图标显示在 AdChoicesView 内。

Kotlin

override fun onNativeAdLoaded(nativeAd: NativeAd) {
  val nativeAdView = NativeAdView(applicationContext)
  val adChoicesView = AdChoicesView(this)
  nativeAdView.adChoicesView = adChoicesView
}

Java

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

视频控件

本部分详细介绍了如何自定义视频广告的播放体验。您可以选择设置初始静音状态并实现自定义播放控件。

开始播放时是否静音

借助“开始播放时是否静音”选项，您可以禁止或允许在视频开始时播放音频。

使用 boolean 值调用 VideoOptions.Builder.setStartMuted()，并调用 NativeAdOptions.Builder.setVideoOptions()。

“开始播放时是否静音”选项默认处于启用状态。
停用后，您的应用会请求在开始播放视频时也播放音频。
启用后，您的应用会请求视频在开始播放时静音。

以下示例展示了如何以非静音方式开始播放视频。

Kotlin

val videoOptions = VideoOptions.Builder()
  .setStartMuted(false)
  .build()

val adRequest = NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  listOf(NativeAd.NativeAdType.NATIVE))
  .setVideoOptions(videoOptions)
  .build()

Java

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

NativeAdRequest adRequest = new NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  List.of(NativeAd.NativeAdType.NATIVE))
  .setVideoOptions(videoOptions)
  .build()

自定义播放控件

这样一来，您就可以请求自定义视频输入控件来对视频进行播放、暂停或静音操作。

如需设置广告开始时的静音状态，请调用 VideoOptions.Builder.setCustomControlsRequested()。

自定义播放控件默认处于停用状态。
停用后，您的视频将显示由 SDK 呈现的输入控件。

如果广告确实包含视频内容，并且已启用自定义控件，那么您应在展示广告的同时显示自定义控件，因为广告本身不会显示任何控件。然后，控件可以对以下对象调用相关方法：

VideoOptions.Builder.setCustomControlsRequested()。

以下示例展示了如何请求包含自定义播放控件的视频。

Kotlin

val videoOptions: VideoOptions.Builder()
  .setCustomControlsRequested(true)
  .build()

val adRequest = new NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  listOf(NativeAd.NativeAdType.NATIVE))
  .setVideoOptions(videoOptions)
  .build()

Java

VideoOptions VideoOptions = VideoOptions.Builder()
  .setCustomControlsRequested(true)
  .build()

NativeAdRequest adRequest = new NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  List.of(NativeAd.NativeAdType.NATIVE))
  .setVideoOptions(videoOptions)
  .build()

检查是否已启用自定义控件

由于在请求时无法知道返回的广告是否允许使用自定义视频控件，因此您必须检查它是否已启用自定义控件。

Kotlin

  val adCallback: NativeAdLoaderCallback =
    object : NativeAdLoaderCallback {
      override fun onNativeAdLoaded(nativeAd: NativeAd) {
        val mediaContent = nativeAd.mediaContent;
        if (mediaContent != null) {
          val videoController = mediaContent.videoController;
          val canShowCustomControls = videoController?.isCustomControlsEnabled();
        }
      }
    };

Java

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

呈现自定义视频控件

根据以下最佳实践呈现自定义视频控件：

将自定义控件视图作为原生广告视图的子视图呈现。采用这种做法后，开放式衡量可见度计算会将自定义控件视为友好遮挡。
避免在整个媒体视图上呈现不可见的叠加层。叠加层会遮挡媒体视图上的点击，从而对原生广告效果产生负面影响。请改为创建一个仅够容纳控件的小叠加层。

自定义点击手势

自定义点击手势是一项原生广告功能，可让广告视图上的滑动操作注册为广告点击。它旨在与通过滑动操作手势浏览内容的应用搭配使用。本指南介绍了如何在原生广告中启用自定义点击手势。

使用 NativeAd.SwipeGestureDirection 和 boolean 值调用 NativeAdRequest.Builder.enableCustomClickGestureDirection()。

以下示例实现了向右滑动的自定义手势，并保留了正常的标签页行为。

自定义点击手势默认处于停用状态。
停用后，您的应用将支持正常的点击行为。
启用后，您的应用将支持自定义滑动操作手势。

以下示例实现了向右滑动的自定义手势，并保留了正常的标签页行为。

Kotlin

val adOptions = NativeAdOptions
  .Builder()
  .enableCustomClickGestureDirection(
    /* swipeDirection */ 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.
val adRequest = NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  listOf(NativeAd.NativeAdType.NATIVE))
  .withNativeAdOptions(adOptions)
  .build();

Java

NativeAdOptions adOptions = new NativeAdOptions
  .Builder()
  .enableCustomClickGestureDirection(
    /* swipeDirection */ 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.
NativeAdRequest adRequest = new NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  List.of(NativeAd.NativeAdType.NATIVE))
  .withNativeAdOptions(adOptions)
  .build();

监听滑动手势事件

如需监听滑动手势事件，请使用 NativeAdEventCallback 调用 NativeAd.setAdEventCallback() 并实现 onAdSwipeGestureClicked() 方法。

Kotlin

  val adCallback: NativeAdLoaderCallback =
    object : NativeAdLoaderCallback {
      override fun onNativeAdLoaded(nativeAd: NativeAd) {
        // Implement the onAdSwipeGestureClicked() method.
        val nativeAdCallback: NativeAdEventCallback = object : NativeAdEventCallback {
          override fun onAdSwipeGestureClicked() {
            // A swipe gesture click has occurred.
          }
        }
      }
    }
  // Load the native ad with the ad request and callback.
  NativeAdLoader.load(adRequest, adCallback)

Java

  NativeAdLoaderCallback adCallback =
    new NativeAdLoaderCallback() {
      @Override
      public void onNativeAdLoaded(@NonNull NativeAd nativeAd) {
        // Implement the onAdSwipeGestureClicked() method.
        NativeAdEventCallback nativeAdCallback = new NativeAdEventCallback() {
          @Override
          public void onAdSwipeGestureClicked() {
            // A swipe gesture click has occurred.
          }
        };
      }
    };
  // Load the native ad with the ad request and callback.
  NativeAdLoader.load(adRequest, adCallback);

中介

自定义点击手势仅适用于 Google 移动广告 SDK 呈现的原生广告。需要使用第三方 SDK 进行呈现的广告来源不会响应自定义点击方向设置。

原生广告选项 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

前提条件

素材资源控件

首选媒体宽高比控件

Kotlin

Java

图片下载控件

Kotlin

Java

图片载荷控件

“广告选项”图标位置

“广告选项”位置控件

Kotlin

Java

“广告选项”自定义视图

Kotlin

Java

视频控件

开始播放时是否静音

Kotlin

Java

自定义播放控件

Kotlin

Java

检查是否已启用自定义控件

Kotlin

Java

呈现自定义视频控件

自定义点击手势

Kotlin

Java

监听滑动手势事件

Kotlin

Java

中介

原生广告选项