原生广告选项

创建 GADAdLoader 时包含的最后一个参数是一个可选的对象数组。本部分将介绍这些选项。

Swift

adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ ... ad type constants ... ],
    options: [ ... ad loader options objects ... ])

Objective-C

self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:rootViewController
               adTypes:@[ ... ad type constants ... ]
               options:@[ ... ad loader options objects ... ]];

GADNativeAdImageAdLoaderOptions

GADNativeAdImageAdLoaderOptions 包含与原生广告中的图片相关的属性。通过创建 GADNativeAdImageAdLoaderOptions 对象，设置其属性（disableImageLoading、preferredImageOrientation 和 shouldRequestMultipleImages），并在初始化期间传入该对象，应用可以控制 GADAdLoader 处理图片资源的方式。

GADNativeAdImageAdLoaderOptions 具有以下属性：

disableImageLoading
原生广告的图片素材资源通过 GADNativeAdImage 的实例返回，其中包含 image 和 imageURL 属性。如果 disableImageLoading 设置为默认值 false（Objective-C 中的 NO），SDK 将自动提取图片资源，并为您填充 image 和 imageURL 属性。如果设为 true（在 Objective-C 中为 YES），SDK 将仅填充 imageURL，从而允许您自行决定下载实际图片。手动下载图片时，请使用 GADMediaContent 的 mainImage 属性为媒体视图设置图片。
preferredImageOrientation

某些广告素材有多张图片，分别适用于不同的设备屏幕方向。应用可以通过将此属性设置为某个方向常量来请求特定方向的图片：

  • GADNativeAdImageAdLoaderOptionsOrientationAny
  • GADNativeAdImageAdLoaderOptionsOrientationLandscape

  • GADNativeAdImageAdLoaderOptionsOrientationPortrait

    如果您使用 preferredImageOrientation 指定首选横向或纵向图片，SDK 会首先在图片素材资源数组中放置与该方向匹配的图片，然后将不匹配的图片放在它们后面。由于某些广告只能有一个方向，因此发布商应确保其应用可同时处理横向和纵向图片。

    如果未调用此方法，系统将使用默认值 GADNativeAdImageAdLoaderOptionsOrientationAny。

shouldRequestMultipleImages

某些图片素材资源会包含一系列图片，而不只是一张图片。通过将此值设置为 true，您的应用会表明它已准备好显示任何具有多个图片的资源。通过将其设置为 false（默认值），您的应用会指示 SDK 为包含一系列图片的任何素材资源仅提供第一张图片。

如果在初始化 GADAdLoader 时未传入任何 GADAdLoaderOptions 对象，则将使用每个选项的默认值。

GADNativeAdViewAdOptions 中的字段

GADNativeAdViewAdOptions 对象用于表示关于原生广告视图应如何表示广告的偏好设置。这些对象具有单一的 preferredAdChoicesPosition 属性，您可以使用该属性指定“广告选择”图标应放置的位置。该图标可以显示在广告的任一角，默认为 GADAdChoicesPositionTopRightCorner。此属性可能的值包括：

  • GADAdChoicesPositionTopRightCorner
  • GADAdChoicesPositionTopLeftCorner
  • GADAdChoicesPositionBottomRightCorner
  • GADAdChoicesPositionBottomLeftCorner

以下示例展示了如何将“广告选择”图标放置在广告左上角：

Swift

let adViewOptions = GADNativeAdViewAdOptions()
adViewOptions.preferredAdChoicesPosition = .topLeftCorner
adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ ... ad type constants ... ],
    options: [ ... ad loader options objects ... ])

Objective-C

GADNativeAdViewAdOptions *adViewOptions = [[GADNativeAdViewAdOptions alloc] init];
adViewOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopLeftCorner;
self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:self
               adTypes:@[ ... ad type constants ...  ]
               options:@[ ... ad loader options objects ... ]];

GADVideoOptions

GADVideoOptions 对象用于指示应如何展示原生视频素材资源。

startMuted 布尔值指示视频资源是否应在静音状态下开始播放。默认值为 true。

Swift

let videoOptions = GADVideoOptions()
// Ads start muted by default. Set to false to start video ads with sound.
videoOptions.startMuted = false
adLoader = GADAdLoader(
    adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ ... ad type constants ... ],
    options: [videoOptions])

Objective-C

GADVideoOptions *videoOptions = [[GADVideoOptions alloc] init];
// Ads start muted by default. Set to NO to start video ads with sound.
videoOptions.startMuted = NO;
self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:self
               adTypes:@[ ... ad type constants ... ]
               options:@[videoOptions]];

GADMultipleAdsAdLoaderOptions 中的字段

借助 GADMultipleAdsAdLoaderOptions 对象，发布商可以指示广告加载程序通过一次请求加载多个广告。以这种方式加载的广告必须具有唯一性。GADMultipleAdsAdLoaderOptions 有一个属性 numberOfAds，该属性表示广告加载程序应尝试为请求返回的广告数量。默认情况下，此值为 1，且上限为 5 次（即使应用请求了更多广告，最多也只会返回 5 次）。无法保证返回的实际广告数量，但会在零到 numberOfAds 之间。

GADNativeAdMediaAdLoaderOptions

如需使用此功能，请在 GADAdLoader 初始化中的原生广告选项数组中包含 GADNativeAdMediaAdLoaderOptions 类。

GADNativeAdMediaAdLoaderOptions 对象允许您选择媒体宽高比偏好设置。此选项会同时应用于图片和视频。此类有一个属性：mediaAspectRatio，您可以使用该属性指定支持的媒体宽高比。此属性可能的值包括：

Objective-CSwift
GADMediaAspectRatioAny .any
GADMediaAspectRatioLandscape .landscape
GADMediaAspectRatioPortrait .portrait
GADMediaAspectRatioSquare .square

如果将 mediaAspectRatio 设置为其中一个选项，则系统仅会返回采用指定宽高比的媒体的广告。如果未明确设置此属性，则该值将默认为 GADMediaAspectRatioUnknown，并且系统不会对宽高比应用任何限制。