錨定自動調整橫幅廣告

自動調整橫幅廣告是新一代的回應式廣告，會針對每部裝置調整廣告大小，藉此獲得最佳成效。原本智慧型橫幅廣告僅支援固定高度，改良後的自動調整橫幅廣告則可讓您指定廣告寬度，從而決定理想的廣告大小。

為了選擇最適合的廣告大小，自動調整式橫幅廣告採用固定的顯示比例，而非固定高度。進而使不同裝置和螢幕大小上顯示的橫幅廣告版面比例更加一致，有助提升廣告成效。

使用自動調整橫幅廣告時，請注意，自動調整橫幅廣告一律會針對特定裝置和寬度傳回固定大小，在特定裝置上測試版面配置後，您可以確保廣告大小不會改變。不過，橫幅廣告素材的大小可能會因裝置而異。因此，建議您在版面配置中納入廣告高度的變化。在極少數情況下，系統可能無法填入完整的動態調整大小，而改為在這個版位中以標準大小顯示廣告素材。

必要條件

• 請按照入門指南的說明，匯入 Mobile Ads Unity 外掛程式，並加入 Mobile Ads SDK。

自動調整橫幅廣告的使用時機

在設計上，自動調整橫幅廣告旨在直接取代業界標準的 320x50 橫幅廣告大小，以及智慧型橫幅廣告格式。

這些橫幅廣告尺寸通常用於錨定橫幅，通常會固定在畫面的頂端或底部。

對於這類錨定橫幅廣告，使用自動調整橫幅廣告時的顯示比例會與標準 320x50 廣告相似，如以下三個範例所示：

320x50 橫幅

自動調整橫幅廣告

智慧型橫幅廣告

自動調整橫幅廣告可更有效地運用可用的螢幕大小。此外，與智慧型橫幅相比，自動調整橫幅是更好的選擇，原因如下：

• 它會使用您提供的任何寬度，而不會強制寬度為全螢幕，讓您能夠考量 iOS 上的安全區域，並在 Android 上顯示缺口。

• 它會為特定裝置選取最佳高度，而不是在不同大小的裝置上使用固定高度，藉此減輕裝置分散化造成的影響。

實作注意事項

在應用程式中導入自適應橫幅時，請注意下列事項：

• 您必須知道廣告放置的檢視畫面寬度，並考量裝置寬度和任何適用的安全區域或裁剪區域。
• 請務必確保廣告檢視畫面背景為不透明，以便在放送較小廣告尺寸時，符合 AdMob 政策規定，不會填滿廣告版位。
• 請確認您使用的是最新版 Google Mobile Ads Unity 外掛程式。如要使用中介服務，請使用各中介服務轉接程式的最新版本。
• 自動調整橫幅廣告尺寸的設計目的，是為了在使用可用寬度的情況下發揮最佳效能。在大多數情況下，這會是所用裝置螢幕的完整寬度。請務必考量適用的安全區域。
• 使用自適應 AdSize API 時，Google Mobile Ads SDK 會根據指定的寬度，為橫幅廣告設定最佳化的廣告高度。
• 取得自動調整廣告尺寸的方法有三種：AdSize.GetLandscapeAnchoredAdaptiveBannerAdSizeWithWidth 用於橫向、AdSize.GetPortraitAnchoredAdaptiveBannerAdSizeWithWidth 用於直向，以及 AdSize.GetCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth 用於執行時的目前螢幕方向。
• 特定裝置上針對特定寬度傳回的大小一律相同，因此在特定裝置上測試版面配置後，您可以確保廣告大小不會改變。
• 錨定橫幅的高度不得超過裝置高度的 15% 或 90 個密度獨立像素，且不得小於 50 個密度獨立像素。
• 如要顯示全寬橫幅，您可以使用 AdSize.FullWidth 旗標，而非提供特定寬度。

快速入門導覽課程

導入簡易自動調整錨定橫幅廣告的步驟如下：

1. 取得自動調整橫幅廣告尺寸。您取得的尺寸會用於請求自動調整橫幅廣告。如要取得自動調整廣告尺寸，請務必完成下列操作：
   1. 取得所用裝置的寬度 (以密度無關像素為單位)，或者，如果您不想使用畫面的完整寬度，請自行設定需要的寬度。由於 Screen.width 等 Unity API 會傳回絕對像素，因此您需要除以裝置比例 (可從 MobileAds.Utils.GetDeviceScale() 擷取)。
   2. 使用 AdSize.FullWidth 標記全寬橫幅。
   3. 針對廣告尺寸類別使用適當的靜態方法 (例如 AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(width))，取得目前螢幕方向的自動調整 AdSize 物件。
2. 使用廣告單元 ID、自動調整大小和廣告的相關位置，建立 BannerView 物件。
3. 建立廣告請求物件，然後在您準備的廣告檢視畫面上使用 LoadAd() 方法載入橫幅廣告，做法與處理一般橫幅廣告請求相同。

程式碼範例

以下是載入及重新載入自適應橫幅的範例指令碼，以便配合安全區域調整橫幅大小，以符合螢幕寬度：

using UnityEngine;
using System;
using GoogleMobileAds.Api;

public class AdaptiveBannerSample : MonoBehaviour
{
    private BannerView _bannerView;

    // Use this for initialization
    void Start()
    {
        // Set your test devices.
        // https://developers.google.com/admob/unity/test-ads
        RequestConfiguration requestConfiguration = new RequestConfiguration
        {
            TestDeviceIds = new List<string>
            {
                AdRequest.TestDeviceSimulator,
                // Add your test device IDs (replace with your own device IDs).
                #if UNITY_IPHONE
                "96e23e80653bb28980d3f40beb58915c"
                #elif UNITY_ANDROID
                "75EF8D155528C04DACBBA6F36F433035"
                #endif
            }
        };
        MobileAds.SetRequestConfiguration(requestConfiguration);

        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize((InitializationStatus status) => 
        {
            RequestBanner();
        });
    }

    public void OnGUI()
    {
        GUI.skin.label.fontSize = 60;
        Rect textOutputRect = new Rect(
          0.15f * Screen.width,
          0.25f * Screen.height,
          0.7f * Screen.width,
          0.3f * Screen.height);
        GUI.Label(textOutputRect, "Adaptive Banner Example");
    }

    private void RequestBanner()
    {
        // These ad units are configured to always serve test ads.
        #if UNITY_EDITOR
            string adUnitId = "unused";
        #elif UNITY_ANDROID
            string adUnitId = "ca-app-pub-3212738706492790/6113697308";
        #elif UNITY_IPHONE
            string adUnitId = "ca-app-pub-3212738706492790/5381898163";
        #else
            string adUnitId = "unexpected_platform";
        #endif

        // Clean up banner ad before creating a new one.
        if (_bannerView != null)
        {
            _bannerView.Destroy();
        }

        AdSize adaptiveSize =
                AdSize.GetCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(AdSize.FullWidth);

        _bannerView = new BannerView(adUnitId, adaptiveSize, AdPosition.Bottom);

        // Register for ad events.
        _bannerView.OnBannerAdLoaded += OnBannerAdLoaded;
        _bannerView.OnBannerAdLoadFailed += OnBannerAdLoadFailed;

        AdRequest adRequest = new AdRequest();

        // Load a banner ad.
        _bannerView.LoadAd(adRequest);
    }

    #region Banner callback handlers

    private void OnBannerAdLoaded(object sender, EventArgs args)
    {
        Debug.Log("Banner view loaded an ad with response : "
                 + _bannerView.GetResponseInfo());
        Debug.Log("Ad Height: {0}, width: {1}",
                _bannerView.GetHeightInPixels(),
                _bannerView.GetWidthInPixels());
    }

    private void OnBannerAdLoadFailed(LoadAdError error)
    {
        Debug.LogError("Banner view failed to load an ad with error : "
                + error);
    }

    #endregion
}

這裡使用 AdSize.GetCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth 函式，取得目前介面方向中固定位置的橫幅大小。如要在特定方向預先載入固定橫幅，請使用 AdSize.GetPortraitAnchoredAdaptiveBannerAdSizeWithWidth 和 AdSize.GetLandscapeAnchoredAdaptiveBannerAdSizeWithWidth 中的相關函式。