可收合橫幅廣告

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

必要條件

• 完成橫幅廣告入門指南。

導入作業

請確認橫幅廣告的顯示方式，符合您希望使用者在一般 (收合) 橫幅廣告狀態下看到的尺寸。在廣告中加入額外參數 使用 collapsible 做為請求的鍵，並將廣告刊登位置設為廣告位置。

可收合刊登位置會定義展開區域如何錨定橫幅廣告。

Placement值	行為	預期用途
top	展開廣告的頂端會與收合廣告的頂端對齊。	廣告位於畫面頂端。
bottom	展開廣告的底部會與收合廣告的底部對齊。	廣告位於畫面底部。

如果載入的廣告是可摺疊的橫幅，橫幅會在放入檢視階層後立即顯示可摺疊的疊加層。

Java

private void loadBannerAd() {
  adView = new AdView(this);
  adView.setAdUnitId("ca-app-pub-3940256099942544/2014213617")

  AdSize adSize = getAdSize();
  adView.setAdSize(adSize);
  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the bannerView.
  Bundle extras = new Bundle();
  extras.putString("collapsible", "bottom");

  AdRequest adRequest = new AdRequest.Builder()
      .addNetworkExtrasBundle(AdMobAdapter.class, extras)
     .build();

  adView.loadAd(adRequest);
}

Kotlin

private fun loadBanner() {adView = AdView(this);
  adView.adUnitId = "ca-app-pub-3940256099942544/2014213617"

  adView.setAdSize(adSize)

  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the bannerView.
  val extras = Bundle()
  extras.putString("collapsible", "bottom")

  val adRequest = AdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
    .build()

  adView.loadAd(adRequest)
}

廣告重新整理行為

如果應用程式在 AdMob 網頁介面中為橫幅廣告設定自動重新整理功能，當系統為橫幅廣告版位要求可收合橫幅廣告時，後續重新整理廣告時不會再要求可收合橫幅廣告。這是因為每次重新整理時顯示可收合橫幅廣告，可能會對使用者體驗造成負面影響。

如要在工作階段中的一段時間後，再載入其他可收合橫幅廣告，請在請求中包含可收合橫幅廣告參數，並手動載入廣告。

檢查已載入的廣告是否可摺疊

不可收合橫幅廣告可以傳回可收合橫幅廣告 以便提高成效呼叫 isCollapsible，檢查最後載入的橫幅是否可摺疊。如果要求無法載入，且 橫幅廣告可收合，API 會傳回 true。

Java

public void onAdLoaded() {
  Log.i(TAG, String.format("The last loaded banner is %scollapsible.", adView.isCollapsible() ? "" : "not "));
}

Kotlin

fun onAdLoaded() {
  Log.i(TAG, "The last loaded banner is ${if (adView.isCollapsible) "" else "not "}collapsible.")
}

中介服務

可收合橫幅廣告在 Beta 版期間僅供 Google 廣告需求使用 。透過中介服務放送的廣告，將會恢復正常的不可收合橫幅廣告。