原生广告有很多高级功能，让您可进行更多自定义，打造出尽可能出色的广告体验。本指南介绍了如何使用原生广告的高级功能。
前提条件
- 集成原生广告格式。
素材资源控件
配置原生广告素材资源控件。
首选媒体宽高比控件
借助媒体宽高比控件，您可以指定广告素材的宽高比偏好设置。
使用 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
“广告选项”图标位置
自定义“广告选项”图标的显示方式。
“广告选项”位置控件
借助“广告选项”位置控件，您可以选择在哪个角落显示“广告选项”图标。
使用 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 进行呈现的广告来源不会响应自定义点击方向设置。