插頁式廣告

插頁式廣告會全螢幕顯示，覆蓋整個應用程式的介面。這類廣告通常會在應用程式流程中的自然轉換點顯示，例如遊戲關卡之間的暫停時間。當應用程式顯示全螢幕廣告時，使用者可以選擇輕觸廣告前往到達網頁，或是關閉廣告返回應用程式。

本指南說明如何將插頁廣告整合至 Unity 應用程式。

必要條件

• 完成入門指南。

請務必使用測試廣告進行測試

下列範例程式碼包含廣告單元 ID，可用於要求測試廣告。系統已特別將其設定為針對每項請求傳回測試廣告，而非正式廣告，因此可安全使用。

不過，在 Ad Manager 網頁介面中註冊應用程式，並建立要用於應用程式的廣告單元 ID 後，請在開發期間明確將裝置設為測試裝置。

/21775744923/example/interstitial

初始化 Mobile Ads SDK

在載入廣告之前，請讓應用程式呼叫 MobileAds.Initialize()，初始化 Mobile Ads SDK。這項操作只需執行一次，最好是在應用程式啟動時執行。

using GoogleMobileAds;
using GoogleMobileAds.Api;

public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize((InitializationStatus initStatus) =>
        {
            // This callback is called once the MobileAds SDK is initialized.
        });
    }
}

如果您使用中介服務，請等到回呼發生後再載入廣告，這樣可確保所有中介服務轉換介面都已初始化。

實作

整合插頁式廣告的主要步驟如下：

1. 載入插頁式廣告
2. 顯示插頁式廣告
3. 監聽插頁式廣告事件
4. 清理插頁式廣告
5. 預先載入下一則插頁式廣告

載入插頁式廣告

您可以使用 InterstitialAd 類別上的靜態 Load() 方法載入插頁式廣告。載入方法需要廣告單元 ID、AdManagerAdRequest 物件，以及在廣告載入成功或失敗時呼叫的完成處理常式。完成處理常式會將已載入的 AdManagerInterstitialAd 物件做為參數提供。以下範例說明如何載入 AdManagerInterstitialAd。

  // This ad unit is configured to always serve test ads.
  private string _adUnitId = "/21775744923/example/interstitial";

  private InterstitialAd _interstitialAd;

  /// <summary>
  /// Loads the interstitial ad.
  /// </summary>
  public void LoadInterstitialAd()
  {
      // Clean up the old ad before loading a new one.
      if (_interstitialAd != null)
      {
            _interstitialAd.Destroy();
            _interstitialAd = null;
      }

      Debug.Log("Loading the interstitial ad.");

      // create our request used to load the ad.
      var adRequest = new AdManagerAdRequest();

      // send the request to load the ad.
      AdManagerInterstitialAd.Load(_adUnitId, adRequest,
          (InterstitialAd ad, LoadAdError error) =>
          {
              // if error is not null, the load request failed.
              if (error != null || ad == null)
              {
                  Debug.LogError("interstitial ad failed to load an ad " +
                                 "with error : " + error);
                  return;
              }

              Debug.Log("Interstitial ad loaded with response : "
                        + ad.GetResponseInfo());

              _interstitialAd = ad;
          });
  }

警告： 強烈建議您不要在廣告載入失敗時，嘗試從廣告請求完成區塊載入新廣告。如果您必須從廣告請求完成區塊載入廣告，請限制廣告載入重試次數，以免在網路連線不佳等情況下，廣告請求持續失敗。

提示：您可以在要顯示預先載入的廣告之前，使用廣告載入呼叫建立快取，這樣一來，在需要時就能立即顯示廣告。由於廣告會在一小時後到期，因此您應每小時清除快取，並重新載入新的廣告。

顯示插頁式廣告

如要顯示已載入的插頁式廣告，請對 AdManagerInterstitialAd 例項呼叫 Show() 方法。廣告可能會在每次載入時顯示一次。使用 CanShowAd() 方法驗證廣告是否已準備好顯示。

注意： 插頁式廣告應在應用程式流程中的自然暫停期間顯示，例如遊戲關卡之間或使用者完成工作後。

/// <summary>
/// Shows the interstitial ad.
/// </summary>
public void ShowInterstitialAd()
{
    if (_interstitialAd != null && _interstitialAd.CanShowAd())
    {
        Debug.Log("Showing interstitial ad.");
        _interstitialAd.Show();
    }
    else
    {
        Debug.LogError("Interstitial ad is not ready yet.");
    }
}

監聽插頁式廣告事件

如要進一步自訂廣告行為，您可以鉤住廣告生命週期中的多個事件。如要監聽這些事件，請註冊委派函，如下所示。

private void RegisterEventHandlers(InterstitialAd interstitialAd)
{
    // Raised when the ad is estimated to have earned money.
    interstitialAd.OnAdPaid += (AdValue adValue) =>
    {
        Debug.Log(String.Format("Interstitial ad paid {0} {1}.",
            adValue.Value,
            adValue.CurrencyCode));
    };
    // Raised when an impression is recorded for an ad.
    interstitialAd.OnAdImpressionRecorded += () =>
    {
        Debug.Log("Interstitial ad recorded an impression.");
    };
    // Raised when a click is recorded for an ad.
    interstitialAd.OnAdClicked += () =>
    {
        Debug.Log("Interstitial ad was clicked.");
    };
    // Raised when an ad opened full screen content.
    interstitialAd.OnAdFullScreenContentOpened += () =>
    {
        Debug.Log("Interstitial ad full screen content opened.");
    };
    // Raised when the ad closed full screen content.
    interstitialAd.OnAdFullScreenContentClosed += () =>
    {
        Debug.Log("Interstitial ad full screen content closed.");
    };
    // Raised when the ad failed to open full screen content.
    interstitialAd.OnAdFullScreenContentFailed += (AdError error) =>
    {
        Debug.LogError("Interstitial ad failed to open full screen content " +
                       "with error : " + error);
    };
}

清理插頁式廣告

使用 AdManagerInterstitialAd 完成後，請務必先呼叫 Destroy() 方法，再放棄對它的參照：

_interstitialAd.Destroy();

這會通知外掛程式，該物件已不再使用，因此可以回收該物件所占用的記憶體。未呼叫此方法會導致記憶體流失。

預先載入下一則插頁式廣告

插頁式廣告是一次性物件。也就是說，一旦插頁式廣告顯示，就無法再使用該物件。如要要求其他插頁式廣告，請建立新的 AdManagerInterstitialAd 物件。

如要為下一次曝光機會準備插頁式廣告，請在 OnAdFullScreenContentClosed 或 OnAdFullScreenContentFailed 廣告事件觸發時預先載入插頁式廣告。

private void RegisterReloadHandler(InterstitialAd interstitialAd)
{
    // Raised when the ad closed full screen content.
    interstitialAd.OnAdFullScreenContentClosed += ()
    {
        Debug.Log("Interstitial Ad full screen content closed.");

        // Reload the ad so that we can show another as soon as possible.
        LoadInterstitialAd();
    };
    // Raised when the ad failed to open full screen content.
    interstitialAd.OnAdFullScreenContentFailed += (AdError error) =>
    {
        Debug.LogError("Interstitial ad failed to open full screen content " +
                       "with error : " + error);

        // Reload the ad so that we can show another as soon as possible.
        LoadInterstitialAd();
    };
}

應用程式事件

應用程式事件可讓您建立可將訊息傳送至應用程式程式碼的廣告。應用程式就能根據這些訊息採取行動。

您可以使用 AppEvent 監聽 Ad Manager 專屬的應用程式事件。這些事件可以在廣告生命週期的任何時間點發生，甚至在載入前也行。

namespace GoogleMobileAds.Api.AdManager;

/// The App event message sent from the ad.
public class AppEvent
{
    // Name of the app event.
    string Name;
    // Argument passed from the app event.
    string Value;
}

廣告中發生應用程式事件時，就會觸發 OnAppEventReceived。以下範例說明如何在程式碼中處理這項事件：

_interstitialAd.OnAppEventReceived += (AppEvent args) =>
{
    Debug.Log($"Received app event from the ad: {args.Name}, {args.Value}.");
};

以下範例說明如何根據名稱為 color 的應用程式事件變更應用程式的背景顏色：

_interstitialAd.OnAppEventReceived += (AppEvent args) =>
{
  if (args.Name == "color")
  {
    Color color;
    if (ColorUtility.TryParseColor(arg.Value, out color))
    {
      gameObject.GetComponent<Renderer>().material.color = color;
    }
  }
};

以下是傳送顏色應用程式事件的對應廣告素材：

<html>
<head>
  <script src="//www.gstatic.com/afma/api/v1/google_mobile_app_ads.js"></script>
  <script>
    document.addEventListener("DOMContentLoaded", function() {
      // Send a color=green event when ad loads.
      admob.events.dispatchAppEvent("color", "green");

      document.getElementById("ad").addEventListener("click", function() {
        // Send a color=blue event when ad is clicked.
        admob.events.dispatchAppEvent("color", "blue");
      });
    });
  </script>
  <style>
    #ad {
      width: 320px;
      height: 50px;
      top: 0px;
      left: 0px;
      font-size: 24pt;
      font-weight: bold;
      position: absolute;
      background: black;
      color: white;
      text-align: center;
    }
  </style>
</head>
<body>
  <div id="ad">Carpe diem!</div>
</body>
</html>

最佳做法

判斷插頁式廣告是否適合您的應用程式。

插頁式廣告最適合刊登在具有自然轉換點的應用程式中。使用者在應用程式中完成操作時 (例如分享圖片或遊戲破關)，就會形成這類空檔。請務必考量應用程式流程中的哪個時間點最適合顯示插頁式廣告，以及使用者可能採取的回應方式。

在顯示插頁式廣告時暫停動作。

插頁式廣告有多種型式，例如文字、圖片或影片。請務必確認，當應用程式顯示全螢幕廣告時，也能暫停使用部分資源，讓廣告充分發揮效益。舉例來說，當您呼叫顯示插頁式廣告的函式時，請務必暫停應用程式產生的任何音訊輸出。您可以在使用者與廣告完成互動時叫用 OnAdFullScreenContentClosed() 事件，在該事件中恢復播放音效。此外，建議您在廣告顯示期間暫停任何需要大量運算的作業，例如遊戲迴圈。這可確保使用者不會遇到圖形速度緩慢或無回應，或影片播放不順暢的情況。

不要讓應用程式廣告氾濫。

雖然增加應用程式中插頁式廣告的展示頻率似乎是提高收益的好方法，但這麼做也可能會降低使用者體驗，並降低點閱率。請確保使用者不會經常受到干擾，以免無法順利使用應用程式。

其他資源

• HelloWorld 範例：所有廣告格式的最小實作項目。