横幅广告

横幅广告会占据应用布局中的一处位置，要么是设备屏幕的顶部，要么是底部。用户与应用互动时，这类广告会停留在屏幕上，并且可在一段时间后自动刷新。如果您是刚开始接触移动广告的新手，横幅广告是您的绝佳选择。案例研究。

前提条件

• 完成使用入门。
• （仅限 Android）熟悉 JNI jobject 引用（请参阅 Android JNI 提示）。

务必用测试广告进行测试

构建和测试应用时，请确保使用测试广告，而不是实际投放的广告。否则，可能会导致您的帐号被暂停。

对于横幅广告，加载测试广告最简便的方法就是使用下面的专用测试广告单元 ID，此 ID 因设备平台而异：

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

这些广告单元 ID 已经过专门配置，可为每个请求返回测试广告，您可以在自己应用的编码、测试和调试过程中随意使用该 ID。只是一定要在发布应用前用您自己的广告单元 ID 替换该测试广告单元 ID。

如需详细了解移动广告 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. 除了将 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 对象代表单个广告请求，并包含定位等信息的属性。

注意 ：如果您的广告加载失败，只要已将广告单元配置为刷新，就无需明确请求再次加载。Google 移动广告 SDK 支持您在 AdMob 界面中指定的任何刷新频率。如果您尚未启用刷新，则需要发出新的请求。

展示广告

最后，通过调用 Show() 在屏幕上展示广告。此方法可能会在广告初始化后随时被调用：

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

广告事件

Google 移动广告 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);

横幅尺寸

下表列出了标准横幅广告尺寸。

尺寸（宽 x 高，以点为单位）	说明	可用性	firebase::gma::AdSize 常量
320x50	横幅	手机和平板电脑	kBanner
320x100	大型横幅广告	手机和平板电脑	kLargeBanner
300x250	IAB 中矩形	手机和平板电脑	kMediumRectangle
468x60	IAB 全尺寸横幅广告	平板电脑	kFullBanner
728x90	IAB 页首横幅广告	平板电脑	kLeaderboard
提供的宽度 x 自适应高度	自适应横幅广告	手机和平板电脑	不适用

自定义广告尺寸

如需定义自定义横幅广告尺寸，请使用包含宽度和高度参数的 firebase::gma::AdSize 构造函数设置所需的尺寸，如下所示：

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

其他资源

GitHub 中的示例

• 查看 GitHub 中示例快速入门应用的源代码。

成功案例

• 使用场景示例。