客户列表项记录 - 批量
定义可在批量文件中上传的客户列表项。
注意
不支持批量下载客户列表项。
重要
必须先创建一个客户列表受众，并接受Microsoft广告 UI 中的条款和条件，然后才能通过批量 API 上传客户列表数据。 初始客户列表不需要包含任何客户数据，但必须选择“我接受”。 选择“我接受”即表示你 (1) 同意你能够合法披露受众详细信息（即个人数据），以Microsoft和 (2) 接受客户匹配条款、Microsoft广告协议和Microsoft广告政策。 Microsoft将根据 客户匹配条款使用上传的数据。
客户列表是你为启用客户匹配而编译的一组客户联系信息。 每个列表可以包含多个Email项。
- 在批量上传文件中包含 客户列表 记录，并将其 “操作类型 ”字段设置为“添加”、“删除”或“替换”。
- 在同一批量上传文件中包括一个或多个 客户列表项 记录，并设置 “父 ID”、“ 子类型”和“ 文本” 字段。
可以在 同一批量 上传文件中添加或更新没有任何 客户列表项 记录的客户列表记录;但是，如果没有随附 的父客户列表 记录，则无法上传任何 客户列表 项记录。
48 小时后，检查“受众大小”字段，例如“受众搜索大小”，查看我们在必应网络上匹配的客户数量。 此时，你的广告可以开始为这一新受众显示。
提示
有关访问群体的概述和详细信息，请参阅 受众 API 技术指南。
通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 CustomerLists 的 DownloadEntity 值，可以下载帐户中的所有客户列表项记录。 此外，下载请求必须包括 EntityData 范围。 有关批量服务的更多详细信息（包括最佳做法），请参阅 批量下载和上传。
以下批量 CSV 示例将添加新的客户列表项。
Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Action Type,Sub Type,Text
Format Version,,,,,,6.0,,,,,,
Customer List,Active,-10,,ClientIdGoesHere,,,New customer list description,Customer,New Customer List,Add,,
Customer List Item,,,-10,ClientIdGoesHere,,,,,,,Email,HashedValue
对于 客户列表项 记录， 批量文件架构中提供了以下属性字段。
受众
父客户列表访问群体的名称。
该名称最多可包含 128 个字符。
加： 必填。 必须指定 “父 ID ”或“ 受众” 字段。
删除： 必填。 必须指定 “父 ID ”或“ 受众” 字段。
客户端 ID
用于将批量上传文件中的记录与结果文件中的记录相关联。 服务器不使用或存储此字段的值;它只是从上传的记录复制到相应的结果记录。 它可以是长度最大为 100 的任何有效字符串。
加： 自选
删除： 自选
父 ID
父客户列表访问群体的标识符。
加： 只读和必需。 必须指定现有客户列表标识符，或指定等于父客户列表记录的 ID 字段的负标识符。 如果要将新的客户列表项添加到同一批量文件中的新客户列表，则这是必需的。 有关详细信息，请参阅 批量文件架构引用密钥。
删除： 必填。
子类型
确定 Text 字段是否表示经过哈希Email值。
目前唯一受支持的值为“Email”。
加： 必填
删除： 必填
Text
哈希Email为文本。
如果 Sub Type 为“Email”，则此字段不能包含纯文本。 必须使用 SHA-256 算法对字符串进行哈希处理。 经过哈希处理Email必须是长度为 64 的十六进制字符串。 例如，必须上传哈希字符串，例如“f25ad364d33972379a7a4f4df33db142205f5c40eb19cfdb2fc5aaf117e10101”，而不是“test@contoso.com”。
加： 必填
删除： 必填