原生广告选项

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 对象、设置其属性(disableImageLoadingpreferredImageOrientationshouldRequestMultipleImages)并在初始化期间传递此对象,应用可以控制 GADAdLoader 处理原生高级广告图片素材资源的方式。

GADNativeAdImageAdLoaderOptions 具有以下属性:

disableImageLoading
原生广告的图片素材资源是通过包含 imageimageURL 属性的 GADNativeAdImage 实例返回的。如果 disableImageLoading 设置为 false(这是默认值,在 Objective-C 中为 NO),则 SDK 会自动获取图片素材资源,并为您填充 imageimageURL 属性。不过,如果设置为 true(在 Objective-C 中为 YES),SDK 将只填充 imageURL,从而允许您自行决定是否下载实际图片。使用 GADMediaContentmainImage 属性,在手动下载图片时为媒体视图设置图片。
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

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,并且系统不会对宽高比应用任何限制。