可收合橫幅廣告

可收合橫幅廣告一開始會以較大的重疊廣告顯示，並提供按鈕，可將廣告收合為原先要求的橫幅廣告大小。可收合的橫幅廣告旨在改善錨定廣告的成效，因為這類廣告的尺寸較小。本指南說明如何為現有的橫幅廣告刊登位置啟用可摺疊的橫幅廣告。

必要條件

實作

請確認橫幅檢視畫面已定義使用者在一般 (收合) 橫幅狀態下看到的大小。在廣告要求中加入額外參數，並將 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 需求。透過中介服務放送的廣告會顯示為一般無法收合橫幅廣告。