通过

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

  • 项目

组合列表是从多个现有访问群体的组合中创建的受众。

可以组合自定义受众、客户列表、产品访问群体、类似受众和再营销列表。 不能在组合列表中包括其他组合列表或市场受众。

每个广告帐户最多可以创建 1,000 个组合列表，每个客户最多可以创建 5,000 个列表。 每个列表最多可以包含 100 个组合规则或逻辑条件集，每个 CombinationRule 最多可以包含 100 个访问群体 ID。

提示

有关访问群体的概述和详细信息，请参阅 受众 API 技术指南。

语法

<xs:complexType name="CombinedList" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Audience">
      <xs:sequence>
        <xs:element minOccurs="0" name="CombinationRules" nillable="true" type="tns:ArrayOfCombinationRule" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

元素

CombinedList 对象具有以下元素：CombinationRules。

元素 说明 数据类型
CombinationRules 用于确定要添加到组合列表的人员的逻辑条件。

每个列表最多可以包含 100 个组合规则或逻辑条件集，每个 CombinationRule 最多可以包含 100 个访问群体 ID。

有关详细信息，请参阅 CombinationRule 备注。

加： 必填
更新： 必填。 如果要保留任何以前的规则，则必须在更新期间再次显式设置它们。		 CombinationRule 数组

CombinedList 对象具有 Inherited Elements。

继承的元素

从受众继承的元素

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

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

受众至少需要有 300 人，Microsoft广告将使用它进行优化。

加： 只读
更新： 只读		 long
CustomerShare 组合列表访问群体不支持此元素。

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

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

加： 自选
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。		 string
ForwardCompatibilityMap 用于向前兼容性的键和值字符串列表，以避免在当前 API 版本中添加新元素时发生重大更改。

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

加： 只读
更新： 必需和只读		 long
MembershipDuration 组合列表访问群体不支持此元素。

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

加： 必填
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。		 string
ParentId 帐户或客户的Microsoft广告标识符。

如果 “作用域 ”设置为 “帐户”，则这是帐户 ID，否则为客户 ID。

加： 必填
更新： 只读。 不能更改父 ID。		 long
范围 作用域定义哪些帐户可以使用此受众。

如果范围设置为 “帐户”，则受众只能与一个帐户中的市场活动和广告组相关联，即通过 ParentId。 如果范围设置为 “客户”，则受众可以与客户所有帐户中的市场活动和广告组相关联。

加： 必填
更新： 自选。 可以将范围从“帐户”更改为“客户”，但不能将范围从“客户”更改为“帐户”。		 EntityScope
SearchSize 搜索网络中此受众的活动成员的总数。 这样就可以了解可以面向多少搜索用户。

受众至少需要有 300 人，Microsoft广告将使用它进行优化。

在生成访问群体时，此属性最多为零或为空，例如，添加或更新组合列表成员身份持续时间、规则或标记标识符。

如果与组合列表关联的 UET 标记的状态为“未验证”或“非活动”，则此属性将为 nil 或为空，因为组合列表无法从您的网站接收生成列表所需的客户信息。

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

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

加： 只读
更新： 只读		 字符串 数组
类型 访问群体的类型。 检索组合列表访问群体时，此值为 CombinedList 。 有关访问群体类型的详细信息，请参阅 访问群体数据对象备注。

加： 只读
更新： 只读		 AudienceType

要求

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