原生广告具有许多高级功能，可让您进行更多自定义，并尽可能打造出色的广告体验。本指南将向您介绍如何使用原生广告的高级功能。
前提条件
- 集成原生广告格式。
素材资源控件
本部分详细介绍了如何自定义原生广告中的广告素材资源。 您可以选择指定媒体素材资源的偏好宽高比，以及图片素材资源的下载和显示方式。
偏好的媒体宽高比控件
借助媒体宽高比控件，您可以指定广告素材的宽高比偏好设置。
使用 NativeAdOptions.MediaAspectRatio 值调用 NativeAdOptions.Builder.setMediaAspectRatio()。
如果未设置此控件，则返回的广告可以采用任意媒体宽高比。
如果设置了此控件，您将能够指定偏好的宽高比类型来改善用户体验。
以下示例指示 SDK 优先返回采用特定宽高比的图片或视频。
Java
Kotlin
将 AD_UNIT_ID 替换为您的广告单元 ID。
图片下载控件
借助图片下载控件，您可以决定 SDK 是返回图片素材资源还是仅返回 URI。
使用 boolean 值调用 NativeAdOptions.Builder.setReturnUrlsForImageAssets()。
图片下载控件默认处于停用状态。
停用后，Google 移动广告 SDK 会为您填充图片和 URI。
启用后，SDK 会仅填充 URI，从而允许您自行决定是否下载实际图片。
以下示例指示 SDK 仅返回 URI。
Java
Kotlin
图片载荷控件
有些广告包含一系列图片，而不只是一张图片。使用此功能可指明您的应用是已准备好显示所有图片还是仅显示一张图片。
使用 boolean 值调用 NativeAdOptions.Builder.setRequestMultipleImages()。
图片载荷控件默认处于停用状态。
停用后，您的应用会指示 SDK 在处理包含一系列图片的任何素材资源时，仅提供第一张图片。
启用后，您的应用即表示已准备好显示包含多张图片的任何素材资源中的所有图片。
以下示例指示 SDK 返回多个图片素材资源。
Java
Kotlin
“广告选项”图标位置
本部分详细介绍了如何定位 AdChoices 叠加层。您可以选择将其放置在四个角中的任意一个，也可以在自定义视图中呈现它。
“广告选项”位置控件
借助“广告选项”位置控件，您可以选择在哪个角落呈现“广告选项”图标。
使用 NativeAdOption.AdChoicesPlacement 值调用 NativeAdOptions.Builder.setAdChoicesPlacement()。
如果未设置此控件，“广告选项”图标位置会设为右上角。
如果设置了此控件，“广告选项”图标会放置在所请求的自定义位置。
以下示例演示了如何设置自定义“广告选项”图标位置。
Java
Kotlin
“广告选项”自定义视图
借助“广告选项”自定义视图功能，您可以将“广告选项”图标放置在自定义位置。这与“广告选项”位置控件不同，后者仅允许指定放置在界面的四个角之一。
使用 AdChoicesView 值调用 NativeAdView.setAdChoicesView()。
以下示例演示了如何设置自定义“广告选项”视图，其中“广告选项”图标呈现在 AdChoicesView 内。
Java
NativeAdView nativeAdView = new NativeAdView(context);
AdChoicesView adChoicesView = new AdChoicesView(context);
nativeAdView.setAdChoicesView(adChoicesView);
Kotlin
val nativeAdView = NativeAdView(context)
val adChoicesView = AdChoicesView(context)
nativeAdView.adChoicesView = adChoicesView
视频控件
本部分详细介绍了如何自定义视频广告的播放体验。您可以选择设置初始静音状态并实现自定义播放控件。
开始播放时是否静音
借助“开始播放时是否静音”选项，您可以禁止或允许在视频开始时播放音频。
使用 boolean 值调用 VideoOptions.Builder.setStartMuted()。
“开始播放时是否静音”选项默认处于启用状态。
停用后，您的应用会请求从视频开头播放音频。
启用后，您的应用会请求视频在开始播放时静音。
以下示例展示了如何在开始播放视频时，对音频取消静音。
Java
Kotlin
自定义播放控件
这样一来，您就可以请求自定义视频输入控件来对视频进行播放、暂停或静音操作。
使用 boolean 值调用 VideoOptions.Builder.setCustomControlsRequested()。
自定义播放控件默认处于停用状态。
停用后，您的视频将显示由 SDK 呈现的输入控件。
如果广告确实包含视频内容，并且已启用自定义控件，那么您应在展示广告的同时显示自定义控件，因为广告本身不会显示任何控件。然后，控件可以对以下对象调用相关方法：
以下示例展示了如何请求包含自定义播放控件的视频。
Java
Kotlin
检查是否已启用自定义控件
由于在请求时无法知道返回的广告是否允许使用自定义视频控件，因此您必须检查它是否已启用自定义控件。
Java
MediaContent mediaContent = nativeAd.getMediaContent();
if (mediaContent != null) {
VideoController videoController = mediaContent.getVideoController();
boolean canShowCustomControls = videoController.isCustomControlsEnabled();
}
Kotlin
val mediaContent = nativeAd.mediaContent
if (mediaContent != null) {
val videoController = mediaContent.videoController
val canShowCustomControls = videoController.isCustomControlsEnabled
}
呈现自定义视频控件
根据以下最佳实践呈现自定义视频控件：
- 将自定义控件视图作为原生广告视图的子视图呈现。采用这种做法后，开放式衡量可见度计算会将自定义控件视为友好遮挡。
- 避免在整个媒体视图上呈现不可见的叠加层。叠加层会遮挡媒体视图上的点击，从而对原生广告效果产生负面影响。请改为创建一个仅够容纳控件的小叠加层。
自定义点击手势
自定义点击手势是一项原生广告功能，可让广告视图上的滑动操作注册为广告点击。它旨在与通过滑动操作手势浏览内容的应用搭配使用。本指南介绍了如何在原生广告中启用自定义点击手势。
使用 NativeAdOptions.SwipeGestureDirection 和 boolean 调用 NativeAdOptions.Builder.enableCustomClickGestureDirection()，以指明是否允许将点按视为点击。
以下示例实现了向右滑动这一自定义手势，同时保留正常的点按行为。
自定义点击手势默认处于停用状态。
停用后，应用将支持正常的点击行为。
启用后，应用将支持自定义滑动操作。
以下示例实现了向右滑动这一自定义手势，同时保留正常的点按行为。
Java
Kotlin
监听滑动手势事件
当系统记录到滑动点击手势时，Google 移动广告 SDK 会对 AdListener 调用 onAdSwipeGestureClicked() 方法，同时也会调用现有的 onAdClicked() 方法。
Java
AdLoader adLoader =
new AdLoader.Builder(context, AD_UNIT_ID)
.withAdListener(
new AdListener() {
// Called when a swipe gesture click is recorded.
@Override
public void onAdSwipeGestureClicked() {
// Called when a swipe gesture click is recorded.
Log.d(TAG, "A swipe gesture click has occurred.");
}
@Override
public void onAdClicked() {
// Called when a swipe gesture click or a tap click is recorded, as
// configured in NativeAdOptions.
Log.d(TAG, "A swipe gesture click or a tap click has occurred.");
}
})
.build();
Kotlin
val adLoader =
AdLoader.Builder(context, AD_UNIT_ID)
.withAdListener(
object : AdListener() {
override fun onAdSwipeGestureClicked() {
// Called when a swipe gesture click is recorded.
Log.d(TAG, "A swipe gesture click has occurred.")
}
override fun onAdClicked() {
// Called when a swipe gesture click or a tap click is recorded, as
// configured in NativeAdOptions.
Log.d(TAG, "A swipe gesture click or a tap click has occurred.")
}
}
)
.build()
中介
自定义点击手势仅适用于 Google 移动广告 SDK 呈现的原生广告。需要使用第三方 SDK 进行呈现的广告来源不会响应自定义点击方向设置。