通过

InMarketAudience 数据对象 - 市场活动管理

  • 项目

定义市场内受众。

注意

不能使用必应广告 API 添加、更新或删除市场内受众。 话虽如此，你可以添加和删除市场内受众关联和排除项。 必应广告 API 将始终返回所有当前活跃的市场受众。 该服务不会返回已删除的市场受众或任何增量下载，以查看更改的内容。 通过必应广告 API 返回的市场内受众是所有市场（例如澳大利亚、CA、DE、FR、英国和美国）的所有可用市场受众的联合体。 AudienceNetworkSize 和 SearchSize 是对应网络中给定市场受众的所有受支持市场的列表大小的总和。 必应广告 API 不提供每个市场的列表大小的详细信息。 例如，搜索网络中的“广告和市场营销”市场受众规模可能通过必应广告 API 返回 1710 万) 17070879 (。 Microsoft广告 Web 应用程序中显示的每个市场的细分可能为：美国为 288 万;474K（AU）;1370 万在英国。
不应依赖于沙盒市场受众。 某些市场内受众在沙盒中可用，但在生产环境中不可用。 沙盒和生产之间的市场内受众属性值也可能有所不同，例如访问群体名称和大小。

注意

此功能在澳大利亚、加拿大、法国、德国、英国和美国可用。

提示

有关市场内受众的概述，请参阅 关于市场内受众 帮助主题。

语法

<xs:complexType name="InMarketAudience" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Audience">
      <xs:sequence />
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

元素

InMarketAudience 对象具有 Inherited Elements。

继承的元素

从受众继承的元素

InMarketAudience 对象派生自 Audience 对象，并继承以下元素：AudienceNetworkSize、CustomerShare、Description、ForwardCompatibilityMap、Id、MembershipDuration、Name、ParentId、Scope、SearchSize、SupportedCampaignTypes、Type。 以下说明特定于 InMarketAudience，可能不适用于从 Audience 对象继承相同元素的其他对象。

元素 说明 数据类型
AudienceNetworkSize 在受众网络中是此受众的活跃成员的总数。 这让你了解可以面向多少受众网络用户。

加： 不支持
更新： 不支持		 long
CustomerShare 市场内受众不支持此元素。

加： 不支持
更新： 不支持		 CustomerShare
说明 受众的说明。 使用说明来帮助你记住你面向的受众。

说明最多可以包含 1,024 个字符。

加： 不支持
更新： 不支持		 string
ForwardCompatibilityMap 用于向前兼容性的键和值字符串列表，以避免在当前 API 版本中添加新元素时发生重大更改。

将来的版本中将在此处记录向前兼容性更改。 目前没有针对 Audience 对象的向前兼容性更改。		 KeyValuePairOfstringstring 数组
ID 受众Microsoft广告标识符。

加： 不支持
更新： 不支持		 long
MembershipDuration 创建受众时，可以指定Microsoft广告应查找与受众定义匹配的操作的时间。

最短持续时间为 1 天，允许的最大持续时间为 180 天。

加： 不支持
更新： 不支持		 int
名称 访问群体的名称。 该名称最多可包含 128 个字符。

加： 不支持
更新： 不支持		 string
ParentId 包含市场内受众的客户Microsoft广告标识符。

加： 不支持
更新： 不支持		 long
范围 作用域定义哪些帐户可以使用此受众。

对于市场内受众，唯一受支持的范围是 “客户”，并且该受众可以与所有客户帐户中的市场活动和广告组相关联。

加： 不支持
更新： 不支持		 EntityScope
SearchSize 搜索网络中此受众的活动成员的总数。 这样就可以了解可以面向多少搜索用户。

加： 不支持
更新： 不支持		 long
SupportedCampaignTypes 支持此受众的市场活动类型列表。

支持的值为 Audience、DynamicSearchAds、Search 和 Shopping。 将来可能会添加新的市场活动类型，因此不应依赖于一组固定值。

加： 不支持
更新： 不支持		 字符串 数组
类型 访问群体的类型。 检索市场内受众时，此值为 InMarket 。 有关访问群体类型的详细信息，请参阅 访问群体数据对象备注。

加： 不支持
更新： 不支持		 AudienceType

要求

服务： CampaignManagementService.svc v13
Namespace： https://bingads.microsoft.com/CampaignManagement/v13