原生广告具有许多高级功能，可让您进行更多自定义，并尽可能打造出色的广告体验。本指南将向您介绍如何使用原生广告的高级功能。
前提条件
- 集成原生广告格式。
素材资源控件
配置原生广告素材资源控件。
首选媒体宽高比控件
借助媒体宽高比控件，您可以指定广告素材的宽高比偏好设置。
使用 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()。
如果未设置，则“广告选项”图标位置会设置为右上角。
如果设置了此字段，AdChoices 会放置在所请求的自定义位置。
以下示例演示了如何设置自定义的“广告选项”图片位置。
Java
Kotlin
“广告选项”自定义视图
借助“广告选项”自定义视图功能，您可以将“广告选项”图标放置在自定义位置。这与 AdChoices 位置控制功能不同，后者仅允许指定四个角中的一个。
使用 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 进行呈现的广告来源不会响应自定义点击方向设置。