开始使用

本指南适用于希望借助 AdMob 通过 C++ 应用创收，但不使用 Firebase 的发布商。如果您打算或考虑在应用中添加 Firebase，请改为参阅本指南的 AdMob 与 Firebase 版本。

要展示广告并赚取收入，第一步是将 Google 移动广告 C++ SDK 集成到应用中。集成 SDK 后，您可以选择一种广告格式（例如插页式广告或激励广告），然后按照相应步骤进行实现。

Google 移动广告 C++ SDK 封装了 Google 移动广告 iOS 和 Android SDK，并且仅适用于这些平台。Google 移动广告 C++ SDK 使用 Firebase C++ 结构来支持异步操作，因此它位于 firebase::gma 命名空间中。

如果这是您首次依据本指南进行操作，我们建议您下载 Google 移动广告 C++ 测试应用并按照说明操作。

前提条件

在您的 AdMob 账号中设置应用

完成以下步骤，将您的应用注册为 AdMob 应用：

1. 登录或注册 AdMob 账号。

2. 在 AdMob 中注册您的应用。此步骤将创建一个具有唯一 AdMob 应用 ID 的 AdMob 应用，本指南稍后需要用到此 ID。

安装 Google 移动广告 C++ SDK

由于 Google 移动广告 C++ SDK 位于 firebase::gma 命名空间中，因此请下载 Firebase C++ SDK，然后将其解压缩到您选择的目录中。

Firebase C++ SDK 并不局限于特定平台，但需要配置平台专用库。

您已准备就绪！您的 C++ 应用已配置为使用 Google 移动广告 C++ SDK，而不使用任何其他 Firebase 服务。

配置应用的 AdMob 应用 ID

初始化 Google 移动广告 SDK

加载广告之前，请先调用 firebase::gma::Initialize()，以便让应用初始化 Google 移动广告 C++ SDK。该方法将初始化相应 SDK，并在初始化完成后或 30 秒超时后完成 firebase::Future。此操作仅需执行一次，最好是在应用启动时执行。

在调用 Initialize() 时，Google 移动广告 C++ SDK 或中介合作伙伴 SDK 可能会预加载广告。如果您需要获得欧洲经济区 (EEA) 用户的同意，请设置任何专门用于特定请求的标记（例如 tag_for_child_directed_treatment 或 tag_for_under_age_of_consent），或者在加载广告之前采取任何其他相关操作，并确保在初始化 Google 移动广告 C++ SDK 之前先调用 firebase::gma::SetRequestConfiguration()。如需了解详情，请参阅我们的定位指南。

以下示例展示了如何调用 Initialize()：

// Initialize the Google Mobile Ads library
firebase::InitResult result;
Future<AdapterInitializationStatus> future =
  firebase::gma::Initialize(jni_env, j_activity, &result);

if (result != kInitResultSuccess) {
  // Initialization immediately failed, most likely due to a missing
  // dependency. Check the device logs for more information.
  return;
}

// Monitor the status of the future.
// See "Use a Future to monitor the completion status of a method call" below.
if (future.status() == firebase::kFutureStatusComplete &&
    future.error() == firebase::gma::kAdErrorCodeNone) {
  // Initialization completed.
} else {
  // Initialization on-going, or an error has occurred.
}

// Initialize the Google Mobile Ads library.
firebase::InitResult result;
Future<AdapterInitializationStatus> future =
  firebase::gma::Initialize(&result);

if (result != kInitResultSuccess) {
  // Initialization immediately failed, most likely due to a missing
  // dependency. Check the device logs for more information.
  return;
}

// Monitor the status of the future.
// See "Use a Future to monitor the completion status of a method call" below.
if (future.status() == firebase::kFutureStatusComplete &&
    future.error() == firebase::gma::kAdErrorCodeNone) {
  // Initialization completed.
} else {
  // Initialization on-going, or an error has occurred.
}

使用 Future 监控方法调用的完成状态

Future 提供了一种方法来确定异步方法调用的完成状态。

例如，当您的应用调用 firebase::gma::Initialize() 时，系统会创建并返回一个新的 firebase::Future。然后，您的应用就可以轮询 Future 的 status()，以确定初始化是否已完成。完成后，您的应用便可以调用 result() 来获取生成的 AdapterInitializationStatus。

返回 Future 的方法都有一个对应的“last result”（上次结果）方法，应用可以使用这一方法来获取给定操作的最新 Future。例如，firebase::gma::Initialize() 有一个名为 firebase::gma::InitializeLastResult() 的对应方法，该方法会返回一个 Future，您的应用可以用其来检查上次调用 firebase::gma::Initialize() 的状态。

如果 Future 的状态为已完成，且其错误代码为 firebase::gma::kAdErrorCodeNone，则表示操作成功完成。

您还可以注册当 Future 变成已完成状态时要调用的回调函数。在某些情况下，回调函数会在不同的线程中运行，因此请确保您的代码具有线程安全性。以下代码段使用了一个函数指针来实现回调：

// Registers the OnCompletion callback. user_data is a pointer that is passed verbatim
// to the callback as a void*. This allows you to pass any custom data to the callback
// handler. In this case, the app has no data, so you must pass nullptr.
firebase::gma::InitializeLastResult().OnCompletion(OnCompletionCallback,
  /*user_data=*/nullptr);

// The OnCompletion callback function.
static void OnCompletionCallback(
  const firebase::Future<AdapterInitializationStatus>& future, void* user_data) {
  // Called when the Future is completed for the last call to firebase::gma::Initialize().
  // If the error code is firebase::gma::kAdErrorCodeNone,
  // then the SDK has been successfully initialized.
  if (future.error() == firebase::gma::kAdErrorCodeNone) {
    // success!
  } else {
    // failure.
  }
}

选择广告格式

现已导入 Google 移动广告 C++ SDK，您随时可以植入广告了。AdMob 提供了许多不同的广告格式，您可以根据您应用的用户体验选择最契合的一款。

横幅

横幅广告是在设备屏幕的顶部或底部展示的矩形广告。用户与应用互动时，横幅广告会停留在界面上，并且可在一段时间后自动刷新。如果您刚开始接触移动广告，建议从横幅广告着手。

植入横幅广告

插页式广告

插页式广告是全屏广告，它会覆盖整个应用界面，直到用户将其关闭。在应用执行流程的自然停顿点，例如游戏的不同关卡之间，或一项任务完成后，最适合投放这类广告。

植入插页式广告

激励广告

向观看短视频和与试玩广告及问卷调查互动的用户予以奖励的广告。该广告可供免费畅玩的应用创收。

植入激励广告