Share your feedback about the Google Mobile Ads SDK! Take the annual survey.

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()

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

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

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

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

setAdChoicesPlacement()

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

  • ADCHOICES_TOP_LEFT
  • ADCHOICES_TOP_RIGHT
  • ADCHOICES_BOTTOM_RIGHT
  • ADCHOICES_BOTTOM_LEFT
setVideoOptions()

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

setMediaAspectRatio()

此函数用于为原生广告设置要返回的图片或视频的宽高比。如果将 NativeMediaAspectRatio 设置为以下某一常量,则系统将仅返回以具有指定宽高比的媒体呈现的广告:

  • NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE
  • NATIVE_MEDIA_ASPECT_RATIO_PORTRAIT
  • NATIVE_MEDIA_ASPECT_RATIO_SQUARE
  • NATIVE_MEDIA_ASPECT_RATIO_ANY

如果未设置 NativeMediaAspectRatio,则系统将返回采用任意宽高比的广告。

发送以下问题的反馈:

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