合并列表记录 - 批量
定义可在批量文件中下载和上传的组合列表。
组合列表是从多个现有访问群体的组合中创建的受众。
提示
有关访问群体的概述和详细信息，请参阅 受众 API 技术指南。
可以通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 CombinedLists 的 DownloadEntity 值来下载帐户中的所有组合列表记录。 此外，下载请求必须包括 EntityData 范围。 有关批量服务的更多详细信息（包括最佳做法），请参阅 批量下载和上传。
以下批量 CSV 示例将添加一个新的组合列表。
Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Combination Rule
Format Version,,,,,,6.0,,,,,,
Combined List,Active,-10,,ClientIdGoesHere,,,New combined list description,Customer,New Combined List,NOT(123IdGoesHere,234IdGoesHere)&AND(345IdGoesHere,456IdGoesHere)&OR(567IdGoesHere)
如果使用用于 .NET、Java 或 Python 的必应广告 SDK ，则可以使用 BulkServiceManager 来节省时间来上传和下载 BulkCombinedList 对象，而无需直接调用服务操作和编写自定义代码来分析批量文件中的每个字段。
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkCombinedList
var bulkCombinedList = new BulkCombinedList
{
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// CombinedList object of the Campaign Management service.
CombinedList = new CombinedList
{
// 'Audience Network Size' column header in the Bulk file
AudienceNetworkSize = null,
// 'Description' column header in the Bulk file
Description = "New Combined List",
// 'Id' column header in the Bulk file
Id = combinedListIdKey,
// 'Membership Duration' column header in the Bulk file
MembershipDuration = 30,
// 'Audience' column header in the Bulk file
Name = "Combined List " + DateTime.UtcNow,
// 'Parent Id' column header in the Bulk file
ParentId = accountIdKey,
// 'Combination Rule' column header in the Bulk file
CombinationRules = new[]
{
// Each rule is delimited by a semicolon (;) in the Bulk file
new CombinationRule
{
AudienceIds = new [] { 123, 234 },
Operator = LogicalOperator.And
},
new CombinationRule
{
AudienceIds = new [] { 345, 456 },
Operator = LogicalOperator.And
},
},
// 'Scope' column header in the Bulk file
Scope = EntityScope.Account,
// 'Audience Search Size' column header in the Bulk file
SearchSize = null,
// 'Supported Campaign Types' column header in the Bulk file
SupportedCampaignTypes = null,
},
// 'Status' column header in the Bulk file
Status = Status.Active
};
uploadEntities.Add(bulkCombinedList);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
对于 组合列表 记录， 批量文件架构中提供了以下属性字段。
受众
组合列表的名称。
该名称最多可包含 128 个字符。
添加： 必填
更新： 选。 如果未为更新设置任何值，则不会更改此设置。
删除： 只读
受众网络大小
在受众网络中是此受众的活跃成员的总数。 这让你了解可以面向多少受众网络用户。
在 Microsoft Advertising 使用它进行优化之前，受众至少需要有 300 人。
添加： 只读
更新： 只读
删除： 只读
访问群体搜索大小
搜索网络中此受众的活动成员的总数。 这样就可以了解可以面向多少搜索用户。
在 Microsoft Advertising 使用它进行优化之前，受众至少需要有 300 人。
在生成访问群体时，此属性最多为空 24 小时，例如，如果添加或更新组合列表成员资格持续时间、规则或标记标识符。
如果与合并列表关联的 UET 标记的状态为“未验证”或“非活动”，则此属性将为空，因为组合列表无法从您的网站接收生成列表所需的客户信息。
添加： 只读
更新： 只读
删除： 只读
客户端 ID
用于将批量上传文件中的记录与结果文件中的记录相关联。 服务器不使用或存储此字段的值;它只是从上传的记录复制到相应的结果记录。 它可以是长度最大为 100 的任何有效字符串。
添加： 选
更新： 选
删除： 只读
组合规则
组合规则包含用于确定要添加到组合列表的人员的条件。
可以组合自定义受众、客户列表、产品访问群体、类似受众和再营销列表。 不能在组合列表中包括其他组合列表或市场受众。
每个广告帐户最多可以创建 1,000 个组合列表，每个客户最多可以创建 5,000 个列表。 每个列表的组合规则最多可以包含 100 组逻辑条件，每个集最多可以包含 100 个访问群体 ID。
对于下面所述的一些限制，可以使用以下逻辑运算符组合访问群体：
- 或者：这将包括这些访问群体列表中的客户。
- AND：这将仅包括每个访问群体列表中的客户。
- 不：这将排除这些访问群体列表中的客户。
逻辑条件集是指由 OR、AND 或 NOT 限定的一组受众 ID。 在批量 API 中，每个集都用和号分隔 ('&') 。
例如，下面是一个组合规则的 10 个集， 每个具有一个访问群体 ID： NOT (1) &AND (2) &OR (3) &NOT (4) &AND (5) #B 4 OR (6) &NOT (7) &and (8) &OR (9) &NOT (10)
下面是一个组合规则的 10 个集的示例， 每个具有两个受众 ID： NOT (1,101) &AND (2,102) &OR (3,103) &NOT (4,104) &AND (5,105) &OR (6,106) &NOT (7,107) &and (8,108) &OR (9,109) &NOT (10,110)
对逻辑表达式的求值确定谁将添加到组合列表中。 多个组合始终与 AND 函数结合使用。 这意味着客户必须满足每个组合的所有条件才能出现在此自定义组合访问群体列表中。 例如， 假设组合规则设置为 NOT (123,234) &NOT (345,456) &AND (567,678) &OR (789,890) &OR (987,876) 。 组合列表将包括) 同时在访问群体 567 和 678 中的客户，b) 在受众 789 或 890 中，c) 在 987 或 876 受众中，除非 d) 客户属于 123、234、345 或 456。
组合列表必须至少包含一个使用 OR 或 AND 运算符的受众。 组合列表不能仅使用 NOT 运算符。 在这种情况下，应改用受众排除项。
自定义访问群体和客户列表不能与其他访问群体类型结合使用。
无法通过 AND 或 NOT 运算符合并类似的受众。 类似的访问群体只能在单个 OR 条件中使用。 换句话说，只能有一个访问群体集包含类似的访问群体，并且该集必须使用 OR 运算符。
允许重复访问群体，但无法通过 AND 和 NOT 运算符合并相同的访问群体 ID。
如果要在同一批量上传中创建新访问群体和此组合列表，组合规则可以包含一个负标识符，该标识符等于其他新访问群体的 “ID” 字段。 例如，如果要创建新的 再营销列表 ，并且还希望将其包含在组合列表中，则可以将再营销列表的 Id 值设置为 -1。 在同一批量上传中，可以在组合规则中使用 -1 引用新的再营销列表，例如 NOT (123,234) &AND (345,456) &或 (-1,678) 。 有关详细信息，请参阅 批量文件架构引用密钥。
如果要在同一批量上传中创建新访问群体和此组合列表，则组合规则可以包含指向其他新访问群体的负 ID 字段的负引用键。 还可以对其他新 访问群体的“受众 (名称) 字段使用逻辑引用键。
- 作为使用负引用键的示例，在同一批量上传中包括一个新的再营销列表，其中 ID 设置为 -1。 然后在组合规则中使用 -1 引用新的再营销列表，例如 NOT (123,234) &AND (345,456) &OR (-1,678) 。
- 作为使用逻辑引用密钥的示例，在同一批量上传中包括新的 再营销列表 ，其中的 受众 名称设置为 “我的新受众”。 然后，使用 “我的受众” (在组合规则中使用单引号) 括起来的新再营销列表，例如 NOT (123,234) &AND (345,456) &OR ('我的新受众'，678) 。
有关详细信息，请参阅 批量文件架构引用密钥。
添加： 必填
更新： 选。 如果未为更新设置任何值，则不会更改此设置。
删除： 只读
说明
组合列表的说明。 使用说明可帮助你记住此组合列表的目标受众。
说明最多可以包含 1,024 个字符。
添加： 选
更新： 选。 如果未为更新设置任何值，则不会更改此设置。 如果将此字段设置为 delete_value 字符串，则会删除以前的设置。
删除： 只读
Id
组合列表的系统生成的标识符。
添加： 只读
更新： 只读和必需
删除： 只读和必需
修改时间
上次更新实体的日期和时间。 该值以协调世界时 (UTC) 表示。
注意
日期和时间值反映服务器的日期和时间，而不是客户端。 有关日期和时间格式的信息，请参阅 基元 XML 数据类型中的 dateTime 条目。
添加： 只读
更新： 只读
删除： 只读
父 ID
帐户或客户的系统生成的标识符。 如果 “作用域 ”设置为 “帐户”，则这是帐户 ID，否则为客户 ID。
添加： 选
更新： 只读。 不能更改父 ID。
删除： 只读
范围
范围定义哪些帐户可以使用此组合列表。 如果范围设置为 “帐户”，则合并列表只能与一个指定帐户中的市场活动和广告组相关联， (父 ID) 。 如果范围设置为 “客户”，则合并列表可以与所有客户帐户中的任何市场活动和广告组相关联。
添加： 必填
更新： 只读。 不能更改范围。
删除： 只读
状态
组合列表状态。
可能的值为 Active 或 Deleted。
添加： 选。 默认值为 Active。
更新： 只读
删除： 必填。 “状态”必须设置为 “已删除”。
支持的市场活动类型
支持此组合列表的市场活动类型的分号分隔列表。
支持的值为 Audience、DynamicSearchAds、Search 和 Shopping。 将来可能会添加新的市场活动类型，因此不应依赖于一组固定值。
添加： 只读
更新： 只读
删除： 只读