橫幅廣告

橫幅廣告是一種顯示在圖片中的矩形圖片或文字廣告。 這類廣告素材會在使用者與應用程式互動時停留在螢幕上，而且會在一段時間後自動重新整理。如果您是第一次使用行動廣告，不妨從這裡開始著手。 個案研究。

本指南將說明如何將 AdMob 橫幅廣告整合到 Unity 應用程式中。除了程式碼片段和操作說明之外，這項工具還有關於如何調整橫幅廣告大小，並提供其他資源的連結。

必要條件

完成開始使用。您的 Unity 應用程式應已匯入 Google Mobile Ads Unity 外掛程式。

建立 BannerView

顯示橫幅廣告的第一步是在與 GameObject 連結的 C# 指令碼中建立 BannerView 物件。

若要透過 Unity 編輯器輕鬆整合廣告，不妨試試全新的廣告刊登位置測試版。

using System;
using UnityEngine;
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    private BannerView bannerView;
    ...
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(initStatus => { });

        this.RequestBanner();
    }

    private void RequestBanner()
    {
        #if UNITY_ANDROID
            string adUnitId = "ca-app-pub-3940256099942544/6300978111";
        #elif UNITY_IPHONE
            string adUnitId = "ca-app-pub-3940256099942544/2934735716";
        #else
            string adUnitId = "unexpected_platform";
        #endif

        // Create a 320x50 banner at the top of the screen.
        this.bannerView = new BannerView(adUnitId, AdSize.Banner, AdPosition.Top);
    }
}

BannerView 的建構函式含有以下參數：

  • adUnitId - BannerView 應載入廣告的 AdMob 廣告單元編號。
  • AdSize - 您要使用的 AdMob 廣告大小 (詳情請參閱橫幅廣告大小)。
  • AdPosition - 橫幅廣告應放置的位置。AdPosition 列舉列出有效的廣告排名值。

請特別注意，使用不同廣告單元的方式視平台而定。您必須使用 iOS 廣告單元在 iOS 上發出廣告請求，使用 Android 廣告單元在 Android 上提出請求。

(選用) 自訂廣告排名

如要進一步控制 BannerView 在螢幕上的位置 (相較於 AdPosition 值提供的內容)，請使用具有 x 和 y 座標的 BannerView 建構函式做為參數：

// Create a 320x50 banner ad at coordinate (0,50) on screen.
BannerView bannerView = new BannerView(adUnitId, AdSize.Banner, 0, 50);

BannerView 的左上角會位於傳送至建構函式的 x 和 y 值，其中來源為畫面左上角。

(選用) 自訂廣告大小

除了使用 AdSize 常數以外，您也可以為廣告指定自訂大小：

AdSize adSize = new AdSize(250, 250);
BannerView bannerView = new BannerView(adUnitId, adSize, AdPosition.Bottom);

一律使用測試廣告進行測試

上述範例程式碼包含廣告單元編號，您可以免費用它來請求廣告。它經過特別設定，能夠針對每個要求傳回測試廣告，而非實際廣告，因此您可以放心使用。

不過，在 AdMob 使用者介面中註冊應用程式並建立自己的廣告單元 ID 後，您就能在應用程式中使用該廣告單元 ID。開發完成後，您必須明確將裝置設定為測試裝置。 這點非常重要。使用實際廣告進行測試 (即使您從未輕觸廣告) 違反了 AdMob 政策，可能會導致您的帳戶遭到停權。請參閱「測試廣告」一文，瞭解如何確保開發過程中一定會有測試廣告。

載入廣告

BannerView 執行個體化後，下一步就是載入廣告。您可以使用 BannerView 類別中的 loadAd() 方法完成這個動作。會使用 AdRequest 引數，其中包含單一廣告請求的執行階段資訊 (例如指定目標資訊)。

以下舉例說明如何載入廣告：

...
    private void RequestBanner()
    {
        #if UNITY_ANDROID
            string adUnitId = "ca-app-pub-3940256099942544/6300978111";
        #elif UNITY_IPHONE
            string adUnitId = "ca-app-pub-3940256099942544/2934735716";
        #else
            string adUnitId = "unexpected_platform";
        #endif

        // Create a 320x50 banner at the top of the screen.
        this.bannerView = new BannerView(adUnitId, AdSize.Banner, AdPosition.Top);

        // Create an empty ad request.
        AdRequest request = new AdRequest.Builder().Build();

        // Load the banner with the request.
        this.bannerView.LoadAd(request);
    }
...

大功告成！您的應用程式現在可以顯示 AdMob 的橫幅廣告了。

廣告事件

若要進一步自訂廣告的行為，您可以在廣告的生命週期中載入多個事件：載入、開啟、關閉等等。監聽適當的 EventHandler 來監聽這些事件，如下所示。

...
using System;
using UnityEngine;
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    private BannerView bannerView;

    public void Start()
    {
        this.RequestBanner();
    }

    private void RequestBanner()
    {

        #if UNITY_ANDROID
            string adUnitId = "ca-app-pub-3940256099942544/6300978111";
        #elif UNITY_IPHONE
            string adUnitId = "ca-app-pub-3940256099942544/2934735716";
        #else
            string adUnitId = "unexpected_platform";
        #endif

        this.bannerView = new BannerView(adUnitId, AdSize.Banner, AdPosition.Top);

        // Called when an ad request has successfully loaded.
        this.bannerView.OnAdLoaded += this.HandleOnAdLoaded;
        // Called when an ad request failed to load.
        this.bannerView.OnAdFailedToLoad += this.HandleOnAdFailedToLoad;
        // Called when an ad is clicked.
        this.bannerView.OnAdOpening += this.HandleOnAdOpened;
        // Called when the user returned from the app after an ad click.
        this.bannerView.OnAdClosed += this.HandleOnAdClosed;
        // Called when the ad click caused the user to leave the application.
        this.bannerView.OnAdLeavingApplication += this.HandleOnAdLeavingApplication;

        // Create an empty ad request.
        AdRequest request = new AdRequest.Builder().Build();

        // Load the banner with the request.
        this.bannerView.LoadAd(request);
    }

    public void HandleOnAdLoaded(object sender, EventArgs args)
    {
        MonoBehaviour.print("HandleAdLoaded event received");
    }

    public void HandleOnAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
    {
        MonoBehaviour.print("HandleFailedToReceiveAd event received with message: "
                            + args.Message);
    }

    public void HandleOnAdOpened(object sender, EventArgs args)
    {
        MonoBehaviour.print("HandleAdOpened event received");
    }

    public void HandleOnAdClosed(object sender, EventArgs args)
    {
        MonoBehaviour.print("HandleAdClosed event received");
    }

    public void HandleOnAdLeavingApplication(object sender, EventArgs args)
    {
        MonoBehaviour.print("HandleAdLeavingApplication event received");
    }
}

OnAdFailedToLoad 事件包含特殊的事件引數。此函式會傳送 HandleAdFailedToLoadEventArgs 的執行個體，並搭配包含錯誤的 Message 說明：

public void HandleOnAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
{
  MonoBehaviour.print("Banner failed to load: " + args.Message);
  // Handle the ad failed to load event.
};
廣告事件說明
OnAdLoaded 廣告載入完畢後，就會執行 OnAdLoaded 事件。
OnAdFailedToLoad 廣告無法載入時，就會叫用 OnAdFailedToLoad 事件。Message 參數會說明發生的失敗類型。
OnAdOpening 系統會在使用者輕觸廣告時叫用這個方法。如果您使用分析套件來追蹤點閱次數，就很適合用來記錄。
OnAdClosed 如果使用者在查看廣告到達網頁網址後返回應用程式，就會叫用這個方法。您的應用程式可藉此恢復已暫停的活動，或執行其他必要動作以做好互動準備。
OnAdLeavingApplication 當使用者在 onAdOpened 上開啟另一個應用程式 (例如 Google Play 商店) 背景時，

下表列出標準橫幅廣告大小。

大小 (dp (WxH)) 說明 發布日期 AdSize 常數
320 x 50 標準橫幅廣告 手機和平板電腦 BANNER
320x100 大型橫幅廣告 手機和平板電腦 LARGE_BANNER
300 x 250 IAB 中矩形廣告 手機和平板電腦 MEDIUM_RECTANGLE
468x60 IAB 全尺寸橫幅廣告 平板電腦 FULL_BANNER
728x90 IAB 超級橫幅廣告 平板電腦 LEADERBOARD
提供的寬度 x 自動調整高度 自動調整橫幅廣告 手機和平板電腦 無
螢幕寬度 x 32|50|90 智慧型橫幅廣告 手機和平板電腦 SMART_BANNER
進一步瞭解自動調整橫幅廣告，以取代智慧型橫幅廣告。

清除橫幅廣告

使用完 BannerView 後，請務必先呼叫 Destroy() 方法再捨棄對其的參照：

bannerView.Destroy();

讓外掛程式通知物件已經不再使用，並且可以取回所佔用的記憶體。無法呼叫這個方法會導致記憶體流失。

其他資源

範例

成功案例