在 Unity 應用程式中加入橫額廣告和中型長方形廣告

有了 Audience Network，您的 Android 和 iOS 應用程式便可以透過 Facebook 廣告營利。這份指南會說明如何在應用程式中加入橫額廣告。

橫額廣告和中型長方形廣告執行步驟

第 1 步：建立橫額物件

第 2 步：新增回調事件

第 3 步：載入廣告

第 4 步：顯示廣告

第 1 步：建立橫額物件

如要顯示橫額廣告，首先您要在附加至 GameObject 的 C# 指令碼中建立 AdView 物件。

...
using AudienceNetwork;
...

public class AdViewTest : MonoBehaviour
{
    ...
    private AdView adView;
    ...

    public void LoadBanner()
    {
        if (this.adView) {
            this.adView.Dispose();
        }

        this.adView = new AdView("YOUR_PLACEMENT_ID", AdSize.BANNER_HEIGHT_50);
        this.adView.Register(this.gameObject);

        // Set delegates to get notified on changes or when the user interacts with the ad.
        this.adView.AdViewDidLoad = (delegate() {
            Debug.Log("Banner loaded.");
            this.adView.Show(100);
        });
        adView.AdViewDidFailWithError = (delegate(string error) {
            Debug.Log("Banner failed to load with error: " + error);
        });
        adView.AdViewWillLogImpression = (delegate() {
            Debug.Log("Banner logged impression.");
        });
        adView.AdViewDidClick = (delegate() {
            Debug.Log("Banner clicked.");
        });

        // Initiate a request to load an ad.
        adView.LoadAd();
    }
    ...
}

AdView 的建構函式包含以下參數：

• placementId：此橫額廣告單位的 Audience Network 版位編號。
• size：橫額廣告尺寸，由 AdSize 列舉值指定。

第 2 步：新增回調事件

然後，您可以執行幾次回調，以訂閱橫額廣告的生命週期事件。為事件註冊委派，以聽取這些事件，正如下列範例所示：

...
// Set delegates to get notified on changes or when the user interacts with the ad.
this.adView.AdViewDidLoad = (delegate() {
    Debug.Log("Banner loaded.");
    this.adView.Show(100);
});
adView.AdViewDidFailWithError = (delegate(string error) {
    Debug.Log("Banner failed to load with error: " + error);
});
adView.AdViewWillLogImpression = (delegate() {
    Debug.Log("Banner logged impression.");
});
adView.AdViewDidClick = (delegate() {
    Debug.Log("Banner clicked.");
});
...

第 3 步：載入廣告

在 AdView 實體化後，下一步就是載入廣告。您可以使用 AdView 類別的 loadAd() 方法載入廣告。

以下透過上述範例，展示了如何載入廣告：

...
adView.LoadAd();
...

第 4 步：顯示廣告

最後，在載入橫額廣告後，您可以呼叫 Show 方法，從而在螢幕上顯示廣告。例如，在完成載入後，您可以於 AdViewDidLoad 回調中顯示廣告：

this.adView.AdViewDidLoad = (delegate() {
    Debug.Log("Banner loaded.");
    this.adView.Show(100);
});

在 AdView 類別中，您可以使用 3 種不同類型的 Show 方法來顯示橫額廣告單位：

• public bool Show(AdPosition position)：在預先定義的位置顯示橫額廣告單位，可選用 AdPosition.TOP 以將廣告單位顯示在螢幕頂部，又或者 AdPosition.BOTTOM 以將廣告單位顯示在螢幕底部。
• public bool Show(double y)：在螢幕的 (0, y) 座標處顯示橫額廣告單位。
• public bool Show(double x, double y)：在螢幕的 (x, y) 座標處顯示橫額廣告單位。

橫額廣告尺寸

Audience Network 支援在 AdView 中使用三種廣告尺寸。橫額廣告單位的寬度是可調整的，但至少是 320 像素，只有高度已明確規定。