[GA4] 收集用户提供的数据 (跟踪代码管理器)

这些说明适用于符合以下条件的管理员和编辑者：已启用“收集用户提供的数据”功能，并且希望开始使用 Google 跟踪代码管理器通过网站发送用户提供的数据。

Before you begin

You must turn on user-provided data collection in Google Analytics.

选择如何设置数据收集

选择如何在跟踪代码管理器中设置“收集用户提供的数据”功能：

选项	说明
自动收集	Google Analytics 会检查您的网页，找出与电子邮件地址模式相符的字符串。这种方式不适用于电话号码和地址。我们建议您使用以下方式作为此方式的补充。详细了解此方式
手动配置	选择您希望收集的用户提供的数据类型，例如电子邮件地址或电话号码。对于每种类型的数据，请选择您希望在网页上识别这些数据的方式（CSS 选择器或全局 JavaScript 变量）。详细了解此方式 此方法比自动检测用户提供的数据更精确，但不如向网站中添加代码段可靠。如果您经常更改网站代码，尤其是收集页面上的格式设置或 CSS 选择器，则可以考虑向您的网站中添加代码段。
代码	在网页中添加 JavaScript 代码，用于收集电子邮件地址、电话号码和/或姓名与地址。然后，为网页上的每个事件设置 user_data 参数。详细了解此方式

要设置的字段

下表介绍了您可以设置的各个字段。键名显示了您必须如何在代码中引用相应字段。您必须以字符串类型传递数据。在指定姓名和地址时，请务必将各个组成部分分别指定为一个变量（如名字、姓氏等）。

注意：如果您想发送未经过哈希处理的数据，让 Google 对其进行标准化和哈希处理，请使用每个数据字段的第一个键名。例如，针对下表中的“电子邮件地址”数据字段，请使用“email”键名。如果您想发送经过哈希处理的数据，请使用以 sha256_ 开头的键名。

数据字段	键名	说明
电子邮件地址	email	用户的电子邮件地址。 示例：“[e-mail]”
	sha256_email_address	经过哈希处理的用户电子邮件地址。 例如： “a8af8341993604f29cd4e0e5a5a4b5d48c575436c38b28abbfd7d481f345d5db”
电话号码	phone_number	用户的电话号码。必须采用 E.164 格式，即电话号码必须由 11 到 15 位数组成，且包含加号 (+) 前缀和国家/地区代码（不得包含短划线、括号或空格）。 示例：“[phone]”
	sha256_phone_number	经过哈希处理的用户电话号码。 例如： “e9d3eef677f9a3b19820f92696be53d646ac4cea500e5f8fd08b00bc6ac773b1”
名字	address.first_name	用户的名字。 示例：“小明”
	address.sha256_first_name	经过哈希处理的用户名字。 例如： “96d9632f363564cc3032521409cf22a852f2032eec099ed5967c0d000cec607a”
姓氏	address.last_name	用户的姓氏。 示例：“王”
	address.sha256_last_name	经过哈希处理的用户姓氏。 例如： “799ef92a11af918e3fb741df42934f3b568ed2d93ac1df74f1b8d41a27932a6f”
街道地址	address.street	用户所在的街道地址。示例：“新街 123 号”
城市	address.city	用户所在城市的名称。示例：“南安普敦”
地区	address.region	用户所在的省/直辖市/自治区、州或地区。示例：“汉普郡”
邮编	address.postal_code	用户的邮政编码。示例：“SO99 9XX”
国家/地区	address.country	用户的国家/地区代码。示例：“英国”。请根据 ISO 3166-1 alpha-2 标准使用由 2 个字母组成的国家/地区代码。