上传收集的客户数据，以创建目标客户匹配受众群体。此为敏感数据。您必须先正确准备好该文件，然后才能上传。
设置数据格式
请按以下步骤设置原始数据格式：
- 移除名字、姓氏和电子邮件地址值中的所有空格。
- 将所有字符串值都设为小写。
- 电话号码值应采用 E.164 格式。应包含国家/地区代码。
哈希数据
使用 SHA256 算法对以下类型的原始数据值进行哈希处理：
- 名字
- 姓氏
- 电子邮件地址
- 电话号码
分配数据
您使用的数据决定了受众群体类型。它还会确定用于传递数据的 API 对象。
联系信息
如果您使用联系信息来匹配用户，请注意以下事项：
- 使用受众群体类型
CUSTOMER_MATCH_CONTACT_INFO。 - 以
ContactInfo对象的形式传递数据。
为客户提供的数据选择决定了用于匹配客户的方法：
| 匹配方法 | |
|---|---|
| 电子邮件地址匹配 | 分配给 hashedEmails 字段的至少一个值。 |
| 电话号码匹配 | 分配给 hashedPhoneNumbers 字段的至少一个值。 |
| 邮寄地址匹配 | 分配给 hashedFirstName、hashedLastName、zipCodes 和 countryCode 字段的值。 |
| 电子邮件地址、邮寄地址和电话号码组合匹配 | 分配给 hashedEmails、hashedPhoneNumbers、hashedFirstName、hashedLastName、zipCodes 和 countryCode 字段的值。 |
将单次上传的所有 ContactInfo 对象都包含在一个 ContactInfoList 对象中。
移动设备 ID
如果您使用移动设备 ID 来匹配用户，请注意以下事项：
- 使用受众群体类型
CUSTOMER_MATCH_DEVICE_ID。 - 使用移动设备 ID 字符串传递数据。
在单个上传操作中，将所有移动设备 ID 都包含在一个 MobileDeviceIdList 对象中。
设置用户同意
在相关数据对象中设置 consent 字段，以传递所含用户授予的同意信号。
如果将 Consent 对象中的任一字段设置为 CONSENT_STATUS_DENIED，则会返回错误。
意见征求信号适用于请求中的所有用户。使用单独的请求来上传具有不同意见征求信号的用户。