內嵌自動調整橫幅廣告

選取平台： Android iOS Flutter Android (舊版)

自動調整橫幅廣告的寬度可自由指定，由您決定最適合各種裝置的廣告大小。與錨定自動調整橫幅廣告不同，內嵌自動調整橫幅廣告的版面更大、更高。內嵌自動調整橫幅廣告的高度會依情況調整。可能與螢幕等高，或在您指定的高度上限內。

本指南說明如何建立內嵌自動調整橫幅廣告，以及設定橫幅大小。

下圖顯示捲動內容中的內嵌自動調整橫幅廣告：

事前準備

繼續操作前，請先設定橫幅廣告。

如要查看完整的內嵌自動調整橫幅廣告範例，請下載下列範例應用程式：

• Java
• Kotlin

導入內嵌自動調整橫幅廣告

如要導入內嵌自動調整橫幅廣告，請設定廣告大小、建立廣告請求，然後載入廣告。

如要調整內嵌自動調整橫幅廣告的大小，請決定廣告寬度。常見方法包括：

• 使用全螢幕寬度。
• 使用包含廣告的上層版面配置寬度。
• 根據裝置的安全區域調整寬度。

建立廣告大小物件時，請使用這個計算出的寬度。

以下範例會設定廣告大小、建立廣告請求，然後載入廣告：

Kotlin

private fun loadInlineAdaptiveBannerAd(adView: AdView, activity: Activity) {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  val bannerWidth = 320
  val adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(activity, bannerWidth)
  val adRequest = BannerAdRequest.Builder(AD_UNIT_ID, adSize).build()

  adView.loadAd(
    adRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        Log.d(TAG, "Inline adaptive banner ad loaded.")
      }

      override fun onAdFailedToLoad(adError: LoadAdError) {
        Log.d(TAG, "Inline adaptive banner ad failed to load: $adError")
      }
    },
  )
}
BannerSnippets.kt

Java

private void loadInlineAdaptiveBannerAd(@NonNull AdView adView, @NonNull Activity activity) {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  int bannerWidth = 320;
  AdSize adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(activity, bannerWidth);
  BannerAdRequest adRequest = new BannerAdRequest.Builder(AD_UNIT_ID, adSize).build();

  adView.loadAd(
      adRequest,
      new AdLoadCallback<BannerAd>() {
        @Override
        public void onAdLoaded(@NonNull BannerAd bannerAd) {
          Log.d(TAG, "Inline adaptive banner ad loaded.");
        }

        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          Log.d(TAG, "Inline adaptive banner ad failed to load: " + adError);
        }
      });
}
BannerSnippets.java

將 AD_UNIT_ID 替換為廣告單元 ID。

設定小於或等於裝置螢幕大小的廣告尺寸。如要判斷螢幕大小上限，請使用 Resources.getDisplayMetrics 方法。AdSize 物件尺寸使用密度獨立像素 (dp)。比較時，請將螢幕大小從像素轉換為 dp。如要進一步瞭解大小限制，請參閱「廣告請求大小規定」。

設定內嵌自動調整橫幅廣告的版面配置

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

• AdSize.getPortraitInlineAdaptiveBannerAdSize(Context context, int width)

• AdSize.getLandscapeInlineAdaptiveBannerAdSize(Context context, int width)

如果應用程式支援直向與橫向顯示，而您想預先載入符合目前版面配置的自動調整橫幅廣告，請使用 AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(Context context, int width) 方法。這個方法會在目前的版面配置中載入廣告。

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

如果建立內嵌自動調整橫幅廣告時未指定 maxHeight 值，高度上限即為裝置高度。如要限制內嵌自動調整橫幅廣告的高度，請使用 AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight) 方法。