在您的 Android 项目中开始使用 AdMob

本快速入门指南适用于希望使用 AdMob 通过使用 Firebase 构建的应用获利的发布商和开发人员。如果您不打算在您的应用中包含 Firebase，请访问独立的 AdMob 指南。

如果您还没有，请了解结合使用 AdMob、Firebase 和 Google Analytics 的所有好处。

在你开始之前

如果您还没有 Firebase 项目和 Firebase 应用程序，请遵循 Firebase 入门指南：将 Firebase 添加到您的 Android 项目。
确保在您的 Firebase 项目中启用了 Google Analytics：
- 如果您要创建新的 Firebase 项目，请在项目创建工作流程中启用 Google Analytics。
- 如果您有一个未启用 Google Analytics 的现有 Firebase 项目，您可以从您的 >项目设置的Integrations选项卡中启用 Google Analytics。
注意：将适用于 Google Analytics 的 Firebase SDK 添加到您的应用程序是可选的，但强烈建议您这样做。详细了解为 Google Analytics 添加 Firebase SDK 的好处。

第 1 步：在您的 AdMob 帐户中设置您的应用

将您的应用程序注册为 AdMob 应用程序。
1. 登录或注册AdMob 帐户。
2. 向 AdMob 注册您的应用程序。此步骤会创建一个具有唯一AdMob 应用程序 ID的 AdMob 应用程序，您将在本指南的后面部分用到它。
系统会要求您将移动广告 SDK 添加到您的应用中。在本指南的后面部分找到有关此任务的详细说明。
将您的 AdMob 应用链接到您的 Firebase 应用。
此步骤是可选的，但强烈推荐。详细了解启用用户指标并将您的 AdMob 应用关联到 Firebase 的好处。
在您的 AdMob 帐户的应用信息中心中完成以下两个步骤：
1. 启用用户指标以允许 AdMob 处理和显示您的 AdMob 帐户中的精选分析数据。这也是将 AdMob 应用链接到 Firebase 的必要设置。
2. 将您的 AdMob 应用链接到您现有的 Firebase 项目和 Firebase 应用。
  请确保您输入的包名称与您为 Firebase 应用输入的包名称相同。在您的 >项目设置的您的应用卡中找到您的 Firebase 应用程序包名称。

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

通过添加<meta-data>标记，将您的AdMob 应用 ID添加到应用的AndroidManifest.xml文件中，如下所示。

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

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

初始化后，移动广告 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事件数据。
要了解更多信息，请访问将Google Analytics 和 Firebase 与 AdMob 应用程序结合使用的指南。
在您的应用中使用其他 Firebase 产品
添加适用于 Google Analytics 的 Firebase SDK 后，使用其他 Firebase 产品优化应用中的广告。
- Remote Config使您能够更改应用程序的行为和外观，而无需为无限制的每日活跃用户免费发布应用程序更新。
- A/B 测试使您能够测试对应用的 UI、功能或参与活动的更改，以了解它们是否会对您的关键指标（如收入和保留率）产生影响，然后再广泛推广这些更改。