针对移动应用的 Google Analytics（分析）

若要获取 Google Analytics（分析）中最新的移动应用报告功能，请在您的 Android 和 iOS 应用中使用 Firebase。在您的应用中启用 Google Analytics（分析）后，它就会自动收集和报告内置的事件和用户属性。您还可以记录自定义事件和设置自定义用户属性。

针对移动应用的跟踪代码管理器通过 Firebase SDK 完成实现，并且需要创建一个跟踪代码管理器容器。Google Analytics（分析）事件、参数和用户属性均可用作跟踪代码管理器内的配置输入。

结合使用跟踪代码管理器、Firebase 和 Google Analytics（分析）

使用 Firebase 的应用会自动将信息记录到 Google Analytics（分析）中。Firebase SDK 中的 Google Analytics for Firebase 服务会自动为您收集应用使用情况数据。报告将显示在 Google Analytics（分析）以及 Firebase 控制台中。只要您已经使用 Firebase SDK，则无需添加任何额外的代码即可启用自动收集的事件。

如果需要配置其他 Google 代码和第三方代码，请将跟踪代码管理器添加到支持 Firebase 的应用中。

若要为您的移动项目实现跟踪代码管理器，请执行以下步骤：

1. 为您的应用设置 Firebase：
   • 安装 Firebase SDK（Android | iOS）。
   • 在 Firebase 控制台中，将您的应用添加到 Firebase 项目中。
   • 将 Firebase Analytics 添加到您的应用中 (Android | iOS)。
2. 创建跟踪代码管理器帐号并配置跟踪代码管理器容器。
3. 将跟踪代码管理器添加到您的项目中 (Android | iOS)。

使用带有“事件名称”和“事件参数”变量的触发器来指定哪些事件应触发特定代码。无论何时在应用中记录事件，都会对触发条件进行求值。如需了解详情，请参阅跟踪代码管理器开发者文档（Android 版和 iOS 版）。

自动收集的事件如果由 Firebase SDK 生成并由 Google Analytics（分析）收集，则无法修改。

创建 Google Analytics (Firebase) 代码

若要创建 Google Analytics (Firebase) 代码，请执行以下操作：

1. 为 Android 或 iOS 应用创建 Google Analytics for Firebase 容器。
2. 依次点击代码 新建。
3. 点击代码配置，然后选择 Google Analytics (Firebase)。
4. 使用操作菜单来修改、添加或屏蔽事件。
   • 屏蔽事件：此选项可让您屏蔽人工记录的事件。例如，您可以在下列情况下使用此选项：开发人员意外记录了重复的事件，记录了不应记录的某个对象的事件，或记录了过多的唯一身份事件名称。被屏蔽的事件数据不会发送到 Firebase Analytics。
   • 添加事件：如果您想同时衡量多个事件，请使用此选项。
     • 在替换事件名称字段中修改参数名称。
     • 使用待添加/修改的参数添加键名和值。点击添加行按钮并输入适当的键名和值。
     • 使用要删除的参数在触发代码时删除键名。
   • 修改事件：此选项可让您在不同应用版本之间保持参数名称的一致性。例如，您 Android 实现中的某个事件名称为“save_image”，而 iOS 实现中同一函数的事件名称为“save_new_image”。
     • 在替换事件名称字段中修改参数名称。
     • 使用待添加/修改的参数添加键名和值。点击添加行按钮并输入适当的键名和值。
     • 使用要删除的参数在触发代码时删除键名。

   • 点击触发条件，然后指定一个将触发此代码的适当事件触发器。

5. 保存并发布您的代码配置。

通过跟踪代码管理器在 Firebase 项目中启用 Universal Analytics

利用 Firebase，您可以为自己的应用启用跟踪代码管理器容器，然后就可以轻松使用跟踪代码管理器来配置和部署 Universal Analytics 代码或者任何受支持的第三方代码。

若要通过跟踪代码管理器设置 Universal Analytics 代码，请按以下步骤操作：

1. 为您的应用设置 Firebase：
   1. 安装 Firebase SDK（Android | iOS）。
   2. 在 Firebase 控制台中，将您的应用添加到 Firebase 项目中。
   3. 将 Firebase Analytics 添加到您的应用中 (Android | iOS)。
2. 创建跟踪代码管理器帐号并配置跟踪代码管理器容器。
3. 将跟踪代码管理器添加到您的项目中 (Android | iOS)。
4. 在跟踪代码管理器中创建您的 Google Analytics（分析）代码。

由于 InstallBroadcast API 已弃用，因此 Universal Analytics 不再支持应用进行新用户归因。请考虑改用新一代 Google Analytics（分析）4。

在为您的应用编译好 Firebase 和跟踪代码管理器后，您就可以通过跟踪代码管理器界面添加任何额外的代码，而无需重新构建您的应用。

系统会自动为 Firebase SDK 启用 IP 匿名化，您无需在 Google Analytics（分析）设置变量中进行设置。

跟踪代码管理器中针对 Android 和 iOS 应用提供的自动收集的事件

下表列出了可通过跟踪代码管理器访问的针对 Android 和 iOS 应用的 Google Analytics for Firebase 自动收集的事件。

事件	Android	iOS
app_exception	✓
app_update		✓
firebase_campaign	✓	✓
first_open		✓
in_app_purchase		✓
notification_dismiss	✓
notification_foreground	✓	✓
notification_open	✓	✓
notification_receive	✓
os_update	✓	✓
session_start	✓	✓
user_engagement	✓	✓

修改和屏蔽事件

通过跟踪代码管理器，您可以使用 Google Analytics (Firebase) 代码来修改、添加或屏蔽自定义事件（即使是在应用发布之后）。默认情况下，即便跟踪代码管理器正在使用中，系统也会将您的应用中通过 Firebase SDK 记录的事件发送给 Google Analytics（分析）。这对于以下情形很有用：不同应用版本中的事件名称已发生变化，而您希望从仍在使用较早应用版本的用户那里收集一致的数据。

重要提示：仅在您希望修改、添加或屏蔽 Firebase 所记录的自定义事件时，使用 Google Analytics (Firebase) 代码。自动收集的事件无法修改。

相关资源

• 跟踪代码管理器开发者文档（Android 版和 iOS 版）
• Firebase 帮助中心