使用入门：在 Android 项目中使用 AdMob

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

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

准备工作

如果您还没有 Firebase 项目和 Firebase 应用，请参照 Firebase 入门指南：将 Firebase 添加到您的 Android 项目。
确保您的 Firebase 项目中启用了 Google Analytics（分析）：
- 如果您要创建新的 Firebase 项目，请在项目创建过程中启用 Google Analytics（分析）。
- 如果您已有 Firebase 项目，但未启用 Google Analytics（分析），可以从 >“项目设置”的集成标签页中启用 Google Analytics（分析）。
注意：我们强烈建议将 Firebase SDK for Google Analytics 添加到应用，尽管这并非强制要求。详细了解添加 Firebase SDK for 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 应用输入的软件包名称。您可以在 > 项目设置的“您的应用”卡片中找到 Firebase 应用的软件包名称。

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

在您的应用的 AndroidManifest.xml 文件中，按下文所示添加 <meta-data> 标记，从而添加您的 AdMob 应用 ID。

<manifest>
    <application>
        <!-- Sample AdMob App ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ADMOB_APP_ID"/>
    </application>
</manifest>

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

将 Google 移动广告 SDK 的依赖项添加到应用的模块（应用级）build.gradle 文件中：
```
implementation 'com.google.android.gms:play-services-ads:21.2.0'
```
在加载广告之前，请先调用 MobileAds.initialize() 方法。

此调用会初始化 SDK，并在初始化完成后（或在 30 秒超时后）回调完成监听器。请尽早调用此方法，且仅调用一次，最好是在应用启动时调用。
警告：在调用 MobileAds.initialize() 时，移动广告 SDK 或中介合作伙伴 SDK 可能会预加载广告。如果您需要在加载广告之前执行某项操作，请务必在初始化移动广告 SDK 之前执行。以下是一些在初始化前可能需要执行的操作示例：
- 获得欧洲经济区 (EEA) 用户的同意
- 设置任何特定请求的标志（例如 tagForChildDirectedTreatment 或 tag_for_under_age_of_consent）
如需了解详情，请参阅 AdMob 文档。
在 Activity 中调用 initialize() 方法的示例如下：
Java
```
@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // ...
    MobileAds.initialize(this);
}MainActivity.java
```
Kotlin+KTX
```
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // ...
    MobileAds.initialize(this)
}MainActivity.kt
```

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

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

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

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

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

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

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

添加 Firebase SDK for Google Analytics 后，可使用其他 Firebase 产品优化应用中的广告。
- 借助 Remote Config，您无需发布应用更新就能更改应用的行为和外观，没有任何费用，也没有每日活跃用户数量限制。
- 借助 A/B Testing，您可以测试对应用界面、功能或互动广告系列的更改，以便在广泛实施之前确认这些更改是否确实使关键指标（如收入和留存率）有所改观。