橫幅廣告

橫幅廣告會顯示在應用程式版面配置中的某個位置，位於裝置螢幕的頂端或底部。當使用者與應用程式互動時，這類畫面會持續顯示，並在一段特定時間後自動重新整理。如果您不熟悉行動廣告，建議從下方著手。個案研究：

必要條件

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

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

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

載入測試廣告的最簡單方法，就是使用針對橫幅廣告的專用測試廣告單元 ID，這個 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 物件代表單一廣告請求，其中包含指定目標等資訊。

注意： 如果廣告無法載入，您不必將廣告單元設為重新整理，就不需要明確請求另一項請求。Google Mobile Ads SDK 會遵循您在 AdMob UI 中指定的任何重新整理頻率。如果您尚未啟用重新整理功能，就必須發出新的要求。

顯示廣告

最後，呼叫 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 中的範例

• 在 GitHub 中查看範例快速入門導覽課程應用程式的原始碼。

成功案例

• 使用範例。