此页面由 Cloud Translation API 翻译。

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

横幅广告是占据应用部分布局的矩形广告。当用户与应用互动时，横幅广告会停留在屏幕上（锚定在屏幕顶部或底部），或在用户滚动时内嵌于内容中。横幅广告可在一段时间后自动刷新。如需了解详情，请参阅横幅广告概览。

本指南介绍了如何开始使用锚定型自适应横幅广告。这种广告会使用您指定的广告宽度针对每台设备优化广告尺寸，从而最大限度地提升广告效果。

锚定自适应横幅广告

锚定型自适应横幅广告是固定宽高比广告，而非常规的固定尺寸广告。宽高比与 320x50 行业标准相似。您指定可用的完整宽度后，系统会返回与该宽度相匹配的最佳高度的广告。来自同一设备的请求中的最佳高度不会发生变化，并且在广告刷新时，周围的视图无需移动。

前提条件

完成入门指南。

务必用测试广告进行测试

在构建和测试应用时，请确保使用的是测试广告，而不是实际投放的广告。否则，可能会导致您的账号被中止。

对于 iOS 横幅广告，加载测试广告最简便的方法就是使用下面的专用测试广告单元 ID：

ca-app-pub-3940256099942544/2435281174

该测试广告单元 ID 已经过专门配置，可确保每个请求返回的都是测试广告。您可以在自己应用的编码、测试和调试过程中随意使用该测试广告单元 ID。只需确保您会在发布应用前用自己的广告单元 ID 替换该测试广告单元 ID 即可。

如需详细了解移动广告 SDK 的测试广告如何运作，请参阅测试广告。

创建 GADBannerView

横幅广告在 GADBannerView 对象中展示，因此植入横幅广告的第一步是将 GADBannerView 添加到视图层次结构中。这通常可以通过编程方式或通过 Interface Builder 完成。

以程序化方式

您还可以直接将 GADBannerView 实例化。以下示例会创建一个 GADBannerView：

Swift

import GoogleMobileAds
import UIKit

class ViewController: UIViewController {

  var bannerView: BannerView!

  override func viewDidLoad() {
    super.viewDidLoad()

    let viewWidth = view.frame.inset(by: view.safeAreaInsets).width

    // Here the current interface orientation is used. Use
    // landscapeAnchoredAdaptiveBanner or
    // portraitAnchoredAdaptiveBanner if you prefer to load an ad of a
    // particular orientation,
    let adaptiveSize = currentOrientationAnchoredAdaptiveBanner(width: viewWidth)
    bannerView = BannerView(adSize: adaptiveSize)

    addBannerViewToView(bannerView)
  }

  func addBannerViewToView(_ bannerView: BannerView) {
    bannerView.translatesAutoresizingMaskIntoConstraints = false
    view.addSubview(bannerView)
    // This example doesn't give width or height constraints, as the provided
    // ad size gives the banner an intrinsic content size to size the view.
    view.addConstraints(
      [NSLayoutConstraint(item: bannerView,
                          attribute: .bottom,
                          relatedBy: .equal,
                          toItem: view.safeAreaLayoutGuide,
                          attribute: .bottom,
                          multiplier: 1,
                          constant: 0),
      NSLayoutConstraint(item: bannerView,
                          attribute: .centerX,
                          relatedBy: .equal,
                          toItem: view,
                          attribute: .centerX,
                          multiplier: 1,
                          constant: 0)
      ])
  }
}

SwiftUI

如需使用 BannerView，请创建 UIViewRepresentable：

private struct BannerViewContainer: UIViewRepresentable {
  let adSize: AdSize

  init(_ adSize: AdSize) {
    self.adSize = adSize
  }

  func makeUIView(context: Context) -> UIView {
    // Wrap the GADBannerView in a UIView. GADBannerView automatically reloads a new ad when its
    // frame size changes; wrapping in a UIView container insulates the GADBannerView from size
    // changes that impact the view returned from makeUIView.
    let view = UIView()
    view.addSubview(context.coordinator.bannerView)
    return view
  }

  func updateUIView(_ uiView: UIView, context: Context) {
    context.coordinator.bannerView.adSize = adSize
  }

  func makeCoordinator() -> BannerCoordinator {
    return BannerCoordinator(self)
  }BannerContentView.swift

如需管理 BannerView 的初始化和行为，请创建 Coordinator：

class BannerCoordinator: NSObject, BannerViewDelegate {

  private(set) lazy var bannerView: BannerView = {
    let banner = BannerView(adSize: parent.adSize)
    banner.adUnitID = "ca-app-pub-3940256099942544/2435281174"
    banner.load(Request())
    banner.delegate = self
    return banner
  }()

  let parent: BannerViewContainer

  init(_ parent: BannerViewContainer) {
    self.parent = parent
  }BannerContentView.swift

如需获取视图的宽度，请使用 GeometryReader。此类会根据当前设备屏幕方向计算适当的广告尺寸。frame 设置为根据广告尺寸计算出的高度。

var body: some View {
  GeometryReader { geometry in
    let adSize = currentOrientationAnchoredAdaptiveBanner(width: geometry.size.width)

    VStack {
      Spacer()
      BannerViewContainer(adSize)
        .frame(height: adSize.size.height)
    }
  }BannerContentView.swift

Objective-C

请注意，在本例中，我们没有给出宽度或高度限制，因为提供的广告尺寸会为横幅广告提供固有内容尺寸，用来调整视图大小。

@import GoogleMobileAds;

@interface ViewController ()

@property(nonatomic, strong) GADBannerView *bannerView;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];

  // Here safe area is taken into account, hence the view frame is used after the
  // view has been laid out.
  CGRect frame = UIEdgeInsetsInsetRect(self.view.frame, self.view.safeAreaInsets);
  CGFloat viewWidth = frame.size.width;

  // Here the current interface orientation is used. If the ad is being preloaded
  // for a future orientation change or different orientation, the function for the
  // relevant orientation should be used.
  GADAdSize adaptiveSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth);
  // In this case, we instantiate the banner with desired ad size.
  self.bannerView = [[GADBannerView alloc] initWithAdSize:adaptiveSize];

  [self addBannerViewToView:self.bannerView];
}

- (void)addBannerViewToView:(UIView *)bannerView {
  bannerView.translatesAutoresizingMaskIntoConstraints = NO;
  [self.view addSubview:bannerView];
  // This example doesn't give width or height constraints, as the provided
  // ad size gives the banner an intrinsic content size to size the view.
  [self.view addConstraints:@[
    [NSLayoutConstraint constraintWithItem:bannerView
                              attribute:NSLayoutAttributeBottom
                              relatedBy:NSLayoutRelationEqual
                                  toItem:self.view.safeAreaLayoutGuide
                              attribute:NSLayoutAttributeBottom
                              multiplier:1
                                constant:0],
    [NSLayoutConstraint constraintWithItem:bannerView
                              attribute:NSLayoutAttributeCenterX
                              relatedBy:NSLayoutRelationEqual
                                  toItem:self.view
                              attribute:NSLayoutAttributeCenterX
                              multiplier:1
                                constant:0]
                                ]];
}
@end

Interface Builder

您可以将 GADBannerView 添加到 storyboard 或 xib 文件中。使用此方法时，请务必仅在横幅上添加位置约束条件。例如，在屏幕底部显示自适应横幅广告时，请将横幅广告视图的底部设为等于底部布局指南的顶部，并将 centerX 约束条件设为等于超视图的 centerX。

横幅的广告尺寸仍以编程方式设置：

Swift

bannerView.adSize = currentOrientationAnchoredAdaptiveBanner(width: viewWidth)

Objective-C

self.bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth);

加载广告

在 GADBannerView 创建完毕并配置其属性后，就可以加载广告了。可通过对 GADRequest 对象调用 loadRequest: 来实现：

Swift

override func viewDidLoad() {
  super.viewDidLoad()
  // Set the ad unit ID and view controller that contains the BannerView.
  bannerView.adUnitID = "ca-app-pub-3940256099942544/2435281174"
  bannerView.rootViewController = self

  bannerView.load(Request())
}

SwiftUI

banner.adUnitID = "ca-app-pub-3940256099942544/2435281174"
banner.load(Request())BannerContentView.swift

Objective-C

- (void)viewDidLoad {
  [super viewDidLoad];
  // Set the ad unit ID and view controller that contains the GADBannerView.
  self.bannerView.adUnitID = @"ca-app-pub-3940256099942544/2435281174";
  self.bannerView.rootViewController = self;

  [self.bannerView loadRequest:[GADRequest request]];
}

GADRequest 对象代表单个广告请求，并包含定位信息等内容的属性。

刷新广告

如果您已将广告单元配置为定期刷新，则在广告加载失败时无需请求其他广告。Google 移动广告 SDK 会遵循您在 AdMob 界面中指定的任何刷新频率。如果您尚未启用刷新，请发出新的请求。如需详细了解广告单元刷新（例如设置刷新频率），请参阅为横幅广告使用自动刷新功能。

广告事件

通过使用 GADBannerViewDelegate，您可以监听各种广告生命周期事件，例如广告何时关闭、用户何时离开应用等。

注册横幅广告事件

如需注册横幅广告事件，请将 GADBannerView 上的 delegate 属性设置为实现 GADBannerViewDelegate 协议的对象。一般情况下，实现横幅广告的类也充当代理类，在这种情况下，可将 delegate 属性设为 self。

Swift

import GoogleMobileAds
import UIKit

class ViewController: UIViewController, BannerViewDelegate {

  var bannerView: BannerView!

  override func viewDidLoad() {
    super.viewDidLoad()
    // ...
    bannerView.delegate = self
  }
}

SwiftUI

banner.delegate = selfBannerContentView.swift

Objective-C

@import GoogleMobileAds;

@interface ViewController () <GADBannerViewDelegate>

@property(nonatomic, strong) GADBannerView *bannerView;

@end

@implementation ViewController

-   (void)viewDidLoad {
  [super viewDidLoad];
  // ...
  self.bannerView.delegate = self;
}

实现横幅广告事件

GADBannerViewDelegate 中的每个方法都是可选方法，您可以按照自己的需求选择性实现。以下示例实现了每个方法，并将消息记录到控制台：

Swift

func bannerViewDidReceiveAd(_ bannerView: BannerView) {
  print("bannerViewDidReceiveAd")
}

func bannerView(_ bannerView: BannerView, didFailToReceiveAdWithError error: Error) {
  print("bannerView:didFailToReceiveAdWithError: \(error.localizedDescription)")
}

func bannerViewDidRecordImpression(_ bannerView: BannerView) {
  print("bannerViewDidRecordImpression")
}

func bannerViewWillPresentScreen(_ bannerView: BannerView) {
  print("bannerViewWillPresentScreen")
}

func bannerViewWillDismissScreen(_ bannerView: BannerView) {
  print("bannerViewWillDIsmissScreen")
}

func bannerViewDidDismissScreen(_ bannerView: BannerView) {
  print("bannerViewDidDismissScreen")
}

Objective-C

- (void)bannerViewDidReceiveAd:(GADBannerView *)bannerView {
  NSLog(@"bannerViewDidReceiveAd");
}

- (void)bannerView:(GADBannerView *)bannerView didFailToReceiveAdWithError:(NSError *)error {
  NSLog(@"bannerView:didFailToReceiveAdWithError: %@", [error localizedDescription]);
}

- (void)bannerViewDidRecordImpression:(GADBannerView *)bannerView {
  NSLog(@"bannerViewDidRecordImpression");
}

- (void)bannerViewWillPresentScreen:(GADBannerView *)bannerView {
  NSLog(@"bannerViewWillPresentScreen");
}

- (void)bannerViewWillDismissScreen:(GADBannerView *)bannerView {
  NSLog(@"bannerViewWillDismissScreen");
}

- (void)bannerViewDidDismissScreen:(GADBannerView *)bannerView {
  NSLog(@"bannerViewDidDismissScreen");
}

有关 iOS API Demo 应用中横幅广告代理方法的实现方式，请参阅广告代理示例。

Swift Objective-C

使用场景

以下是这些广告事件方法的一些实际应用示例。

在接收到广告之后才将横幅广告添加到视图层次结构中

在接收到广告前，您可能暂不希望将 GADBannerView 添加到视图层次结构中。为此，您可以监听 bannerViewDidReceiveAd: 事件：

Swift

func bannerViewDidReceiveAd(_ bannerView: BannerView) {
  // Add banner to view and add constraints.
  addBannerViewToView(bannerView)
}

Objective-C

- (void)bannerViewDidReceiveAd:(GADBannerView *)bannerView {
  // Add bannerView to view and add constraints as above.
  [self addBannerViewToView:self.bannerView];
}

为横幅广告添加动画效果

在返回横幅广告后，您也可以利用 bannerViewDidReceiveAd: 事件以动画方式展示该广告，如下例所示：

Swift

func bannerViewDidReceiveAd(_ bannerView: BannerView) {
  bannerView.alpha = 0
  UIView.animate(withDuration: 1, animations: {
    bannerView.alpha = 1
  })
}

Objective-C

- (void)bannerViewDidReceiveAd:(GADBannerView *)bannerView {
  bannerView.alpha = 0;
  [UIView animateWithDuration:1.0 animations:^{
    bannerView.alpha = 1;
  }];
}

暂停和恢复应用

GADBannerViewDelegate 协议包含用于发送各种事件通知的方法，例如点击导致呈现或关闭叠加层等。如果您希望跟踪这些事件是否由广告引起的，请注册这些 GADBannerViewDelegate 方法。

如果您要获取所有类型（而不仅仅是由于广告点击而发生）的重叠式广告展示或外部浏览器调用，您的应用最好监听 UIViewController 或 UIApplication 上具有同样功能的方法。下表显示了可与 GADBannerViewDelegate 方法同时调用且具有同样功能的 iOS 方法：

GADBannerViewDelegate 方法	iOS 方法
`bannerViewWillPresentScreen:`	UIViewController 的 `viewWillDisappear:`
`bannerViewWillDismissScreen:`	UIViewController 的 `viewWillAppear:`
`bannerViewDidDismissScreen:`	UIViewController 的 `viewDidAppear:`

释放广告资源

使用完横幅广告后，您可以释放横幅广告的资源。

如需释放广告的资源，您需要从视图层次结构中移除广告并删除其所有引用：

Swift

// Remove banner from view hierarchy.
bannerView.removeFromSuperview()

// Drop reference to the banner ad.
bannerView = nil

Objective-C

// Remove banner from view hierarchy.
[self.bannerView removeFromSuperview];

// Drop reference to the banner ad.
self.bannerView = nil;

其他资源

GitHub 上的示例

锚定自适应横幅广告示例： Swift | SwiftUI | Objective-C

高级功能演示：Swift | Objective-C

后续步骤

折叠式横幅广告

折叠式横幅广告是一种横幅广告，最初会以较大的叠加层形式展示，并提供一个可将广告收起为较小尺寸的按钮。不妨考虑使用该工具进一步优化效果。如需了解详情，请参阅折叠式横幅广告。

内嵌自适应横幅广告

与锚定自适应横幅广告相比，内嵌自适应横幅广告是一种更大、更高的横幅广告。这种广告的高度可调整，最高可与设备屏幕一样高。对于在可滚动内容中放置横幅广告的应用，建议使用内嵌自适应横幅广告，而不是锚定自适应横幅广告。如需了解详情，请参阅内嵌自适应横幅广告。

浏览其他主题

用户隐私

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

锚定自适应横幅广告

前提条件

务必用测试广告进行测试

创建 GADBannerView

以程序化方式

Swift

SwiftUI

Objective-C

Interface Builder

Swift

Objective-C

加载广告

Swift

SwiftUI

Objective-C

刷新广告

广告事件

注册横幅广告事件

Swift

SwiftUI

Objective-C

实现横幅广告事件

Swift

Objective-C

使用场景

在接收到广告之后才将横幅广告添加到视图层次结构中

Swift

Objective-C

为横幅广告添加动画效果

Swift

Objective-C

暂停和恢复应用

释放广告资源

Swift

Objective-C

其他资源

GitHub 上的示例

后续步骤

折叠式横幅广告

内嵌自适应横幅广告

浏览其他主题

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