[GA4] 导入用户数据

请勿上传包含重复键（例如两个字段的名称都是 user_id）的文件。

通过导入存储在 Google Analytics（分析）之外的用户元数据（例如 CRM 系统中的忠诚度评级、上次购买日期以及客户生命周期价值），您可以优化细分用户群和再营销受众群体。

用户数据导入的运作方式

为了成功导入用户数据，您需要使用下列任一键将您的数据与 Google Analytics（分析）数据合并：

数据流 ID 以及 Google Analytics（分析）生成的 Client-ID（网站）或应用实例 ID（应用）。
您为每个用户生成的唯一标识符，例如，您可以从网站或应用身份验证服务获取 User-ID，也可以从您的 CRM 系统提取 User-ID。随后，您可以将这些唯一标识符（为保护最终用户隐私而进行了哈希处理）添加到您的衡量代码中，并与事件一起发送到 Google Analytics（分析）中。

Google Analytics（分析）使用以下 ID 作为键，以将用户与上传的数据相对应：1) 数据流 ID 和 Client-ID/应用实例 ID，或者 2) 唯一标识符。

导入数据时选择其中一种方式即可。

如果您使用数据流 ID 和应用实例 ID 将用户与上传的数据相对应，则务必注意，用户每安装一次应用，系统都会分配一个新的应用实例 ID。如果用户卸载并重新安装应用，在重新安装之前和之后收集的数据将会关联到两个不同的应用实例 ID，也就是两个不同的用户。应用更新不会更改应用实例 ID。

上传的数据会存储在用户维度中，上传完成后会与您通过此过程标识的用户所触发的每个后续事件相关联。

在 Google Analytics（分析）中存储用户标识符

您可以通过以下两种方式将用户标识符存储在 Google Analytics（分析）中：

使用 User-ID 维度
了解如何设置 User-ID
搭配使用范围设为用户的自定义维度以及可捕获用户标识符的用户属性
详细了解避免向 Google Analytics（分析）发送个人身份信息的最佳做法

创建自定义维度

创建自定义维度后才能上传数据。

为要导入的值创建用户级范围的自定义维度。例如，您可以创建用户属性为“loyalty_tier”的自定义维度“用户忠诚度级别”。

在您创建自定义维度后，Google Analytics（分析）最长需要 4 小时才能识别您导入的数据。（您可以打开探索并检查维度选择器中是否有相应用户属性，以验证您创建的自定义维度是否处理完成。）

创建 CSV 文件

创建一个包含用户标识符和用户属性值的 CSV 文件。例如：

user_id	loyalty_tier
A1234	gold
J1234	bronze
K1234	silver
R1234	silver

上传数据

数据导入简介一文中概述了常规上传流程。

创建数据源时，请根据要用于标识用户的方法（是 User-ID，还是 Client-ID/应用实例 ID + 数据流 ID）选择按 User ID 列出的用户数据或按 Client ID 列出的用户数据。

将 Google Analytics（分析）字段与导入的字段对应后，您会看到如下内容：

在第一列中，您会看到：

您要在其中合并数据的 Google Analytics（分析）字段（在本例中为 User-ID），此类字段也称为架构键。
您在 Google Analytics（分析）中创建的与 CSV 中的字段相匹配的自定义维度的用户属性（在上述示例中，自定义维度为“用户忠诚度级别”，用户属性为“loyalty_tier”）。

在第二列中，您需要选择 CSV 中的匹配字段：

上传数据后，Google Analytics（分析）最长可能需要 24 小时才能在报告、受众群体和探索中反映这些数据。上传数据后，您标识的用户必须与您的网站或应用互动，这些用户属性才能与用户活动相关联。

如要覆盖用户维度值，您可以上传新的维度值，也可以通过衡量代码收集新的维度值。

删除数据上传服务中的用户数据源时，不会删除存储在受影响用户的用户维度中的值。与其他所有收集方法一样，您后续可能需要删除用户或数据（如有必要），以便移除通过数据导入上传的数据。

数据源详细信息

说明

范围：范围用来确定哪些事件将与导入维度值相关联。自定义维度可采用以下两种范围中的一种：
- 事件：关于事件的描述性信息（例如事件名称）
- 用户：关于触发相应事件的用户的描述性信息（例如忠诚度级别）
架构键：列出键维度或指标。键用来将您上传的数据与适用于此数据源类型的事件中的现有数据合并。
导入的数据：列出您上传到 Google Analytics（分析）的数据所适用的维度和指标。

以下针对架构列出的维度和指标仅供参考，可能并不完整；可用的实际维度和指标会在您创建数据源时显示在界面上。

范围	用户
架构键	下列两项中的任何一项： Client ID + Stream ID（客户端 ID + 数据流 ID） User ID（用户 ID）
导入的数据	用户属性
备注	用户不得上传个人身份信息，或将此类信息与用户数据导入相关联。了解详情

模板

以下是 Client ID 数据和 User-ID 数据的 CSV 模板示例。如果您需要手动创建上传文件，请参考以下示例。

Client-ID

client_id	stream_id	user_property1	user_property2	user_property3
1234567890.1234567890	1234567	user value 1	user value 2	user value 3
2345678901.2345678901	1234567	user value 1	user value 2	user value 3
3456789012.3456789012	1234567	user value 1	user value 2	user value 3

请确保以字符串形式存储客户端 ID，而不要将其存储为数字，以免被截断为更少的小数位。

User-ID

user_id	user_property1	user_property2	user_property3
123abc	user value 1	user value 2	user value 3
456def	user value 1	user value 2	user value 3
789ghi	user value 1	user value 2	user value 3

下载适用于用户数据的 CSV 导入模板。

查找您的数据流 ID

在管理界面中，点击“数据收集和修改”下方的数据流。
打开相关的数据流。

数据流 ID 位于详细信息标题左侧。

该内容对您有帮助吗？

您有什么改进建议？