橫幅廣告

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

橫幅廣告佔據應用程式版面配置頂端或底部的位置,當使用者與應用程式互動時,畫面上將持續顯示在螢幕上,而且一段時間後會重新整理。如果你剛開始使用行動廣告,不妨從這裡著手著手。 個案研究

必要條件

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

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

建構及測試應用程式時,請務必使用測試廣告,而非即時正式版的廣告。否則我們可能會將您的帳戶停權。

載入測試廣告最簡單的方法,就是使用橫幅廣告專用的測試用廣告單元 ID,可能會因裝置平台而異:

  • Android:ca-app-pub-3940256099942544/6300978111
  • iOS:ca-app-pub-3940256099942544/2934735716

這類廣告單元 ID 經過特別設定,可針對每個要求傳回測試廣告,而您可以在編寫、測試及偵錯程式碼時,在自己的應用程式中自由使用這些廣告單元 ID。發布應用程式前,請務必將其改成自己的廣告單元 ID。

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

實作

設定 AdView

橫幅廣告會顯示在 AdView 物件中,因此整合橫幅廣告的第一步是建立和定位 AdView

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

     #include "firebase/gma/ad_view.h"
    
  2. 宣告及執行個體化 AdView 物件:

      firebase::gma::AdView* ad_view;
      ad_view = new firebase::gma::AdView();
    
  3. 建立 AdSize,並使用 AdParent 父項檢視畫面初始化廣告檢視畫面。上層檢視是對 Android Activity 的 JNI jobject 參照,或指向 AdParent 類型的 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(my_ad_parent);
     firebase::Future result =
       ad_view->Initialize(ad_parent, kBannerAdUnit, firebase::gma::AdSize::kBanner);
    
  4. 除了保留未來做為變數之外,您也可以定期使用 AdView 物件上的 InitializeLastResult(),來檢查初始化作業的狀態。這有助於追蹤全域遊戲迴圈中的初始化程序。

      // Monitor the status of the future in your game loop:
      firebase::Future<void> result = ad_view->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.
      }
    
  5. 如要進一步瞭解如何使用 firebase::Future,請參閱使用 Futures 監控方法呼叫的完成狀態

設定廣告的位置

在初始化後,您可以隨時設定 AdView 的位置:

firebase::Future<void> result = ad_view->SetPosition(firebase::gma::AdView::kPositionTop);

載入廣告

AdView 初始化後,您就可以載入廣告:

firebase::gma::AdRequest ad_request;
firebase::Future<firebase::gma::AdResult> load_ad_result = ad_view->LoadAd(my_ad_request);

AdRequest 物件代表單一廣告請求,並且包含指定目標等資訊。

顯示廣告

最後,呼叫 Show() 在螢幕上放送廣告。廣告初始化之後,您可以隨時叫用此方法:

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

廣告事件

Google Mobile Ads C++ SDK 提供 AdListener 類別,您可以擴充並傳送至 AdView::SetListener(),以便在廣告檢視狀態有異動時接收通知。

AdListener 中的擴充方法為選擇性,因此您只需實作所需的方法。以下是擴充所有 AdListener 方法類別的類別實作範例:

class ExampleAdListener
    : public firebase::gma::AdListener {
 public:
  ExampleAdListener() {}
  void OnAdClicked() override {
    // This method is invoked when the user clicks the ad.
  }

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

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

  void OnAdOpened() override {
    // This method is invoked when an ad opens an overlay that covers the screen.
  }
};

ExampleAdListener* ad_listener = new ExampleAdListener();
ad_view->SetAdListener(ad_listener);

下表列出標準橫幅廣告大小。

起始點大小 (WxH) 說明 可用性 firebase::gma::AdSize 常數
320 x 50 橫幅 手機和平板電腦 kBanner
320x100 大型橫幅 手機和平板電腦 kLargeBanner
300 x 250 IAB 中矩形廣告 手機和平板電腦 kMediumRectangle
468x60 IAB 完整橫幅廣告 平板電腦 kFullBanner
728x90 IAB 排行榜 平板電腦 kLeaderboard
提供的寬度 x 自動調整高度 自動調整橫幅廣告 手機和平板電腦 不適用

自訂廣告大小

如要定義自訂橫幅大小,請使用含有寬度和高度參數的 firebase::gma::AdSize 建構函式設定所需維度,如下所示:

firebase::gma::AdSize ad_size(/*width=*/320, /*height=*/50);

其他資源

GitHub 中的範例

成功案例