自定义受众记录 - 批量
定义可在批量文件中下载和上传的自定义受众。
自定义受众是使用自己的客户数据创建更丰富的用户细分而生成的一种再营销列表。 可以将自定义受众与再营销列表结合使用，通常通过数据管理提供程序 (DMP) 。 当 DMP 连接到我们的自定义受众功能时，你可以将自定义受众导入 Microsoft Advertising 进行搜索再营销。 可以独立于再营销使用自定义受众，无需 UET。
提示
有关访问群体的概述和详细信息，请参阅 受众 API 技术指南。
通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 CustomAudiences 的 DownloadEntity 值，可以下载帐户中的所有自定义受众记录。 此外，下载请求必须包括 EntityData 范围。 有关批量服务的更多详细信息（包括最佳做法），请参阅 批量下载和上传。
以下批量 CSV 示例将更新自定义访问群体的说明。 注意：对于自定义受众，不会在 Microsoft Advertising Web 应用程序中设置成员资格持续时间，并且 Microsoft Advertising 遵循自定义受众提供商设置。
Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Supported Campaign Types
Format Version,,,,,,6.0,,,,,
Custom Audience,Active,IdHere,ParentIdHere,ClientIdGoesHere,,,Updated Custom Audience Description,30,Account,Custom Audience,Search;DynamicSearchAds;Shopping;Audience
如果使用用于 .NET、Java 或 Python 的必应广告 SDK ，则可以使用 BulkServiceManager 来节省时间来上传和下载 BulkCustomAudience 对象，而无需直接调用服务操作和编写自定义代码来分析批量文件中的每个字段。
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkCustomAudience
var bulkCustomAudience = new BulkCustomAudience
{
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// CustomAudience object of the Campaign Management service.
CustomAudience = new CustomAudience
{
// 'Audience Network Size' column header in the Bulk file
AudienceNetworkSize = null,
// 'Description' column header in the Bulk file
Description = "Updated Custom Audience Description",
// 'Id' column header in the Bulk file
Id = customAudienceIdKey,
// 'Audience' column header in the Bulk file
Name = null,
// 'Parent Id' column header in the Bulk file
ParentId = accountIdKey,
// 'Scope' column header in the Bulk file
Scope = null,
// '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(bulkCustomAudience);
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 小时，例如，如果已从 DMP 导入新的自定义访问群体，则生成访问群体需要 24 小时，同时此属性将为空。
添加： 不支持
更新： 只读
删除： 只读
客户端 ID
用于将批量上传文件中的记录与结果文件中的记录相关联。 服务器不使用或存储此字段的值;它只是从上传的记录复制到相应的结果记录。 它可以是长度最大为 100 的任何有效字符串。
添加： 不支持
更新： 选
删除： 只读
说明
自定义受众的说明。 使用说明来帮助你记住你针对此自定义受众的受众。
说明最多可以包含 1,024 个字符。
添加： 不支持
更新： 选。 如果未为更新设置任何值，则不会更改此设置。 如果将此字段设置为 delete_value 字符串，则会删除以前的设置。
删除： 只读
Id
自定义访问群体的系统生成的标识符。
添加： 不支持
更新： 必填
删除： 只读和必需
成员资格持续时间
成员资格持续时间确定 Microsoft Advertising 应查找与自定义受众定义匹配的操作的时间长度，以便将人员添加到列表中。 对于自定义受众，不会在 Microsoft Advertising Web 应用程序中设置成员资格持续时间，Microsoft Advertising 会遵循自定义受众提供商设置。
通过必应广告 API 请求自定义受众时，返回的成员身份持续时间将为 null。
添加： 不支持
更新： 不支持
删除： 只读
修改时间
上次更新实体的日期和时间。 该值以协调世界时 (UTC) 表示。
注意
日期和时间值反映服务器的日期和时间，而不是客户端。 有关日期和时间格式的信息，请参阅 基元 XML 数据类型中的 dateTime 条目。
添加： 不支持
更新： 只读
删除： 只读
父 ID
包含自定义受众的客户的 Microsoft Advertising 标识符。
添加： 不支持
更新： 必填
删除： 只读
范围
范围定义哪些帐户可以使用此自定义受众。 对于自定义受众，唯一支持的范围是 “客户”，并且自定义受众可以与所有客户帐户中的任何市场活动和广告组相关联。
添加： 不支持
更新： 只读
删除： 只读
状态
自定义访问群体状态。
可能的值为 Active 或 Deleted。
添加： 不支持
更新： 只读
删除： 必填。 “状态”必须设置为 “已删除”。
支持的市场活动类型
支持此自定义受众的市场活动类型的分号分隔列表。
支持的值为 Audience、DynamicSearchAds、Search 和 Shopping。 将来可能会添加新的市场活动类型，因此不应依赖于一组固定值。
添加： 不支持
更新： 只读
删除： 只读