如需讨论我们的产品并提供反馈，请加入 Google 广告和效果衡量社区服务器中的官方 Ad Manager Discord 频道。

原生广告选项

请选择平台： Android iOS

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

前提条件

集成原生广告格式。

素材资源控件

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

首选媒体宽高比控件

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

使用 GADMediaAspectRatio 设置 GADNativeAdMediaAdLoaderOptions mediaAspectRatio。

如果未设置此控件，则返回的广告可以采用任意媒体宽高比。
如果设置了此控件，您将能够指定首选的宽高比类型来改善用户体验。

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

Swift

let nativeOptions = NativeAdMediaAdLoaderOptions()
nativeOptions.mediaAspectRatio = .any

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdMediaAdLoaderOptions *nativeOptions = [[GADNativeAdMediaAdLoaderOptions alloc] init];
nativeOptions.mediaAspectRatio = GADMediaAspectRatioAny;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];NativeAdOptionsSnippets.m

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

图片下载控件

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

使用 BOOL 值设置 GADNativeAdImageAdLoaderOptions disableImageLoading。

图片下载控件默认处于停用状态。
该控件处于停用状态时，Google 移动广告 SDK 会为您填充图片和 URI。
该控件处于启用状态时，SDK 将仅填充 URI，以便您可自行决定是否下载实际图片。

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

Swift

let nativeOptions = NativeAdImageAdLoaderOptions()
nativeOptions.isImageLoadingDisabled = true

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdImageAdLoaderOptions *nativeOptions = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOptions.disableImageLoading = YES;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];NativeAdOptionsSnippets.m

图片载荷控件

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

图片载荷控件默认处于停用状态。
停用后，您的应用会指示 SDK，对于包含一系列图片的任何素材资源，仅提供第一张图片。
启用后，您的应用会指示它已做好准备，可为包含多张图片的任何素材资源展示所有图片。

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

Swift

let nativeOptions = NativeAdImageAdLoaderOptions()
nativeOptions.shouldRequestMultipleImages = true

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdImageAdLoaderOptions *nativeOptions = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOptions.shouldRequestMultipleImages = YES;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];NativeAdOptionsSnippets.m

“广告选项”图标位置

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

“广告选项”位置控件

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

使用 GADAdChoicesPosition 值设置 GADNativeAdViewAdOptions preferredAdChoicesPosition。

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

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

Swift

let nativeOptions = NativeAdViewAdOptions()
nativeOptions.preferredAdChoicesPosition = .topRightCorner

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [nativeOptions])NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdViewAdOptions *nativeOptions = [[GADNativeAdViewAdOptions alloc] init];
nativeOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopRightCorner;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ nativeOptions ]];NativeAdOptionsSnippets.m

“广告选项”自定义视图

借助“广告选项”自定义视图功能，您可以将“广告选项”图标放置在自定义位置。这与“广告选项”位置控件不同，后者仅允许指定放置在四个角中的某一角。

在呈现之前使用 GADAdChoicesView 设置 GADNativeAd.adChoicesView 属性，这样“广告选项”内容将呈现在 GADAdChoicesView 中。

以下示例演示了如何设置自定义“广告选项”视图。“广告选项”图标呈现在 GADAdChoicesView 中：

Swift

private func createAdChoicesView(nativeAdView: NativeAdView) {
  // Define a custom position for the AdChoices icon.
  let customRect = CGRect(x: 100, y: 100, width: 15, height: 15)
  let customAdChoicesView = AdChoicesView(frame: customRect)
  nativeAdView.addSubview(customAdChoicesView)
  nativeAdView.adChoicesView = customAdChoicesView
}NativeAdOptionsSnippets.swift

Objective-C

- (void)createAdChoicesViewWithNativeAdView:(GADNativeAdView *)nativeAdView {
  // Define a custom position for the AdChoices icon.
  CGRect customRect = CGRectMake(100, 100, 15, 15);
  GADAdChoicesView *customAdChoicesView = [[GADAdChoicesView alloc] initWithFrame:customRect];
  [nativeAdView addSubview:customAdChoicesView];
  nativeAdView.adChoicesView = customAdChoicesView;
}NativeAdOptionsSnippets.m

视频广告控件

本部分详细介绍了如何自定义视频广告的播放体验。您可以选择设置初始静音状态并实现自定义播放控件。

开始播放时是否静音

借助“开始播放时是否静音”选项，您可以禁止或允许在视频开始时播放音频。

使用 BOOL 值设置 GADVideoOptions startMuted。

“开始播放时是否静音”选项默认处于启用状态。
停用后，您的应用会请求在开始播放视频时也播放音频。
启用后，您的应用会请求视频在开始播放时静音。

以下示例展示了如何以非静音方式开始播放视频。

Swift

let videoOptions = VideoOptions()
videoOptions.shouldStartMuted = false

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [videoOptions])NativeAdOptionsSnippets.swift

Objective-C

GADVideoOptions *videoOptions = [[GADVideoOptions alloc] init];
videoOptions.startMuted = NO;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ videoOptions ]];NativeAdOptionsSnippets.m

自定义播放控件

这样一来，您就可以请求自定义视频输入控件来对视频进行播放、暂停或静音操作。

使用 BOOL 值设置 GADVideoOptions customControlsRequested。

自定义播放控件默认处于停用状态。
停用后，您的视频将显示由 SDK 呈现的输入控件。

启用后，您可以使用 GADVideoController play、GADVideoController pause 和 GADVideoController setMute 控制视频广告。

如果广告确实包含视频内容，并且已启用自定义控件，那么您应在展示广告的同时显示自定义控件，因为广告本身不会显示任何控件。然后，控件可以对以下对象调用相关方法：

GADVideoController。

以下示例展示了如何请求加载包含自定义播放控件的视频。

Swift

let videoOptions = VideoOptions()
videoOptions.areCustomControlsRequested = true

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [videoOptions])NativeAdOptionsSnippets.swift

Objective-C

GADVideoOptions *videoOptions = [[GADVideoOptions alloc] init];
videoOptions.customControlsRequested = YES;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ videoOptions ]];NativeAdOptionsSnippets.m

检查是否已启用自定义控件

由于在请求时无法知道返回的广告是否允许使用自定义视频控件，因此您必须检查它是否已启用自定义控件。

Swift

private func checkCustomControlsEnabled(nativeAd: NativeAd) -> Bool {
  let videoController = nativeAd.mediaContent.videoController
  return videoController.areCustomControlsEnabled
}NativeAdOptionsSnippets.swift

Objective-C

- (BOOL)checkCustomControlsEnabledWithNativeAd:(GADNativeAd *)nativeAd {
  GADVideoController *videoController = nativeAd.mediaContent.videoController;
  return videoController.customControlsEnabled;
}NativeAdOptionsSnippets.m

呈现自定义视频控件

根据以下最佳做法呈现自定义视频控件：

将自定义控件视图作为原生广告视图的子视图呈现。采用这种做法后，开放式衡量可见度计算会将自定义控件视为友好遮挡。
避免在整个媒体视图上呈现不可见的叠加层。叠加层会遮挡媒体视图上的点击，从而对原生广告效果产生负面影响。请改为创建一个仅够容纳控件的小叠加层。

自定义点击手势

自定义点击手势是一项原生广告功能，可让广告视图上的滑动操作注册为广告点击。它旨在与通过滑动操作手势浏览内容的应用搭配使用。本指南介绍了如何在原生广告中启用自定义点击手势。

使用所选的滑动方向初始化 GADNativeAdCustomClickGestureOptions 实例。您还需要指明是否允许将点按视为点击。

自定义点击手势默认处于停用状态。
停用后，仅将点按操作计为点击。
启用后，滑动手势将被计为点击，您可以指定点按操作是否仍可计为点击。

以下示例展示了如何实现向右滑动这一自定义手势，同时保留正常的点按行为。

Swift

let swipeGestureOptions = NativeAdCustomClickGestureOptions(
  swipeGestureDirection: .right,
  tapsAllowed: true)

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  rootViewController: self,
  adTypes: [.native],
  options: [swipeGestureOptions])NativeAdOptionsSnippets.swift

Objective-C

GADNativeAdCustomClickGestureOptions *swipeGestureOptions =
    [[GADNativeAdCustomClickGestureOptions alloc]
        initWithSwipeGestureDirection:UISwipeGestureRecognizerDirectionRight
                          tapsAllowed:YES];

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"nativeAdUnitID"
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ swipeGestureOptions ]];NativeAdOptionsSnippets.m

监听滑动手势事件

当系统记录到滑动点击手势时，Google 移动广告 SDK 会对 GADNativeAdDelegate 调用 nativeAdDidRecordSwipeGestureClick: 委托方法，同时也会调用现有的 nativeAdDidRecordClick: 委托方法。

Swift

// Called when a swipe gesture click is recorded, as configured in
// NativeAdCustomClickGestureOptions.
func nativeAdDidRecordSwipeGestureClick(_ nativeAd: NativeAd) {
  print("A swipe gesture click has occurred.")
}

// Called when a swipe gesture click or a tap click is recorded.
func nativeAdDidRecordClick(_ nativeAd: NativeAd) {
  print("A swipe gesture click or tap click has occurred.")
}NativeAdOptionsSnippets.swift

Objective-C

// Called when a swipe gesture click is recorded, as configured in
// GADNativeAdCustomClickGestureOptions.
- (void)nativeAdDidRecordSwipeGestureClick:(GADNativeAd *)nativeAd {
  NSLog(@"A swipe gesture click has occurred.");
}

// Called when a swipe gesture click or a tap click is recorded.
- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
  NSLog(@"A swipe gesture click or tap click has occurred.");
}NativeAdOptionsSnippets.m

中介

自定义点击手势仅适用于 Google 移动广告 SDK 呈现的原生广告。需要使用第三方 SDK 进行呈现的广告来源不会响应自定义点击方向设置。

原生广告选项 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

前提条件

素材资源控件

首选媒体宽高比控件

Swift

Objective-C

图片下载控件

Swift

Objective-C

图片载荷控件

Swift

Objective-C

“广告选项”图标位置

“广告选项”位置控件

Swift

Objective-C

“广告选项”自定义视图

Swift

Objective-C

视频广告控件

开始播放时是否静音

Swift

Objective-C

自定义播放控件

Swift

Objective-C

检查是否已启用自定义控件

Swift

Objective-C

呈现自定义视频控件

自定义点击手势

Swift

Objective-C

监听滑动手势事件

Swift

Objective-C

中介

原生广告选项