设置原生广告的高级功能

请选择平台： Android iOS Android（旧版）

原生广告有很多高级功能，让您可进行更多自定义，打造出尽可能出色的广告体验。本指南介绍了如何使用原生广告的高级功能。

前提条件

素材资源控件

本部分详细介绍了如何自定义原生广告中的广告素材资源。您可以选择指定偏好的媒体素材资源宽高比，以及图片素材资源的下载和显示方式。

首选媒体宽高比控件

借助媒体宽高比控件，您可以指定对广告素材宽高比的偏好。

使用 NativeAdOptions.MediaAspectRatio 值调用 NativeAdOptions.Builder.setMediaAspectRatio()。

  • 如果未设置此控件，则返回的广告可以采用任意媒体宽高比。

  • 如果设置了此控件，您将能够指定首选的宽高比类型来改善用户体验。

以下示例指示 SDK 优先返回特定宽高比的图片或视频。

Java

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder()
        .setMediaAspectRatio(NativeAdOptions.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
        .build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();

Kotlin

val nativeAdOptions =
  NativeAdOptions.Builder()
    .setMediaAspectRatio(NativeAdOptions.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
    .build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()

请将 AD_UNIT_ID 替换为您的广告单元 ID。

图片下载控件

借助图片下载控件，您可以决定 SDK 是返回图片素材资源还是仅返回 URI。

使用 boolean 值调用 NativeAdOptions.Builder.setReturnUrlsForImageAssets()。

  • 图片下载控件默认处于停用状态。

  • 停用后，Google Mobile Ads SDK (Legacy) 会为您填充图片和 URI。

  • 此控件处于启用状态时，SDK 则仅填充 URI，让您可自行决定是否下载实际图片。

以下示例指示 SDK 仅返回 URI。

Java

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder().setReturnUrlsForImageAssets(true).build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID")
        .withNativeAdOptions(nativeAdOptions)
        .forNativeAd(
            nativeAd -> {
              List<Uri> imageUris = new ArrayList<>();
              for (Image image : nativeAd.getImages()) {
                imageUris.add(image.getUri());
              }
            })
        .build();

Kotlin

val nativeAdOptions = NativeAdOptions.Builder().setReturnUrlsForImageAssets(true).build()

val loader =
  AdLoader.Builder(context, "AD_UNIT_ID")
    .withNativeAdOptions(nativeAdOptions)
    .forNativeAd { nativeAd ->
      val imageUris = nativeAd.images.mapNotNull { it.uri }
    }
    .build()

图片载荷控件

有些广告包含一系列图片，而不只是一张图片。使用此功能可指明您的应用是可以展示所有图片，还是只能展示一张图片。

使用 boolean 值调用 NativeAdOptions.Builder.setRequestMultipleImages()。

  • 图片载荷控件默认处于停用状态。

  • 此控件处于停用状态时，您的应用会指示 SDK，对于包含一系列图片的任何素材资源，仅提供第一张图片。

  • 此控件处于启用状态时，您的应用会指示其已做好准备，可为包含多张图片的任何素材资源展示所有图片。

以下示例指示 SDK 返回多个图片素材资源。

Java

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder().setRequestMultipleImages(true).build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();

Kotlin

val nativeAdOptions = NativeAdOptions.Builder().setRequestMultipleImages(true).build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()

“广告选项”图标位置

本部分详细介绍了如何确定“广告选项”叠加层的位置。您可以选择将其放置在四个角中的任意一个，也可以在自定义视图中呈现它。

“广告选项”位置控件

借助“广告选项”位置控件，您可以选择在哪个角落显示“广告选项”图标。

使用 NativeAdOption.AdChoicesPlacement 值调用 NativeAdOptions.Builder.setAdChoicesPlacement()。

  • 如果未设置此控件，“广告选项”图标位置会设置为右上角。

  • 如果设置了此控件，“广告选项”图标会放置在所请求的自定义位置。

以下示例演示了如何设置自定义“广告选项”图标位置。

Java

NativeAdOptions nativeAdOptions =
    new NativeAdOptions.Builder()
        .setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
        .build();

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();

Kotlin

val nativeAdOptions =
  NativeAdOptions.Builder()
    .setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
    .build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()