可收合橫幅廣告

可收合橫幅廣告是一開始會以較大重疊廣告顯示的橫幅廣告,並提供按鈕,可將廣告收合為原先要求的橫幅廣告大小。可收合橫幅廣告旨在提升錨定廣告的成效 也就是較小的廣告本指南說明如何啟用可收合橫幅廣告 現有橫幅刊登位置的廣告

必要條件

導入作業

確定您的橫幅檢視定義了您希望使用者看到的大小 正常 (收合) 橫幅廣告狀態。在廣告中加入額外參數 使用 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)
}

廣告重新整理行為

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

如果想在工作階段稍後載入其他可收合橫幅廣告 並透過包含可收合參數的請求手動載入廣告。

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

非可收合橫幅廣告可針對可收合橫幅廣告要求傳回,以便盡可能提高成效。呼叫 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 需求。透過中介服務放送的廣告,將會恢復正常的不可收合橫幅廣告。