设置用户 ID

Google Analytics（分析）提供一个 setUserID 调用，让您可为使用您应用的个人存储用户 ID。此调用是可选的，通常供希望将 Analytics 与 BigQuery 结合使用的组织用来跨多个应用、多个设备或多个分析服务提供方关联同一用户的分析数据。

您可以通过多种方式构建有效的用户 ID。一种方法是使用您指定的标识符，并且只有您可以使用该标识符追溯到具体的用户。例如：假设某个移动游戏开发商 AwesomeGameCompany 拥有他们为每个用户创建的内部 AwesomeGameCompanyID。如果能保证外部组织无法使用 AwesomeGameCompanyID 追溯到原始用户，他们就可以考虑使用 AwesomeGameCompanyID 或经过哈希处理的 AwesomeGameCompanyID（更好）作为 Analytics 的用户 ID 值。这样，他们就可以计算出用户在其所有游戏中的总支出之类的值。

无需设置用户 ID 即可让 Analytics 正常运行。如果您只想查找单个设备上同一应用中属于同一用户的事件数据，则可以使用 user_pseudo_id。该值由 Analytics 自动生成，并随每个事件存储在 BigQuery 中。

设置用户 ID

您可以使用以下方法设置用户 ID：

Swift

注意：此 Firebase 产品不适用于 macOS 目标平台。

Analytics.setUserID("123456")

Objective-C

注意：此 Firebase 产品不适用于 macOS 目标平台。

[FIRAnalytics setUserID:@"123456"]

Android

mFirebaseAnalytics.setUserId("123456");

Web 模块化 API

import { getAnalytics, setUserId } from "firebase/analytics";

const analytics = getAnalytics();
setUserId(analytics, "123456");

Web 命名空间型 API

firebase.analytics().setUserId("123456");

Dart

await FirebaseAnalytics.instance.setUserId(id: '123456');

Unity

Firebase.Analytics.FirebaseAnalytics.SetUserID("123456");

C++

analytics::SetUserId("123456");

设置用户 ID 后，系统将自动使用该值标记所有将来的事件，并且您可以通过在 BigQuery 中查询 user_id 值来访问该 ID。添加用户 ID 不会影响 Google Analytics（分析）之前记录的任何事件。

如需详细了解如何在 BigQuery 中访问 Analytics 数据，请参阅此开发指南。