內嵌自動調整橫幅廣告

選取平台： Android iOS Flutter

自動調整橫幅廣告可讓您指定廣告寬度，從而決定理想的廣告大小。自動調整橫幅廣告也會針對每部裝置調整適當的廣告大小，進而提升成效。這種做法可帶來提升成效的機會。

相較於錨定自動調整橫幅廣告，內嵌自動調整橫幅廣告更大、更高，且採用可變高度而非固定高度。自動調整內嵌橫幅廣告的高度可變，且可能涵蓋整個畫面，或您指定的高度上限。

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

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

事前準備

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

導入自動調整橫幅廣告

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

  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.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width) 這個方法會載入目前螢幕方向的廣告。

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

根據預設，如果自動調整內嵌橫幅廣告在例項化時沒有 maxHeight 值，則 maxHeight 會等於裝置高度。如要限制內嵌自動調整橫幅廣告的高度，請使用 AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight) 方法。

其他資源

GitHub 上的範例

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

Java Kotlin