插頁式廣告


插頁式廣告是全螢幕廣告，會覆蓋應用程式的介面，直到使用者關閉為止。這類廣告通常出現在 應用程式的流程，例如活動之間或切換期間 遊戲關卡當應用程式顯示插頁式廣告時，使用者可以選擇輕觸廣告前往到達網頁，或是關閉廣告返回應用程式。個案研究。

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

必要條件

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

建構及測試應用程式時，請務必使用測試廣告，而非實際的正式版廣告。否則可能導致帳戶遭到停權。

如要載入測試廣告，最簡單的方法是使用我們的專屬測試廣告單元 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. 使用父項檢視畫面初始化 InterstitialAd 例項，並將層級轉換為 AdParent 類型。父項檢視畫面是 Android 的 JNI jobject 參照 Activity 或指標，指向 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. 除了將 Future 保留為變數，您也可以在 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，請參閱 使用 Future 監控方法的完成狀態 呼叫。

載入廣告

系統會使用 LoadAd() 方法， InterstitialAd 物件。載入方法需要您先初始化 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 類別才能接收 插頁式廣告顯示和生命週期事件的通知。您的自訂 FullScreenContentListener 子類別可透過 InterstitialAd::SetFullScreenContentListener() 方法， 廣告成功或失敗以及 就會設為關閉

下列程式碼顯示如何擴充類別並指派給廣告：

  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 是一次性物件。也就是說 卻無法再次顯示。最佳做法是載入 在您網頁的 OnAdDismissedFullScreenContent() 方法中 FullScreenContentListener，這樣系統才會在 就會立即刪除

顯示廣告

插頁式廣告應在應用程式流程中的自然暫停期間顯示。例如遊戲關卡之間，或是使用者完成工作後。雖然 FullScreenContentListener 可用於判斷廣告何時顯示全螢幕內容，但 Show() 傳回的 future 也會在廣告成功顯示時發出信號。

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

最佳做法

請考量插頁式廣告是否適合您的應用程式。
插頁式廣告最適合包含自然轉換點的應用程式。使用者在應用程式中完成操作時 (例如分享圖片或遊戲破關)，就會形成這類空檔。由於使用者預期在 您就能輕鬆顯示插頁式廣告，而且不會中斷 無須專人管理請務必考慮在應用程式工作流程中的哪個階段 顯示插頁式廣告以及使用者的回應方式
提醒您，顯示插頁式廣告時應將動作暫停。
插頁式廣告有許多不同類型，包括文字、圖像、影片等。請務必確認應用程式顯示 也會暫時停止使用部分資源，以便讓廣告 善加利用這些原則舉例來說，如果您呼叫以顯示 插頁式廣告，請務必暫停應用程式產生的任何音訊輸出。 您可以透過以下的 OnAdDismissedFullScreenContent 方法繼續播放音效： 已安裝的 FullScreenContentListener，系統會在使用者 與廣告互動完成。此外，請考慮暫時 播放期間任何密集運算作業 (例如遊戲迴圈) 高度。這可確保使用者不會遇到圖像緩慢或無回應，或影片斷斷續續的情況。
請留出充足的載入時間。
同樣重要的是，務必在 並確保使用者不必等待 載入內容在要顯示廣告之前預先載入廣告，可確保應用程式在顯示插頁式廣告時，已完成載入廣告。
不要讓應用程式廣告氾濫。
雖然增加應用程式中插頁式廣告的展示頻率似乎是提高收益的好方法，但這麼做也可能會降低使用者體驗，並降低點閱率。請確保使用者不會經常受到干擾，以免無法順利使用應用程式。
請勿使用載入完成 Future 顯示插頁式廣告。
這可能會導致使用者體驗不佳。請改為在需要顯示廣告時預先載入廣告。

其他資源

GitHub 中的範例

Mobile Ads Garage 影片教學

成功案例

後續步驟