可收合橫幅廣告

可收合橫幅廣告是一種橫幅廣告，一開始會以較大的重疊廣告呈現，您可以透過按鈕將其收合為原本請求的橫幅廣告大小。可收合橫幅廣告旨在提升錨定廣告的成效，這類廣告的尺寸較小。本指南將說明如何為現有的橫幅廣告刊登位置啟用可收合橫幅廣告。

先備知識

• 完整閱讀橫幅廣告入門指南。

導入作業

請確認您的橫幅檢視畫面定義了您希望使用者在一般 (收合) 橫幅狀態中看到的大小。在廣告請求中加入額外參數，並以 collapsible 做為鍵，並將廣告刊登位置設為廣告位置。

可收合刊登位置會定義展開區域錨定到橫幅廣告的方式。

如果載入的廣告是可收合橫幅廣告，移至檢視區塊階層後，橫幅廣告會立即顯示可收合重疊廣告。

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);
}

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)
}

廣告重新整理行為

每隔 30 到 120 秒就要重新整理可收合橫幅廣告，可能會過於頻繁，造成使用者體驗不佳。對於在 AdMob 網頁介面中設定自動重新整理的應用程式，建議您僅將第一個廣告請求顯示為可收合，後續再以原始請求大小重新整理該版位的橫幅廣告。方法是以 collapsible_request_id 的形式將 UUID 傳遞至廣告請求：

extras.putString("collapsible_request_id", UUID.randomUUID().toString());

extras.putString("collapsible_request_id", UUID.randomUUID().toString())

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

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

呼叫 isCollapsible 檢查最後一個載入的橫幅是否可收合。 如果要求無法載入，且上一個橫幅可收合，則 API 會傳回 true。

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

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

中介服務

可收合橫幅廣告在 Beta 版測試階段僅適用於 Google 廣告需求。透過中介服務放送的廣告，將會恢復正常的不可收合橫幅廣告。

廣告放送行為

為爭取橫幅廣告的成效，如果廣告不支援較大的可收合重疊廣告，系統可能會傳回部分可收合橫幅廣告請求，並在一般的橫幅廣告大小中立即顯示。