设置用户数据的格式

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

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

UserData 的相关要求

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

AddressInfo 格式

请按照以下格式设置指南来构建 UserIdentifier 的 address 属性。

PairData 的相关要求

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

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

MobileData 的相关要求

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

时间戳格式

如果使用 JSON 格式表示 Timestamp 字段（例如 Event 的 timestamp 和 last_updated_timestamp），请使用 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

如果使用协议缓冲区格式，请在构建 Timestamp 时设置 seconds 和可选的 nanos。以下是 2025 年 8 月 8 日下午 5:18:44.291（世界协调时间）的 seconds 和 nanos 值：

• seconds：1754683124
• nanos：291000000

编码

对数据进行编码时，请注意以下几点：

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