可收合橫幅廣告

選取平台： Android iOS Unity Flutter

可收合橫幅廣告一開始出現時，會以較大尺寸重疊在畫面上，使用者點選上面的按鈕後，廣告就會收合成最初請求的橫幅尺寸。這種顯示方式能讓原本尺寸較小的錨定廣告更醒目，提升廣告效果。本指南將介紹如何在現有的橫幅廣告刊登位置，顯示可收合橫幅廣告。

必要條件

導入作業

請確認您的橫幅廣告檢視區塊，已設為您希望使用者在廣告收合狀態下看到的標準尺寸。接著在廣告請求中加入 extras 參數，將 collapsible 設為鍵，並將廣告刊登位置設為相應的值。

collapsible 刊登位置定義了展開區域會怎麼固定在橫幅廣告上。

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

如果載入的是可收合橫幅廣告，則橫幅廣告一加到檢視區塊階層，就會立即顯示可收合疊加層。

Java

private void loadCollapsibleBanner() {
  // 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");

  // Create an ad request.
  AdRequest adRequest =
      new AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();

  // ...

  // Start loading a collapsible banner ad.
  adView.loadAd(adRequest);
}

CollapsibleBannerFragment.java

Kotlin

private fun loadCollapsibleBanner() {
  // 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")

  // Create an ad request.
  val adRequest =
    AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()

  // ...

  // Start loading a collapsible banner ad.
  adView.loadAd(adRequest)
}

CollapsibleBannerFragment.kt

廣告重新整理行為

如果在 Ad Manager 網頁介面中，設定自動重新整理應用程式內的橫幅廣告，當某個橫幅廣告版位請求到可收合橫幅廣告，後續更新將不再請求這類廣告，因為每次更新都重新展開廣告，可能對使用者體驗造成負面影響。

如果想在同一工作階段內再次載入可收合橫幅廣告，可以手動發送包含 collapsible 參數的廣告請求。

檢查載入的廣告是否可收合

為盡可能提高成效，可收合橫幅廣告的請求也可能傳回不可收合的橫幅廣告。您可以呼叫 isCollapsible 來檢查最新載入的橫幅廣告能否收合。如果請求載入失敗，而且前一則橫幅廣告可收合，API 會回傳 true。

Java

public void onAdLoaded() {
  Log.i(
      MainActivity.LOG_TAG,
      String.format("Ad loaded. adView.isCollapsible() is %b.", adView.isCollapsible()));
}
CollapsibleBannerFragment.java

Kotlin

override fun onAdLoaded() {
  Log.i(
    MainActivity.LOG_TAG,
    "Ad loaded. adView.isCollapsible() is ${adView.isCollapsible}.",
  )
}
CollapsibleBannerFragment.kt

中介服務

可收合橫幅廣告僅適用於 Google 廣告需求。透過中介服務放送的廣告，會顯示為一般的不可收合橫幅廣告。