內嵌自動調整橫幅廣告

自動調整橫幅廣告可讓您指定廣告寬度，從而決定最合適的廣告大小。自動調整橫幅廣告也會針對每部裝置最佳化廣告大小，進而提高成效。這麼做可創造 效能也將有所提升

與錨定自動調整橫幅廣告相比，內嵌自動調整橫幅廣告更大 並使用變數而非固定高度內嵌自動調整橫幅廣告的 可能會涵蓋整個螢幕或最大高度 這個虛擬機器

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

事前準備

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

導入自動調整橫幅廣告

與錨定自動調整橫幅廣告不同，內嵌轉接程式橫幅廣告會以內嵌方式載入 自動調整橫幅廣告大小。如要建立內嵌自動調整廣告大小，請完成 包括：

1. 取得使用中裝置的寬度，或者如果您不想自行設定寬度 使用畫面的完整寬度
2. 針對廣告尺寸類別使用適當的靜態方法，例如 AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width) 取得所選方向的內嵌自動調整廣告大小物件。
3. 如要限制橫幅廣告的高度，請使用靜態方法 AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight) ，直接在 Google Cloud 控制台實際操作。

以下範例會示範這些步驟：

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.

重要事項： Ad Manager 預訂廣告大小可以在同一個廣告版位中放送 自動調整橫幅廣告尺寸如要搭配 Ad Manager 使用自動調整橫幅廣告，請按照下列步驟操作 在同一個廣告版位中呼叫 setAdSizes，並使用大小清單呼叫 自動調整大小以及各種大小的預訂廣告。

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

• 內嵌自動調整橫幅廣告大小在完整使用可用的素材資源時，成效最佳 寬度。在大多數情況下，這個大小是裝置螢幕的 或是橫幅父項內容的完整寬度您必須知道要放入廣告的檢視畫面寬度、裝置寬度、父項內容寬度，以及適用的安全區域。

• 您可能需要更新或建立新的委刊項，才能使用自動調整功能 大小。瞭解詳情。

調整內嵌自動調整橫幅廣告大小的位置

如要針對特定方向預先載入內嵌自動調整橫幅廣告，請使用 方法如下：

• AdSize.getPortraitInlineAdaptiveBannerAdSize(Context context, int width)

• AdSize.getLandscapeInlineAdaptiveBannerAdSize(Context context, int width)

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

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

根據預設，未指定 maxHeight 值的內嵌自動調整橫幅廣告，其 maxHeight 會等於裝置高度。限制內嵌自動調整資源配置 橫幅廣告高度，請使用 AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight) 方法。

其他資源

GitHub 上的範例

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

Java Kotlin