原生广告选项

对于原生广告，您可以使用 NativeAdOptions 对象进一步自定义。本指南介绍了如何使用 NativeAdOptions。

设置选项

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

Java

    AdLoader adLoader = new AdLoader.Builder(context, "ca-app-pub-3940256099942544/2247696110")
        .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, "ca-app-pub-3940256099942544/2247696110")
        .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 会自动获取图片素材资源，并为您填充 Drawable 和 Uri。不过，如果设置为 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，则系统将返回采用任意宽高比的广告。