內嵌自動調整橫幅廣告

自動調整橫幅廣告可讓您指定廣告寬度,從而決定最合適的廣告大小。自動調整橫幅廣告也會針對每部裝置最佳化廣告大小,進而提高成效。這種做法可以改善效能。

與錨定自動調整橫幅廣告相比,內嵌自動調整橫幅廣告尺寸較大、高度較高,且採用可變高度 (而非固定高度)。內嵌自動調整橫幅廣告的高度可變動,且可涵蓋整個螢幕或您指定的最大高度。

舉例來說,您可以將內嵌自動調整橫幅廣告刊登在捲動內容中,例如:

圖表:顯示自動調整橫幅廣告和內嵌自動調整橫幅廣告的差異

事前準備

請先完成「橫幅廣告」入門指南,再繼續操作。

導入自動調整橫幅廣告

與錨定自動調整橫幅廣告不同,內嵌轉接程式橫幅廣告會使用內嵌自動調整橫幅廣告大小載入。如要建立內嵌式自動調整廣告尺寸,請完成下列步驟:

  1. 取得所用裝置的寬度,或者,如果您不想使用畫面的完整寬度,請自行設定寬度。
  2. 針對廣告尺寸類別使用適當的靜態方法 (例如 AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width)),取得所選螢幕方向的內嵌式自動調整廣告尺寸物件。
  3. 如果您想限制橫幅的高度,請使用靜態方法 AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight)

以下範例說明這些步驟:

Java

// Step 1: Create an inline adaptive banner ad size using the activity context.
AdSize adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320);

// Step 2: Create banner using activity context and set the inline ad size and
// ad unit ID.
AdManagerAdView bannerView = new AdManagerAdView(this);
bannerView.setAdUnitId("ad unit ID");

// Note that this sets both the adaptive ad size for backfill inventory as well
// as the supported reservation sizes.
bannerView.setAdSizes(adSize, AdSize.BANNER);

// Step 3: Load an ad.
AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder().build();
bannerView.loadAd(adRequest);
// TODO: Insert banner view in list view or scroll view, etc.

Kotlin

// Step 1: Create an inline adaptive banner ad size using the activity context.
val adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320)

// Step 2: Create banner using activity context and set the inline ad size and
// ad unit ID.
val bannerView = AdManagerAdView(this)
bannerView.adUnitId = "ad unit ID"

// Note that this sets both the adaptive ad size for backfill inventory as well
// as the supported reservation sizes.
bannerView.setAdSizes(adSize, AdSize.BANNER)

// Step 3: Load an ad.
val adRequest = AdManagerAdRequest.Builder().build()
bannerView.loadAd(adRequest)
// TODO: Insert banner view in list view or scroll view, etc.

在應用程式中導入自動調整橫幅廣告時,請注意以下幾點:

  • 內嵌式自動調整橫幅廣告尺寸最適合使用可用的完整寬度。在大多數情況下,這個大小是所用裝置螢幕的完整寬度,或是橫幅的父項內容完整寬度。您必須知道要放入廣告的檢視畫面寬度、裝置寬度、父項內容寬度,以及適用的安全區域。
  • 您可能需要更新或建立新的委刊項,才能使用自適應尺寸。瞭解詳情

自動調整內嵌橫幅廣告大小的方向

如要為特定方向預先載入內嵌式自動調整橫幅廣告,請使用下列方法:

如果您的應用程式同時支援直向和橫向檢視畫面,且您想在目前的螢幕方向預先載入自動調整橫幅廣告,請使用 AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width)。這個方法會在目前的螢幕方向載入廣告。

限制內嵌自動調整橫幅廣告的高度

根據預設,如果內嵌的內嵌自動調整橫幅廣告在沒有 maxHeight 值的情況下,maxHeight 就會設有與裝置高度相等的 maxHeight。如要限制內嵌式自動調整橫幅廣告的高度,請使用 AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight) 方法。

其他資源

GitHub 上的範例

下載範例應用程式,查看內嵌自動調整橫幅廣告的實際運作情形。

Java Kotlin