在市场受众记录 - 批量
定义可在批量文件中下载的市场内受众。
注意
此功能在 AD、AR、AT、AU、AW、BD、BE、 BG、BN、BO、BR、BS、CA、CH、CL、CO、CR、CY、CZ、DE、DK、DM、DO、EC、EE、ES、FI、FJ、FR、GF、GR、GT、GU、GY、HN、HR、HT、胡、ID、IE、IN、IT、KY、LI、LK、LT、LU、LV、MC、MN、MQ、 MS、MT、MV、MX、MY、NC、NL、NO、NP、NZ、PA、PE、PF、PG、PH、PL、PR、PT、PY、RO、SE、SG、SI、SK、SM、SV、TH、TT、UK、US、UY、VA、VE 和 VN。
注意
不支持批量上传。 不能使用必应广告 API 添加、更新或删除市场内受众。 话虽如此，你可以添加和删除市场内受众关联和排除项。
必应广告 API 将始终返回所有当前活跃的市场受众。 该服务不会返回已删除的市场受众或任何增量下载，以查看更改的内容。
通过必应广告 API 返回的市场内受众是所有市场（例如澳大利亚、CA、DE、FR、英国和美国）的所有可用市场受众的联合体。
“受众网络大小”和“受众搜索大小”是相应网络中给定市场内受众的所有受支持市场的列表大小的总和。 必应广告 API 不提供每个市场的列表大小的详细信息。 例如，搜索网络中的“广告和市场营销”市场受众规模可能通过必应广告 API 返回 1710 万) 17070879 (。 Microsoft广告 Web 应用程序中显示的每个市场的细分可能为：美国为 288 万;474K（AU）;1370 万在英国。
不应依赖于沙盒市场受众。 某些市场内受众在沙盒中可用，但在生产环境中不可用。 沙盒和生产之间的市场内受众属性值也可能有所不同，例如访问群体名称和大小。
提示
有关访问群体的概述和详细信息，请参阅 受众 API 技术指南。
通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 InMarketAudiences 的 DownloadEntity 值，可以下载帐户中的所有 In Market Audience记录。 此外，下载请求必须包括 EntityData 范围。 有关批量服务的更多详细信息（包括最佳做法），请参阅 批量下载和上传。
下面是面向市场受众的批量 CSV 示例下载。
Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Membership Duration,Scope,Audience,Supported Campaign Types
Format Version,,,,,,6.0,,,,,
In Market Audience,Active,IdHere,ParentIdHere,ClientIdGoesHere,,,In Market Audience Description,30,Account,In Market Audience,Search;DynamicSearchAds;Shopping;Audience
如果使用用于 .NET、Java 或 Python 的必应广告 SDK ，则可以使用 BulkServiceManager 来节省时间来下载 BulkInMarketAudience 对象，而无需直接调用服务操作并编写自定义代码来分析批量文件中的每个字段。
// Map properties in the Bulk file to the BulkInMarketAudience
var bulkInMarketAudience = new BulkInMarketAudience
{
// Map properties in the Bulk file to the
// InMarketAudience object of the Campaign Management service.
InMarketAudience = new InMarketAudience
{
// 'Audience Network Size' column header in the Bulk file
AudienceNetworkSize = null,
// 'Description' column header in the Bulk file
Description = "In Market Audience Description",
// 'Id' column header in the Bulk file
Id = InMarketAudienceIdKey,
// 'Membership Duration' column header in the Bulk file
MembershipDuration = 30,
// 'Audience' column header in the Bulk file
Name = "In Market Audience",
// 'Parent Id' column header in the Bulk file
ParentId = accountIdKey,
// '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
};
对于 “市场受众” 记录，批量 文件架构中提供了以下属性字段。
受众
市场内受众的名称。
该名称最多可包含 128 个字符。
加： 不支持
更新： 不支持
删除： 不支持
受众网络大小
在受众网络中是此受众的活跃成员的总数。 这让你了解可以面向多少受众网络用户。
加： 不支持
更新： 不支持
删除： 不支持
访问群体搜索大小
搜索网络中此受众的活动成员的总数。 这样就可以了解可以面向多少搜索用户。
加： 不支持
更新： 不支持
删除： 不支持
说明
市场内受众的说明。 使用说明来帮助你记住你针对此市场内受众的受众。
说明最多可以包含 1,024 个字符。
加： 不支持
更新： 不支持
删除： 不支持
Id
市场内受众的系统生成的标识符。
加： 不支持
更新： 不支持
删除： 不支持
成员资格持续时间
在 Microsoft Advertising Web 应用程序中创建市场内受众时，可以指定Microsoft广告应查找与市场内受众定义匹配的操作，以便将人员添加到列表中。
最短持续时间为 1 天，允许的最大持续时间为 180 天。
加： 不支持
更新： 不支持
删除： 不支持
修改时间
上次更新实体的日期和时间。 该值以协调世界时 (UTC) 表示。
注意
日期和时间值反映服务器的日期和时间，而不是客户端。 有关日期和时间格式的信息，请参阅 基元 XML 数据类型中的 dateTime 条目。
加： 不支持
更新： 不支持
删除： 不支持
父 ID
包含市场内受众的客户Microsoft广告标识符。
加： 不支持
更新： 不支持
删除： 不支持
范围
范围定义哪些帐户可以使用此市场内受众。 对于市场内受众，唯一受支持的范围是 客户，并且市场内受众可以与所有客户帐户中的任何市场活动和广告组相关联。
加： 不支持
更新： 不支持
删除： 不支持
状态
市场内受众状态。
可能的值为 Active 或 Deleted。
加： 不支持
更新： 不支持
删除： 不支持
支持的市场活动类型
支持此市场受众的市场活动类型的分号分隔列表。
支持的值为 Audience、DynamicSearchAds、Search 和 Shopping。 将来可能会添加新的市场活动类型，因此不应依赖于一组固定值。
加： 不支持
更新： 不支持
删除： 不支持