橫幅廣告

橫幅廣告會刊登在應用程式版面的頂端或底部 裝置畫面上在使用者與應用程式互動時，這類廣告會持續顯示在畫面上， 且會在一段特定時間過後自動重新整理如果您是初次使用 行動廣告都是很好的起點 個案研究。

必要條件

• 完成開始使用。
• (僅限 Android) 熟悉使用 JNI jobject 參照 (請參閱 Android JNI 提示)。

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

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

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

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

這些廣告單元 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 參照 或指向 iOS UIView 的指標，並轉換成 AdParent 類型：

    // 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 result =
      ad_view->Initialize(ad_parent, kBannerAdUnit, firebase::gma::AdSize::kBanner);

4. 除了保留 Future 做為變數以外，您可以 透過叫用以下指令，定期檢查初始化作業的狀態 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，請參閱 使用 Future 監控方法的完成狀態 呼叫。

設定廣告位置

您可以在 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);

橫幅廣告大小

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

自訂廣告大小

如要定義自訂橫幅廣告大小，請使用 firebase::gma::AdSize敬上 使用寬度和高度參數的建構函式，如下所示：

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

其他資源

GitHub 中的範例

• 查看 快速入門導覽課程應用程式範例 。

成功案例

• 應用實例。