內嵌自動調整橫幅廣告

選取平台： Android (Beta 版) 新選取 Android iOS Flutter

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

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

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

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

事前準備

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

導入自動調整橫幅廣告

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

Kotlin

private fun loadAd() {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  val adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320)

  // Step 1 - Create a BannerAdRequest object with ad unit ID and size.
  val adRequest = BannerAdRequest.Builder("AD_UNIT_ID", adSize).build()

  // Step 2 - Load the ad.
  BannerAd.load(
    adRequest,
    object : AdLoadCallback<BannerAd> {
      override fun onAdLoaded(ad: BannerAd) {
        // Assign the loaded ad to the BannerAd object.
        bannerAd = ad
        // Step 3 - Call BannerAd.getView() to get the View and add it
        // to view hierarchy on the UI thread.
        activity?.runOnUiThread {
          binding.bannerViewContainer.addView(ad.getView(requireActivity()))
        }
      }

      override fun onAdFailedToLoad(loadAdError: LoadAdError) {
        bannerAd = null
      }
    }
  )
}

Java

private void loadAd() {
  // Create an inline adaptive ad size. 320 is a placeholder value.
  // Replace 320 with your banner container width.
  AdSize adSize = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(this, 320);

  // Step 1 - Create a BannerAdRequest object with ad unit ID and size.
  BannerAdRequest adRequest = new BannerAdRequest.Builder("AD_UNIT_ID",
      adSize).build();

  // Step 2 - Load the ad.
  BannerAd.load(
      adRequest,
      new AdLoadCallback<BannerAd>() {
        @Override
        public void onAdLoaded(@NonNull BannerAd ad) {
          // Assign the loaded ad to the BannerAd object.
          bannerAd = ad;
          // Step 3 - Call BannerAd.getView() to get the View and add it
          // to view hierarchy on the UI thread.
          if (getActivity() != null) {
            getActivity()
                .runOnUiThread(() ->
                    binding.bannerViewContainer.addView(ad.getView(getActivity())));
          }
        }

        @Override
        public void onAdFailedToLoad(@NonNull LoadAdError adError) {
          bannerAd = null;
        }
      });
}

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

  • 讓內嵌自動調整橫幅廣告以可用最大寬度顯示，效果最佳。在多數情況中，可用最大寬度是指所用裝置螢幕或橫幅上層內容的完整寬度。您必須知道要放置在廣告中的檢視區塊寬度、裝置寬度、父項內容寬度，以及適用的安全區域。

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

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

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

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

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