折叠式横幅广告

折叠式横幅广告是一种横幅广告，初始展示时采用较大的 重叠式广告，且带有一个按钮可将其折叠为最初请求的横幅广告尺寸。 折叠式横幅广告旨在提升 否则会比较小本指南介绍了如何启用折叠式横幅广告 现有横幅广告展示位置的广告。

前提条件

• 完成横幅广告入门指南。

实现

请确保使用您希望用户看到的尺寸来定义横幅广告视图 处于常规（已收起）横幅广告状态。在广告请求中添加 extras 参数，并将 collapsible 作为键，将广告展示位置作为值。

可折叠的展示位置定义展开区域如何锚定到横幅广告 。

Placement 值	行为	预期用例
top	展开的广告的顶部与折叠广告的顶部对齐。	广告位于屏幕的顶部。
bottom	展开后广告的底部与展开前广告的底部对齐 。	广告位于屏幕底部。

如果加载的广告是折叠式横幅广告，横幅广告会显示 立即叠加。

Swift

func loadBannerAd() {
   bannerView.adUnitID = "ca-app-pub-3940256099942544/8388050270"
   bannerView.rootViewController = self
   let viewWidth = FRAME_WIDTH
   bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth)

   let request = GADRequest()

   // Create an extra parameter that aligns the bottom of the expanded ad to
   // the bottom of the bannerView.
   let extras = GADExtras()
   extras.additionalParameters = ["collapsible" : "bottom"]
   request.register(extras)

   bannerView.load(request)
 }

Objective-C

- (void)loadBannerAd {
  self.bannerView.adUnitID = @"ca-app-pub-3940256099942544/8388050270";
  CGFloat viewWidth = FRAME_WIDTH;
  self.bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth);

  GADRequest *request = [GADRequest request];

  // Create an extra parameter that aligns the bottom of the expanded ad to the
  // bottom of the bannerView.
  GADExtras *extras = [[GADExtras alloc] init];
  extras.additionalParameters = @{@"collapsible" : @"bottom"};
  [request registerAdNetworkExtras:extras];

  [self.bannerView loadRequest:request];
}

广告刷新行为

对于在 Ad Manager 网页界面中 请求了相应横幅广告位，那么后续的广告刷新操作便不会 折叠式横幅广告这是因为 可能会对用户体验产生负面影响。

如果希望稍后在此会话中加载另一个折叠式横幅广告，您可以执行以下操作： 通过包含可折叠参数的请求手动加载广告。

检查已加载的广告是否可收起

折叠式横幅广告可返回不可折叠式横幅广告 来最大限度地提升效果调用 isCollapsible 以检查最后一个 可折叠如果请求无法加载，而之前的 则 API 会返回 true。

Swift

func bannerViewDidReceiveAd(_ bannerView: GADBannerView) {
  print("The last loaded banner is \(bannerView.isCollapsible ? "" : "not") collapsible.")
}

Objective-C

- (void)bannerViewDidReceiveAd:(GADBannerView *)bannerView {
  NSLog(@"The last loaded banner is %@collapsible.", (bannerView.isCollapsible ? @"" : @"not "));
}

中介

折叠式横幅广告在 Beta 版阶段仅适用于 Google 需求来源 。通过中介投放的广告将显示为常规的不可折叠横幅广告。