Native Ads Options

原生广告让您可以使用 NativeAdOptions 对象进行其他自定义。本指南介绍了如何使用 NativeAdOptions

设置选项

withNativeAdOptions()
创建 AdLoader 的过程中,包含的最后一个函数是另一种可选方法 withNativeAdOptions()

Java

AdLoader adLoader = new AdLoader.Builder(context, "/6499/example/native")
    .forUnifiedNativeAd(new UnifiedNativeAd.OnUnifiedNativeAdLoadedListener() {
        @Override
        public void onUnifiedNativeAdLoaded(UnifiedNativeAd unifiedNativeAd) {
            // Show the ad.
        }
    })
    .withAdListener(new AdListener() {
        @Override
        public void onAdFailedToLoad(int errorCode) {
            // Handle the failure by logging, altering the UI, and so on.
        }
    })
    .withNativeAdOptions(new NativeAdOptions.Builder()
            // Methods in the NativeAdOptions.Builder class can be
            // used here to specify individual options settings.
            .build())
    .build();

Kotlin

val adLoader = AdLoader.Builder(this, "/6499/example/native")
    .forUnifiedNativeAd { ad : UnifiedNativeAd ->
        // Show the ad.
    }
    .withAdListener(object : AdListener() {
        override fun onAdFailedToLoad(errorCode: Int) {
            // Handle the failure by logging, altering the UI, and so on.
        }
    })
    .withNativeAdOptions(NativeAdOptions.Builder()
            // Methods in the NativeAdOptions.Builder class can be
            // used here to specify individual options settings.
            .build())
    .build()
The

通过 NativeAdOptions 对象,应用可以设置在发出请求时使用的具体选项,其中的 Builder 类提供了可在创建实例时使用的以下方法。

setReturnUrlsForImageAssets()
原生广告的图片素材资源是通过 NativeAd.Image 实例返回的,该类中包含一个 Drawable 和一个 Uri。如果此选项设置为 false(这是默认值),则 SDK 会自动获取图片素材资源,并为您填充 DrawableUri。不过,如果设置为 true,SDK 会仅填充 Uri 字段,从而允许您自行决定是否下载实际图片。
setImageOrientation()

某些广告素材有多张可用图片,分别适用于不同的设备屏幕方向。使用 NativeAdOptions 屏幕方向常量(ORIENTATION_PORTRAITORIENTATION_LANDSCAPEORIENTATION_ANY)之一调用此方法,可请求适用于特定屏幕方向的图片。如果未调用此方法,则会使用默认值 ORIENTATION_LANDSCAPE

setRequestMultipleImages()

某些图片素材资源包含的是一系列图片,而不只是一张图片。如果您的应用将此值设置为 true,则表示对于包含多张图片的任何素材资源,它都已准备好展示所有图片。如果您的应用将此值设置为 false(默认),则说明对于包含一系列图片的任何素材资源,它都指示 SDK 仅提供第一张图片。

如果在创建 AdLoader 时根本未调用 withNativeAdOptions,则会使用每个选项的默认值。

setAdChoicesPlacement()

默认情况下,广告选择叠加层会显示在右上角。应用可以通过将此属性设置为以下其中一项来更改此叠加层的呈现位置:

  • ADCHOICES_TOP_LEFT
  • ADCHOICES_TOP_RIGHT
  • ADCHOICES_BOTTOM_RIGHT
  • ADCHOICES_BOTTOM_LEFT
setVideoOptions()

应用可以使用此方法为作为原生广告一部分返回的视频素材资源设置选项。有关详情,请参阅《原生高级广告指南》的原生视频广告部分。

发送以下问题的反馈:

此网页
Mobile Ads SDK for Android
Mobile Ads SDK for Android
需要帮助?请访问我们的支持页面