可收合橫幅廣告是一種橫幅廣告,一開始會以較大的重疊廣告呈現,您可以透過按鈕將其收合為原本請求的橫幅廣告大小。可收合橫幅廣告旨在提升錨定廣告的成效,這類廣告的尺寸較小。本指南將說明如何為現有的橫幅廣告刊登位置啟用可收合橫幅廣告。
先備知識
- 完整閱讀橫幅廣告入門指南。
導入作業
請確認您的橫幅檢視畫面定義了您希望使用者在一般 (收合) 橫幅狀態中看到的大小。在廣告請求中加入額外參數,並以 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)
}
廣告重新整理行為
每隔 30 到 120 秒就要重新整理可收合橫幅廣告,可能會過於頻繁,造成使用者體驗不佳。對於在 Ad Manager 網頁介面中設定自動重新整理的應用程式,建議您僅將第一個廣告請求顯示為可收合,後續重新整理該版位的橫幅廣告則套用原始請求的大小。方法是以 collapsible_request_id
的形式將 UUID 傳遞至廣告請求:
Java
extras.putString("collapsible_request_id", UUID.randomUUID().toString());
Kotlin
extras.putString("collapsible_request_id", UUID.randomUUID().toString())
如果您想在工作階段中的一段時間後載入其他可收合橫幅廣告,可在請求中包含可收合橫幅廣告參數,然後手動載入廣告。
檢查載入的廣告是否可收合
呼叫 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 廣告需求。透過中介服務放送的廣告,將會恢復正常的不可收合橫幅廣告。
廣告放送行為
為爭取橫幅廣告的成效,如果廣告不支援較大的可收合重疊廣告,系統可能會傳回部分可收合橫幅廣告請求,並在一般的橫幅廣告大小中立即顯示。