插頁式廣告

插頁式廣告是全螢幕廣告，會蓋住應用程式介面，直到使用者關閉為止。通常會顯示在應用程式流程中的自然轉換點 (例如操作後的空檔或遊戲關卡之間的暫停時間)。應用程式顯示插頁式廣告時，使用者可選擇輕觸廣告前往到達網頁，或是關閉廣告返回應用程式。個案研究

本指南說明如何使用 Google Mobile Ads C++ SDK 將插頁式廣告整合至 Android 和 iOS 應用程式。

必要條件

  • 完成「開始使用」。
  • (僅限 Android) 熟悉 JNI jobject 參照 (請參閱 Android JNI 提示)。

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

打造及測試應用程式時，請務必使用測試廣告，而非實際的廣告。否則帳戶可能會遭到停權。

如要載入測試廣告，最簡單的方法是使用專用的測試廣告單元 ID，以便隨裝置平台而異：

  • Android：ca-app-pub-3940256099942544/1033173712
  • iOS：ca-app-pub-3940256099942544/4411468910

這些變數經過特別設定，可針對每項要求傳回測試廣告，您可以在程式設計、測試及偵錯時，自由在應用程式中使用。請務必先將應用程式替換成自己的廣告單元 ID，再發布應用程式。

如要進一步瞭解 Mobile Ads SDK 的測試廣告的運作方式，請參閱測試廣告一文。

實作中

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

  1. 載入廣告。
  2. 註冊回呼。
  3. 顯示廣告並處理其生命週期事件。

設定InterstitialAd

插頁式廣告會顯示在 InterstitialAd 物件中，因此如果想將插頁式廣告整合至應用程式，首先必須建立並初始化 InterstitialAd 物件。

  1. 在應用程式的 C++ 程式碼中加入下列標頭： 

     #include "firebase/gma/interstial_ad.h"

  2. 宣告並執行個體化 InterstitialAd 物件： 

     firebase::gma::InterstitialAd* interstitial_ad;
 interstitial_ad = new firebase::gma::InterstitialAd();

  3. 使用父項檢視畫面將 AdParent 類型初始化為 InterstitialAd 執行個體。父項檢視畫面是 Android Activity 的 JNI jobject 參照，或 iOS UIView 的指標。

    // my_ad_parent is a jobject reference to an Android Activity or
// a pointer to an iOS UIView.
firebase::gma::AdParent ad_parent =
  static_cast<firebase::gma::AdParent>(my_ad_parent);
firebase::Future<void> result = interstitial_ad->Initialize(ad_parent);

  4. 除了保留未來的變數之外，您可以定期對 InterstitialAd 物件叫用 InitializeLastResult()，定期檢查初始化作業的狀態。這可協助您追蹤全域遊戲迴圈中的初始化程序。

    // Monitor the status of the future in your game loop:
firebase::Future<void> result = interstitial_ad->InitializeLastResult();
if (result.status() == firebase::kFutureStatusComplete) {
  // Initialization completed.
  if(future.error() == firebase::gma::kAdErrorCodeNone) {
    // Initialization successful.
  } else {
    // An error has occurred.
  }
} else {
  // Initialization on-going.
}

如要進一步瞭解如何使用 firebase::Future，請參閱「使用 Futures 監控方法呼叫的完成狀態」一文。

載入廣告

您可以使用 InterstitialAd 物件的 LoadAd() 方法載入廣告。如要使用載入方法，您必須初始化 InterstitialAd 物件，並擁有廣告單元 ID 和 AdRequest 物件。系統會傳回 firebase::Future，讓您監控載入作業的狀態和結果。

下列程式碼顯示如何在 InterstitialAd 成功初始化後載入廣告：

firebase::gma::AdRequest ad_request;
firebase::Future<firebase::gma::AdResult> load_ad_result;
load_ad_result = interstitial_ad->LoadAd(interstitial_ad_unit_id, ad_request);

註冊回呼

您必須擴充 FullScreenContentListener 類別，才能接收插頁式廣告簡報和生命週期事件的通知。您可以透過 InterstitialAd::SetFullScreenContentListener() 方法登錄自訂 FullScreenContentListener 子類別，並在廣告成功或失敗時收到回呼，以及關閉時會收到回呼。

下列程式碼說明瞭如何擴充類別並指派給廣告：

  class ExampleFullScreenContentListener
      : public firebase::gma::FullScreenContentListener {

   public:
    ExampleFullScreenContentListener() {}

    void OnAdClicked() override {
      // This method is invoked when the user clicks the ad.
    }

    void OnAdDismissedFullScreenContent() override {
     // This method is invoked when the ad dismisses full screen content.
    }

    void OnAdFailedToShowFullScreenContent(const AdError& error) override {
      // This method is invoked when the ad failed to show full screen content.
      // Details about the error are contained within the AdError parameter.
    }

    void OnAdImpression() override {
      // This method is invoked when an impression is recorded for an ad.
    }

    void OnAdShowedFullScreenContent() override {
      // This method is invoked when the ad showed its full screen content.
    }
  };

  ExampleFullScreenContentListener* full_screen_content_listener =
    new ExampleFullScreenContentListener();
  interstitial_ad->SetFullScreenContentListener(full_screen_content_listener);

InterstitialAd 是一次性物件。這表示插頁式廣告在顯示後就無法再次顯示。最佳做法是在 FullScreenContentListener 的 OnAdDismissedFullScreenContent() 方法中載入其他插頁式廣告，讓下一個插頁式廣告在不久後關閉時開始載入。

顯示廣告

在應用程式流程的自然暫停期間顯示插頁式廣告。建議在遊戲關卡之間或使用者完成任務後顯示。雖然 FullScreenContentListener 可用來判斷廣告何時以全螢幕顯示，而 Show() 傳回的未來也會在廣告成功顯示時表示信號。

  firebase::Future<void> result = interstitial_ad->Show();

最佳做法

思考插頁式廣告是否適合您的應用程式。
插頁式廣告最適合在自然轉換點的應用程式使用，應用程式內的工作結束時 (例如分享圖片或完成遊戲關卡)，就會產生這個點。由於使用者期望在操作期間受到中斷，因此您可以輕鬆顯示插頁式廣告，而不會影響使用體驗。請務必在應用程式工作流程的哪些階段顯示插頁式廣告，以及使用者可能採取的回應方式。
因此在顯示插頁式廣告時，請務必暫停這項操作。
插頁式廣告分為多種類型：文字、圖片、影片等。請務必確認應用程式顯示插頁式廣告時，也會暫停使用部分資源，廣告才能發揮這些資源的最大效益。舉例來說，當您呼叫顯示插頁式廣告的廣告，請務必暫停應用程式產生的任何音訊輸出。您可以在已安裝 FullScreenContentListener 的 OnAdDismissedFullScreenContent 方法中繼續播放音訊，在使用者與廣告互動後叫用。此外，廣告放送時，建議您暫時停止任何密集的運算工作 (例如遊戲迴圈)。這樣做可確保使用者不會發生轉譯速度緩慢或沒有回應的影像或影片閃爍的問題。
預留足夠的載入時間。
確保廣告在適當時機顯示插頁式廣告十分重要，因此請務必確保使用者不必等待廣告載入完畢。建議您在打算顯示廣告前，先載入廣告，以確保應用程式在顯示時能完整載入插頁式廣告。
不要讓應用程式廣告氾濫。
提高應用程式內插頁式廣告的頻率似乎有助於提高收益，但也可能降低使用者體驗並降低點閱率。請確保使用者不會經常乾擾服務，以免他們無法繼續使用應用程式。
不要使用日後完成載入流程來顯示插頁式廣告。
這可能會導致使用者體驗不佳。而是在顯示之前預先載入廣告。

其他資源

GitHub 中的範例

行動廣告指南影片教學課程

成功案例

後續步驟