插頁式廣告


插頁式廣告是全螢幕廣告，會覆蓋應用程式介面，直到 使用者關閉的內容這類廣告通常出現在 應用程式的流程，例如活動之間或暫停期間 遊戲關卡使用者可選擇在應用程式顯示插頁式廣告時 讓使用者輕觸廣告前往到達網頁，或關閉廣告並返回 加入 App Engine 應用程式 個案研究。

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

先備知識

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

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

要載入測試廣告，最簡單的方法是使用我們專屬的測試廣告單元編號。 插頁式廣告，因裝置平台而異：

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

已設定為針對每次請求傳回測試廣告 您可以在自己的應用程式中自由使用這項 API，編寫程式碼、進行測試及偵錯。 發布廣告素材前，請務必用自己的廣告單元 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() 傳回的未來也會發出信號 廣告成功顯示時。

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

最佳做法

請思考插頁式廣告是否適合您應用程式的廣告類型。
插頁式廣告最適合包含自然轉換點的應用程式。 應用程式內的工作結尾，例如分享圖片或完成遊戲 則會建立這類點由於使用者預期在 您就能輕鬆顯示插頁式廣告，而且不會中斷 無須專人管理請務必考慮在應用程式工作流程中的哪個階段 顯示插頁式廣告以及使用者的回應方式
提醒您，顯示插頁式廣告時應將動作暫停。
插頁式廣告分成幾種不同類型的插頁式廣告：文字、圖像、 影片等。請務必確認應用程式顯示 也會暫停使用部分資源，以便讓廣告 善加利用這些原則舉例來說，如果您呼叫以顯示 插頁式廣告，請務必暫停應用程式產生的任何音訊輸出。 您可以透過以下的 OnAdDismissedFullScreenContent 方法繼續播放音效： 已安裝的 FullScreenContentListener，系統會在使用者 與廣告互動完成。此外，請考慮暫時 播放期間任何密集運算作業 (例如遊戲迴圈) 高度。確保使用者不會遇到 無回應圖像或影片延遲。
提供足夠的載入時間。
同樣重要的是，務必在 並確保使用者不必等待 載入內容請提早 載入廣告 您應用程式當時已完全載入的插頁式廣告 。
不要讓應用程式廣告氾濫。
雖然增加應用程式內插頁式廣告的顯示頻率， 不但有助於增加收益，也可能損及使用者體驗 導致點閱率降低確認使用者不常使用 幹擾，無法繼續享受您的應用程式。
請不要利用載入完成的未來顯示插頁式廣告。
這會對使用者體驗造成負面影響。請在 表示需要出示的標誌

其他資源

GitHub 中的範例

行動廣告車庫教學影片

成功案例

後續步驟