原生广告具有许多高级功能,可让您进行进一步的个性化设置,从而打造尽可能出色的广告体验。本指南介绍了如何使用原生广告的高级功能。
前提条件
- 集成原生广告格式。
素材资源控件
首选媒体宽高比控件
通过媒体宽高比控件,您可以指定 广告素材。
使用 NativeAdOptions.MediaAspectRatio
值调用 NativeAdOptions.Builder.setMediaAspectRatio()
。
如果未设置,返回的广告可以采用任何媒体宽高比。
设置后,您可以通过指定首选宽高比类型来改善用户体验。
以下示例指示 SDK 优先选择带有 特定宽高比。
NativeAdOptions nativeAdOptions = new NativeAdOptions.Builder()
.setMediaAspectRatio(NativeAdOptions.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
.build();
AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
.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, 'ca-app-pub-3940256099942544/2247696110')
.withNativeAdOptions(nativeAdOptions)
.forNativeAd(nativeAd -> {
List<Uri> imageUris = new ArrayList<>();
for (Image image : nativeAd.getImages()) {
imageUris.add(image.getUri());
}
})
.build();
图片载荷控件
某些广告包含的是一系列图片,而不只是一张图片。使用此功能可实现以下目的: 指示您的应用是准备好显示所有图片还是仅显示一张图片。
使用boolean
值调用 NativeAdOptions.Builder.setRequestMultipleImages()
。
图片载荷控件默认处于停用状态。
停用后,您的应用会指示 SDK 仅为包含一系列图片的任何素材资源提供第一张图片。
启用后,您的应用会表明已准备好展示所有图片 。
以下示例会指示 SDK 返回多个图片素材资源。
NativeAdOptions nativeAdOptions = new NativeAdOptions.Builder()
.setRequestMultipleImages(true)
.build();
AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
.withNativeAdOptions(nativeAdOptions)
.build();
“广告选项”展示位置
“广告选项”位置控件
借助“广告选择”位置控件,您可以选择在哪个角落呈现“广告选择”图标。
调用 NativeAdOptions.Builder.setAdChoicesPlacement()
(带有 NativeAdOption.AdChoicesPlacement
)
值。
如果未设置,则“广告选择”图标位置会设为右上角。
如果设置了此属性,AdChoices 会根据请求放置在自定义位置。
以下示例演示了如何设置自定义“广告选择”图片位置。
NativeAdOptions nativeAdOptions = new NativeAdOptions.Builder()
.setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
.build();
AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
.withNativeAdOptions(nativeAdOptions)
.build();
AdChoices 自定义视图
<ph type="x-smartling-placeholder">
借助“广告选择”自定义视图功能,您可以将“广告选择”图标放置在自定义位置。这与“广告选择”位置控件不同 用于指定四个角中的其中一个。
使用AdChoicesView
值调用 NativeAdView.setAdChoicesView()
。
以下示例演示了如何设置自定义 AdChoices 视图,并在 AdChoicesView
中呈现 AdChoices 图标。
public void onNativeAdLoaded(NativeAd ad) {
NativeAdView nativeAdView = new NativeAdView(getApplicationContext());
AdChoicesView adChoicesView = new AdChoicesView(this);
nativeAdView.setAdChoicesView(adChoicesView);
}
视频控件
开始静音行为
通过静音开始播放行为,您可以停用或启用视频的起始音频。
调用VideoOptions.Builder.setStartMuted()
并设置为 boolean
值。
默认情况下,静音启动行为处于启用状态。
停用此功能后,您的应用请求的视频应以 音频。
启用后,您的应用会请求视频开始时应设为静音。
以下示例展示了如何在取消静音的情况下开始播放视频。
VideoOptions videoOptions = new VideoOptions.Builder()
.setStartMuted(false)
.build();
NativeAdOptions adOptions = new NativeAdOptions.Builder()
.setVideoOptions(videoOptions)
.build();
AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
.withNativeAdOptions(adOptions).build();
自定义播放控件
这样,您就可以请求自定义视频输入控件来播放、暂停或静音视频。
使用boolean
值调用 VideoOptions.Builder.setCustomControlsRequested()
。
自定义播放控件默认处于停用状态。
停用后,您的视频将显示 SDK 呈现的输入控件。
- 如果广告有视频内容并且启用了自定义控件,
与广告一起显示您的自定义控件
控制其自身。然后控件可以调用
VideoController
。
以下示例展示了如何请求具有自定义播放控件的视频。
VideoOptions videoOptions = new VideoOptions.Builder()
.setCustomControlsRequested(true)
.build();
NativeAdOptions adOptions = new NativeAdOptions.Builder()
.setVideoOptions(videoOptions)
.build();
AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
.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.SwipeGestureDirection
和 boolean
调用 NativeAdOptions.Builder.enableCustomClickGestureDirection()
,以指明是否允许将点按视为点击。
默认情况下,自定义点击手势处于停用状态。
停用后,您的应用将支持正常的点击行为。
启用后,您的应用将支持自定义滑动手势。
以下示例实现了向右并 保持正常的标签页行为。
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, 'ca-app-pub-3940256099942544/2247696110')
.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 不响应自定义点击路线设置。