插頁式廣告


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

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

必要條件

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

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

如要載入測試廣告，最簡單的方法是使用插頁式廣告專用的測試廣告單元 ID，這會因裝置平台而異：

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

這類 ID 經過特別設定，可針對每項要求傳回測試廣告。您編寫程式碼、測試及偵錯時，可以在自己的應用程式中自由使用。但請務必留意，在發布應用程式前，將這些 ID 換成您自己的廣告單元 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 執行個體。父項檢視畫面是 JNI jobject 參照 Android 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，請參閱「使用 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() 傳回的 Future 也會發出信號，指出廣告是否已順利顯示。

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

最佳做法

請思考插頁式廣告是否適合您的應用程式。
插頁式廣告最適合有自然轉換點的應用程式。當使用者在應用程式中完成操作 (例如分享圖片或遊戲破關)，就會形成這類轉換點。由於使用者預期動作會中斷，因此很容易在不打斷使用者體驗的情況下，顯示中介層廣告。請務必考量要在應用程式工作流程的哪些轉換點顯示插頁式廣告，以及使用者可能的反應。
顯示插頁式廣告時，請記得暫停動作。
我們提供數種插頁式廣告格式：文字、圖像、影片等。應用程式顯示此類廣告時，請務必暫停使用部分資源，以利廣告放送。舉例來說，呼叫顯示插頁式廣告時，請務必暫停應用程式的任何音訊輸出。您可以在已安裝 FullScreenContentListener 的 OnAdDismissedFullScreenContent 方法中繼續播放音效，使用者與廣告互動完畢後，系統就會叫用該方法。此外，在顯示廣告時，請考慮暫時停止任何需要大量運算的作業 (例如遊戲迴圈)。確保使用者不會遇到圖像緩慢或沒有回應，或是影片斷斷續續的問題。
預留充足的載入時間。
除了務必確認廣告在適當時機顯示，您也必須確保使用者不必等待插頁式廣告載入。打算顯示廣告前先預先載入，可確保應用程式有已完整載入的插頁式廣告，可應要求即時顯示。
不要讓應用程式廣告氾濫。
雖然增加應用程式中的中插廣告頻率，似乎是提高收益的好方法，但這也可能破壞使用者體驗，並降低點擊率。為確保愉快的應用程式操作體驗，請不要頻繁打斷使用者。
請勿使用載入完成的 Future 來顯示插頁式廣告。
這可能會導致使用者體驗不佳。請改為在需要顯示廣告前預先載入廣告。

其他資源

GitHub 中的範例

Mobile Ads Garage 影片教學課程

成功案例

後續步驟