內嵌自動調整橫幅廣告

自動調整橫幅廣告可透過設定廣告寬度，由系統計算出最佳尺寸。此外，這類廣告能根據不同裝置的特性，調整為最適合的大小，有助於提升成效。

內嵌自動調整橫幅廣告的高度可變，版面比錨定自動調整橫幅廣告更大、更高。這類廣告的高度會依情況調整，可能與螢幕等高，或在您指定的高度上限內。

您可以將內嵌自動調整橫幅廣告放在可捲動的內容中，例如：

事前準備

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

導入自動調整橫幅廣告

與錨定自動調整橫幅廣告不同，內嵌自動調整橫幅廣告載入時，會使用內嵌自動調整橫幅廣告大小。如要建立內嵌自動調整廣告大小，請完成下列步驟：

1. 取得所用裝置的寬度。如不想使用畫面的完整寬度，請自行設定寬度。

   Kotlin

   private val adWidth: Int
     get() {
       val displayMetrics = resources.displayMetrics
       val adWidthPixels =
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
           val windowMetrics: WindowMetrics = this.windowManager.currentWindowMetrics
           windowMetrics.bounds.width()
         } else {
           displayMetrics.widthPixels
         }
       val density = displayMetrics.density
       return (adWidthPixels / density).toInt()
     }
   MainActivity.kt

   Java

   public int getAdWidth() {
     DisplayMetrics displayMetrics = getResources().getDisplayMetrics();
     int adWidthPixels = displayMetrics.widthPixels;
   
     if (VERSION.SDK_INT >= VERSION_CODES.R) {
       WindowMetrics windowMetrics = this.getWindowManager().getCurrentWindowMetrics();
       adWidthPixels = windowMetrics.getBounds().width();
     }
   
     float density = displayMetrics.density;
     return (int) (adWidthPixels / density);
   }
   MainActivity.java

2. 使用廣告大小類別的適當靜態方法 (例如 AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width))，取得所選螢幕方向適用的內嵌自動調整廣告大小物件。

   Kotlin

   val adView = AdView(this@MainActivity)
   adView.setAdSize(AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, adWidth))
   MainActivity.kt

   Java

   final AdView adView = new AdView(MainActivity.this);
   adView.setAdSize(AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, getAdWidth()));
   MainActivity.java

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

• 內嵌自動調整橫幅廣告以最大可用寬度顯示時，效果最佳。這通常是指裝置螢幕的全寬，或橫幅廣告上層內容的完整寬度。請務必掌握廣告所在檢視區塊的寬度、裝置螢幕寬度、上層內容寬度，並考量應保留的安全區域。

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

設定內嵌自動調整橫幅廣告的方向

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

• 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