原生广告选项

原生广告具有许多高级功能,可让您进行额外的自定义,从而打造尽可能出色的广告体验。本指南介绍了 如何使用原生广告的高级功能

前提条件

素材资源控件

首选媒体宽高比控件

通过媒体宽高比控件,您可以指定 广告素材。

调用 NativeAdOptions.Builder.setMediaAspectRatio() (带有 NativeAdOptions.MediaAspectRatio) 值。

  • 如果未设置,则返回的广告可以采用任何媒体宽高比。

  • 设置后,您可以通过指定 首选宽高比类型

以下示例指示 SDK 优先选择带有 特定宽高比。

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

AdLoader loader = new AdLoader.Builder(this, '/21775744923/example/native')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

图片下载控件

借助图片下载控件,您可以决定是下载图片素材资源还是仅使用 URI 返回的值。

调用 NativeAdOptions.Builder.setReturnUrlsForImageAssets() 并设置为 boolean 值。
  • 默认情况下,图片下载控件处于停用状态。

  • 停用后,Google 移动广告 SDK 会为您填充图片和 URI。

  • 启用后,SDK 将改为仅填充 URI,让您可以下载 您可以自行决定是否调整实际图片

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

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

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

映像载荷控件

有些广告会有一系列图片,而不只是一张图片。使用此功能可实现以下目的: 指示您的应用是准备好显示所有图片还是仅显示一张图片。

调用 NativeAdOptions.Builder.setRequestMultipleImages() 并设置为 boolean 值。
  • 默认情况下,图片载荷控件处于停用状态。

  • 停用后,您的应用会指示 SDK 仅提供 第一张图片。

  • 启用后,您的应用会指明它已做好准备,可以为任何包含多张图片的素材资源展示所有图片。

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

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

AdLoader loader = new AdLoader.Builder(this, '/21775744923/example/native')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

“广告选项”展示位置

“广告选项”位置控件

通过“广告选项”位置控件,您可以选择在哪个角呈现 “广告选择”图标。

调用 NativeAdOptions.Builder.setAdChoicesPlacement() (带有 NativeAdOption.AdChoicesPlacement) 值。

  • 如果未设置,“广告选项”图标的位置会设为右上角。

  • 如果已设置,则会按照请求将“广告选项”放置在自定义位置。

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

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

AdLoader loader = new AdLoader.Builder(this, '/21775744923/example/native')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

“广告选择”自定义视图

通过“广告选择”的自定义视图功能,您可以将“广告选择”图标放置在 自定义位置。这与“广告选择”位置控件不同 用于指定四个角中的其中一个。

使用 AdChoicesView 值调用 NativeAdView.setAdChoicesView()

以下示例演示了如何设置自定义 AdChoices 视图,并在 AdChoicesView 中呈现 AdChoices 图标。


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

视频控件

启动静音行为

借助“开始静音”行为,您可以停用或启用视频的开始音频。

使用 boolean 值调用 VideoOptions.Builder.setStartMuted()
  • 默认情况下,静音启动行为处于启用状态。

  • 停用此功能后,您的应用请求的视频应以 音频。

  • 启用后,您的应用会请求视频开始时应设为静音。

以下示例展示了如何在取消静音的情况下开始播放视频。

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

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

AdLoader loader = new AdLoader.Builder(this, '/21775744923/example/native')
                              .withNativeAdOptions(adOptions).build();

自定义播放控件

这样,您就可以请求自定义视频输入控件,以播放、暂停或静音 视频。

调用 VideoOptions.Builder.setCustomControlsRequested() 并设置为 boolean 值。
  • 自定义播放控件默认处于停用状态。

  • 停用后,您的视频将显示 SDK 呈现的输入控件。

  • 如果广告有视频内容并且启用了自定义控件, 与广告一起显示您的自定义控件 控制其自身。然后控件可以调用 VideoController

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

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

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

AdLoader loader = new AdLoader.Builder(this, '/21775744923/example/native')
                              .withNativeAdOptions(adOptions).build();

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

由于在请求时并不知道返回的广告是否允许 自定义视频控件,您必须检查它是否已启用自定义控件。

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

自定义点击手势

自定义点击手势是一项原生广告功能,可让您在广告视图上滑动手指, 被记录为广告点击它适用于使用滑动手势的应用 用于内容导航的手势。本指南介绍了如何启用自定义点击 手势。

调用 NativeAdOptions.Builder.enableCustomClickGestureDirection() (带有 NativeAdOptions.SwipeGestureDirection) 以及 boolean,用于指明是否允许将点按操作计为点击次数。

  • 默认情况下,自定义点击手势处于停用状态。

  • 停用后,您的应用将支持正常的点击行为。

  • 启用后,您的应用将支持自定义滑动手势。

以下示例实现了向右并 保持正常的标签页行为。

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, '/21775744923/example/native')
    .withNativeAdOptions(adOptions);

监听滑动手势事件

记录了滑动手势点击时,Google 移动广告 SDK 会调用 onAdSwipeGestureClicked() 方法,以及现有的AdListener 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();

中介

自定义点击手势仅适用于 Google 移动 。未搜索到 需要第三方 SDK 不响应自定义点击路线设置。