原生广告选项

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

GADNativeAdImageAdLoaderOptions 具有以下属性:

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

发送以下问题的反馈:

此网页
需要帮助?请访问我们的支持页面