客户列表记录 - 批量
定义可在批量文件中下载和上传的客户列表。
重要
必须先创建一个客户列表受众，并接受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
Format Version,,,,,,6.0,,,,,,
Customer List,Active,-10,,ClientIdGoesHere,,,New customer list description,Customer,New Customer List,Add
对于 客户列表 记录， 批量文件架构中提供了以下属性字段。
操作类型
确定是添加、删除还是替换包含在同一批量上传文件中 的客户列表项 记录。
如果操作类型为“Add”，则服务将尝试添加您包含在同一批量上传文件中 的客户列表项 记录。
如果操作类型设置为“删除”，则服务将尝试删除您包含在同一批量上传文件中 的客户列表项 记录。
如果操作类型设置为“替换”，则将删除此列表的所有先前客户匹配数据，并且服务将尝试添加你在同一批量上传文件中包括 的客户列表项 记录。
加： 自选。 默认情况下，“添加”操作类型用于新客户列表。 无论是否设置值，新客户列表将忽略此字段。
更新： 如果同时在同一批量上传文件中包括现有访问群体 的客户列表项 记录，则是必需的，否则此字段是可选的。
删除： 只读
受众
客户列表的名称。
该名称最多可包含 128 个字符。
加： 必填
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。
删除： 只读
受众网络大小
在受众网络中是此受众的活跃成员的总数。 这让你了解可以面向多少受众网络用户。
受众至少需要有 300 人，Microsoft广告将使用它进行优化。
加： 只读
更新： 只读
删除： 只读
访问群体搜索大小
搜索网络中此受众的活动成员的总数。 这样就可以了解可以面向多少搜索用户。
受众至少需要有 300 人，Microsoft广告将使用它进行优化。
在生成访问群体时，此属性最多为空 24 小时，例如，如果添加或更新客户列表成员资格持续时间、规则或标记标识符。
如果与客户列表关联的 UET 标记的状态为“未验证”或“非活动”，则此属性将为空，因为客户列表无法从您的网站接收生成列表所需的客户信息。
加： 只读
更新： 只读
删除： 只读
客户端 ID
用于将批量上传文件中的记录与结果文件中的记录相关联。 服务器不使用或存储此字段的值;它只是从上传的记录复制到相应的结果记录。 它可以是长度最大为 100 的任何有效字符串。
加： 自选
更新： 自选
删除： 只读
说明
客户列表的说明。 使用说明可帮助你记住此客户列表的目标受众。
说明最多可以包含 1,024 个字符。
加： 自选
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。 如果将此字段设置为 delete_value 字符串，则会删除以前的设置。
删除： 只读
Id
客户列表的系统生成的标识符。
加： 自选。 必须将此字段留空，或指定负标识符。 然后，可以在依赖记录类型的 父 ID 字段中引用为客户列表设置的负标识符，例如 客户列表项。 如果要在同一批量文件中添加新客户列表和新客户列表项，则这是必需的。 有关详细信息，请参阅 批量文件架构引用密钥。
更新： 只读和必需
删除： 只读和必需
修改时间
上次更新实体的日期和时间。 该值以协调世界时 (UTC) 表示。
注意
日期和时间值反映服务器的日期和时间，而不是客户端。 有关日期和时间格式的信息，请参阅 基元 XML 数据类型中的 dateTime 条目。
加： 只读
更新： 只读
删除： 只读
成员资格持续时间
创建客户列表时，可以指定用户在该细分市场中的停留时间。
最短持续时间为 1 天。 注意： 如果用户在 180 天内没有活动，则会从所有段中删除这些活动。
如果成员资格持续时间为“-1”，则不会过期。
如果成员资格持续时间为 null，则使用默认持续时间 (30 天) 。
加： 自选
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。
删除： 只读
父 ID
包含客户列表的客户Microsoft广告标识符。
加： 自选
更新： 只读。 不能更改父 ID。
删除： 只读
范围
范围定义哪些帐户可以使用此客户列表。 对于客户列表，唯一受支持的范围是 Customer，并且客户列表可以与所有客户帐户中的任何市场活动和广告组相关联。
加： 必填
更新： 只读。 不能更改范围。
删除： 只读
状态
客户列表状态。
可能的值为 Active 或 Deleted。
加： 自选。 默认值为 Active。
更新： 只读
删除： 必填。 “状态”必须设置为 “已删除”。
支持的市场活动类型
支持此客户列表的市场活动类型的分号分隔列表。
支持的值为 Audience、DynamicSearchAds、Search 和 Shopping。 将来可能会添加新的市场活动类型，因此不应依赖于一组固定值。
加： 只读
更新： 只读
删除： 只读