开始在 iOS 项目中使用 AdMob

本快速入门指南适用于想要使用 AdMob 通过由 Firebase 构建的应用获利的发布商和开发者。如果您不打算在应用中添加 Firebase，请参阅单独的 AdMob 指南。

了解搭配使用 AdMob、Firebase 和 Google Analytics（分析）的优势（如果您尚不了解）。

准备工作

如果您还没有 Firebase 项目和 Firebase 应用，请按照 Firebase 入门指南将 Firebase 添加到您的 iOS 项目执行操作。
确保您的 Firebase 项目中启用了 Google Analytics（分析）：
- 如果您要创建新的 Firebase 项目，请在项目创建工作流期间启用 Google Analytics（分析）。
- 如果您已有 Firebase 项目，但未启用 Google Analytics（分析），则可以从 >“项目设置”的集成标签页中启用 Google Analytics（分析）。
  
  您可以在集成标签页中将 2019 年 7 月 31 日之前创建的 Firebase 项目免费升级，以享受完整的 Google Analytics（分析）体验。此升级不是强制要求的，但建议执行。

第 1 步：在 AdMob 帐号中设置应用

将应用注册为 AdMob 应用。
1. 登录或注册 AdMob 帐号。
2. 在 AdMob 中注册您的应用。此步骤将创建一个具有唯一 AdMob 应用 ID 的 AdMob 应用，本指南稍后将用到此 ID。
系统会要求您将移动广告 SDK 添加到您的应用中。如需详细了解此任务，请参阅本指南的后面部分。
将您的 AdMob 应用关联到您的 Firebase 应用。

这不是强制执行的步骤，但我们强烈建议您执行此操作。详细了解启用用户指标以及将 AdMob 应用关联到 Firebase 的优势。

在您的 AdMob 帐号的“应用”信息中心内完成以下两个步骤：
1. 启用用户指标，以允许 AdMob 处理特选分析数据并在您的 AdMob 帐号中显示。将您的 AdMob 应用关联到 Firebase 也是一项必需设置。
2. 将您的 AdMob 应用关联到您现有的 Firebase 项目和 Firebase 应用。
  
  请务必输入您为 Firebase 应用输入的软件包 ID。您可以在 > 项目设置的“您的应用”卡片中找到 Firebase 应用的软件包 ID。

第 2 步：将 AdMob 应用 ID 添加到 `Info.plist` 文件中

在应用的 Info.plist 文件中，添加一个 GADApplicationIdentifier 键，其值为字符串形式的 AdMob 应用 ID。

您可以通过编程方式进行此项更改：

<!-- Sample AdMob App ID: ca-app-pub-3940256099942544~1458002511 -->
<key>GADApplicationIdentifier</key>
<string>ADMOB_APP_ID</string>

您也可以在属性列表编辑器中进行修改：

属性列表编辑器

第 3 步：添加并初始化移动广告 SDK

将 Google Mobile Ads SDK 的依赖项添加到项目的 Podfile 中：
```
pod 'Google-Mobile-Ads-SDK'
```
在加载广告之前，请在 GADMobileAds.sharedInstance 上调用 startWithCompletionHandler: 方法。

此调用会初始化 SDK，并在初始化完成后（或在 30 秒超时后）回调完成处理程序。请尽早调用此方法，且仅调用一次，最好是在应用启动时、初始化 Firebase 之后。
警告：在调用 startWithCompletionHandler: 时，移动广告 SDK 或中介合作伙伴 SDK 可能会预加载广告。如果您需要在加载广告之前执行某项操作，请务必在初始化移动广告 SDK 之前执行此操作。以下是一些在初始化前可能需要执行的操作示例：
- 获得欧洲经济区 (EEA) 用户的同意
- 设置任何特定请求的标志（例如 tagForChildDirectedTreatment 或 tag_for_under_age_of_consent）
如需了解详情，请参阅 AdMob 文档。
以下示例演示了如何在 AppDelegate 中调用 startWithCompletionHandler: 方法：
Swift
```
import Firebase
import GoogleMobileAds
...

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  var window: UIWindow?

  func application(_ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    // Use Firebase library to configure APIs.
    FirebaseApp.configure()

    // Initialize the Google Mobile Ads SDK.
    GADMobileAds.sharedInstance().start(completionHandler: nil)

    return true
  }

}
```
Objective-C
```
@import Firebase;
@import GoogleMobileAds;
...

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  // Use Firebase library to configure APIs.
  [FIRApp configure];
  // Initialize the Google Mobile Ads SDK.
  [[GADMobileAds sharedInstance] startWithCompletionHandler:nil];
  return YES;
}

@end
```

第 4 步：查看用户指标和分析数据

初始化后，Mobile Ads SDK 会自动开始记录您应用中的分析事件和用户属性。您无需向应用添加任何其他代码或实现任何广告即可查看这些数据。您可以在以下位置查看这些分析数据：

在您的 AdMob 帐号（“首页”或“应用”信息中心）的“用户指标”卡片中，您可以查看根据所收集的分析数据（例如平均会话时长、ARPU 和留存率）生成的特选用户指标。
在 Firebase 控制台的 Analytics（分析）信息中心中，您可以查看汇总统计信息和关键指标摘要。如果您添加支持 Google Analytics（分析）的 Firebase SDK，还可以在 Firebase 控制台中为广告系列标记转化，并创建自定义受众群体。

请注意，在对 ARPU 和 ARPPU 指标进行收入计算时，为了更好地表示这些指标，您可能需要添加名为 ecommerce_purchase 的分析自定义事件中的数据（了解如何操作）。

第 5 步：（可选）使用 Google Analytics（分析）和 Firebase 的更多功能

充分利用更多机会和功能，提高应用获利和用户互动度：

添加和使用支持 Google Analytics（分析）的 Firebase SDK
- 在应用中实现自定义事件日志记录。
- 为自定义广告系列标记转化。
- 在针对 ARPU 和 ARPPU 指标进行收入计算时添加 ecommerce_purchase 事件数据。
在应用中使用其他 Firebase 产品

添加支持 Google Analytics（分析）的 Firebase SDK 后，请使用其他 Firebase 产品优化应用中的广告。
- 借助 Remote Config，您无需发布应用更新就能更改应用的行为和外观，没有任何费用，亦无每日活跃用户数量限制。
- 借助 A/B Testing，您可以测试对应用界面、功能或互动广告系列的更改，以便在广泛实施之前确认这些更改是否确实使关键指标（如收入和留存率）有所改观。
- Predictions 会将机器学习应用于您的分析数据，从而根据预测的用户行为创建动态用户细分。这些预测可供其他 Firebase 产品使用。