设置用户数据的格式

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

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

UserData 的相关要求

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

UserIdentifier
email_address	格式 string 转换为小写。 空格符 去除开头、结尾和中间的空格。 哈希技术 使用 SHA-256 算法进行哈希处理。 使用十六进制或 Base64 编码对哈希字节进行编码。
phone_number	格式 string 请使用 E.164 格式。 包含加号 (+) 和国家/地区代码。 空格符 去除开头和结尾的空格。 哈希技术 使用 SHA-256 算法进行哈希处理。 使用十六进制或 Base64 编码对哈希字节进行编码。
address	AddressInfo 对象 请参阅 AddressInfo 格式规范。

AddressInfo 格式

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

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 进行哈希处理。

时间戳格式

如果使用 JSON 格式表示 Timestamp 字段（例如 Event 的 timestamp 和 last_updated_timestamp），请使用 RFC 3339 格式。

如果使用协议缓冲区格式，请在构建 Timestamp 时设置 seconds 和（可选）nanos。

后续步骤

• 了解如何加密用户数据。