插頁式廣告

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

插頁式廣告為全螢幕廣告,在應用程式關閉前會一直關閉,直到使用者介面關閉為止。通常在應用程式流程中的自然轉換點顯示,例如在活動之間或遊戲關卡之間的暫停時間。當應用程式顯示插頁式廣告時,使用者可以選擇輕觸廣告前往到達網頁,或是關閉廣告返回應用程式。個案研究

本指南說明如何使用 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 換成自己的廣告單元 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 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 類別,才能接收插頁式廣告顯示和生命週期事件的通知。您的自訂 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 是一次性物件。也就是說,當插頁式廣告顯示時,就無法再次顯示。最佳做法是在 FullScreenContentListenerOnAdDismissedFullScreenContent() 方法中載入另一個插頁式廣告,以便下一個插頁式廣告關閉後立即載入。

顯示廣告

插頁式廣告應在應用程式流程中的自然暫停階段顯示。在遊戲關卡之間 (或是使用者完成任務後) 是很好的範例。雖然 FullScreenContentListener 可用來判斷廣告何時顯示全螢幕內容,但 Show() 傳回的未來也會指出廣告是否成功顯示。

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

最佳做法

請思考插頁式廣告是否為您應用程式的合適的廣告類型。
插頁式廣告在自然轉換點能發揮最佳效果。使用者在應用程式中完成工作 (例如分享圖片或完成遊戲關卡) 時,系統會建立這類的點。由於使用者預期動作會中斷,因此很容易顯示插頁式廣告,避免干擾使用者體驗。請務必考量應用程式工作流程中的哪個階段會放送插頁式廣告,以及使用者可能的反應。
顯示插頁式廣告時,別忘了暫停動作。
插頁式廣告有許多類型:文字、圖像、影片等等。請務必確認當應用程式顯示插頁式廣告時,也會暫停使用某些資源,讓廣告能受益。例如,當您呼叫顯示插頁式廣告時,請務必暫停應用程式產生的任何音訊輸出。您可以在已安裝的 FullScreenContentListenerOnAdDismissedFullScreenContent 方法中繼續播放音效,當使用者完成與廣告互動時,系統便會叫用這些音效。此外,請考慮在廣告顯示時暫時暫停任何密集運算工作 (例如遊戲迴圈)。如此可確保使用者不會遇到速度緩慢或無反應的圖像或斷斷續續的影片。
提供適當的載入時間。
務必確保在適當時機顯示插頁式廣告也很重要,而且使用者不必等待廣告載入完畢也很重要。在使用者有意顯示廣告之前就先預先載入廣告,這樣當應用程式顯示時,應用程式就能即時載入已載入的插頁式廣告。
不要讓應用程式廣告氾濫。
雖然提高應用程式內插頁式廣告的展示頻率,似乎是提高收益的好方法,但也可能降低使用者體驗並降低點閱率。請確保使用者不會經常受到干擾,以免他們無法再使用您的應用程式。
日後切勿使用載入完成。
這會造成使用者體驗不佳。而是在預先載入之前先預先載入廣告。

其他資源

GitHub 中的範例

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

成功案例

後續步驟