设置用户数据的格式

Data Manager API 支持上传多种类型的用户数据。请遵循每个数据元素的 格式、哈希处理和编码要求，以便 您的数据能够成功接收和处理。

• UserData：用户提供的数据，例如电子邮件地址 或电话号码。
• PairData：发布商广告客户身份 调和 (PAIR) ID。
• MobileData：用于标识移动设备的数据。

UserData 要求

一个 UserData 对象是 UserIdentifier 对象的集合。每个 UserIdentifier 都具有下表中的一个属性。

UserIdentifier
email_address	格式 string 转换为小写。 如果电子邮件地址具有 gmail.com 或 googlemail.com 网域，请移除所有点号 (.) 之前的 @ 符号。 空格符 移除开头、结尾和中间的空格符。 哈希处理 使用 SHA-256 算法进行哈希处理。 使用十六进制或 Base64 编码对哈希字节进行编码。
phone_number	格式 string 使用 E.164 格式。 包含加号 (+) 和国家/地区 代码。加号后的所有字符都必须是数字。 例如，美国电话号码 [phone] 应格式化并规范化为[phone]。 空格符 移除开头和结尾的空格符。 哈希处理 使用 SHA-256 算法进行哈希处理。 使用十六进制或 Base64 编码对哈希字节进行编码。
address	AddressInfo 对象 请参阅 AddressInfo 格式规范。

AddressInfo 格式

请按照以下格式设置指南构建 address attribute of a UserIdentifier。

AddressInfo
given_name	格式 string 转换为小写。 请勿添加 Mrs. 等前缀。 空格符 移除开头和结尾的空格符。 哈希处理 使用 SHA-256 算法进行哈希处理。 使用十六进制或 Base64 编码对哈希字节进行编码。
family_name	格式 string 转换为小写。 请勿添加 Jr. 等后缀。 空格符 移除开头和结尾的空格符。 哈希处理 使用 SHA-256 算法进行哈希处理。 使用十六进制或 Base64 编码对哈希字节进行编码。
region_code	格式 string 一个双字符 ISO-3166-1 alpha-2 代码。 空格符 移除开头和结尾的空格符。 哈希处理 请勿对 region_code 进行哈希处理。
postal_code	格式 string 美国邮政编码和国际邮政编码均可使用。 对于美国地址，请使用 5 位数或 5 位数后跟 4 位数扩展。使用 4 位数扩展可能会提高匹配 率。 对于所有其他国家/地区，请勿使用邮政编码 扩展。 空格符 移除开头和结尾的空格符。 哈希处理 请勿对 postal_code 进行哈希处理。

PairData 要求

使用 ID 列表填充 PairData 对象的 pair_ids 字段。 请按照以下步骤设置列表中每个元素的格式：

1. 使用 SHA-256 算法 对净室提供的 PII 数据进行哈希处理。
2. 使用 PAIR 用户列表的发布商密钥 ，通过 EC 可交换密码对哈希字节进行加密。
3. 使用十六进制或 Base64 编码对加密的数据进行编码。

MobileData 要求

使用 移动 ID列表填充 MobileData 对象的 mobile_ids 字段。请勿对移动 ID 进行哈希处理。

时间戳格式

如果对 Timestamp 字段（例如 timestamp 和 last_updated_timestamp 的 Event）使用 JSON 格式，请使用 RFC 3339 格式。以下是一些示例，展示了 2025 年 8 月 8 日下午 5:18:44.291 的世界协调时间 (UTC) 采用 RFC 3339 格式以及不同时区 的情况：

• 世界协调时间 (UTC) 时区：2025-08-08T17:18:44.291Z
• 美国东部夏令时间 (EDT) 时区，当时比世界协调时间 (UTC) 早 4 小时： 2025-08-08T13:18:44.291-04:00
• 美国太平洋夏令时间 (PDT) 时区，当时比世界协调时间 (UTC) 早 7 小时： 2025-08-08T10:18:44.291-07:00
• 日本东京的时区，比世界协调时间 (UTC) 晚 9 小时，且不实行 夏令时： 2025-08-08T22:18:44.291+09:00

如果使用 Protocol Buffer 格式，请在构建 Timestamp 时设置 seconds，并可选择设置 nanos。以下是 2025 年 8 月 8 日下午 5:18:44.291 的世界协调时间 (UTC) 的 seconds 和 nanos 值：

• seconds：1754683124
• nanos：291000000

编码

对数据进行编码时，请注意以下事项：

• 使用 十六进制编码 (hex) 时，编码输出的大小写无关紧要。
• 使用 Base64 编码时，编码输出的大小写 至关重要 。