CustomerList 数据对象 - 市场活动管理
定义 CustomerList 数据对象。
重要
在通过市场活动管理 API 创建客户列表数据之前，必须先创建一个客户列表受众，并接受Microsoft广告 UI 中的条款和条件。 初始客户列表不需要包含任何客户数据，但必须选择“我接受”。 选择“我接受”即表示你 (1) 同意你能够合法披露受众详细信息（即个人数据），以Microsoft和 (2) 接受客户匹配条款、Microsoft广告协议和Microsoft广告政策。 Microsoft将根据 客户匹配条款使用上传的数据。
语法
<xs:complexType name="CustomerList" 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>
元素
CustomerList 对象具有继承元素。
继承的元素
从受众继承的元素
CustomerList 对象派生自 Audience 对象，并继承以下元素：AudienceNetworkSize、CustomerShare、Description、ForwardCompatibilityMap、Id、MembershipDuration、Name、ParentId、Scope、SearchSize、SupportedCampaignTypes、Type。 以下说明特定于 CustomerList，可能不适用于从 Audience 对象继承相同元素的其他对象。
| 元素 | 说明 | 数据类型 |
|---|---|---|
| AudienceNetworkSize | 在受众网络中是此受众的活跃成员的总数。 这让你了解可以面向多少受众网络用户。 受众至少需要有 300 人，Microsoft广告将使用它进行优化。 加： 只读 更新： 只读 |
long |
| CustomerShare | 确定共享受众的客户和帐户的列表。 详细信息包括访问群体关联计数。 共享 UET 标记和访问群体仅适用于试点客户。 有关在客户层次结构中共享访问群体和 UET 标记的概述，请参阅 共享受众和 UET 标记 技术指南。 加： 自选 更新： 自选。 如果未为更新设置任何值，则不会更改此设置。 将此元素设置为 null 或空，以保留任何现有客户帐户共享。 若要删除所有客户帐户共享，请将 CustomerShare 对象的 CustomerAccountShares 元素设置为 null 或空。 若要删除客户帐户共享的子集，请指定要保留在 CustomerShare 对象的 CustomerAccountShares 元素中的 客户帐户共享 。 |
CustomerShare |
| 说明 | 受众的说明。 使用说明来帮助你记住你面向的受众。 说明最多可以包含 1,024 个字符。 加： 自选 更新： 自选。 如果未为更新设置任何值，则不会更改此设置。 |
string |
| ForwardCompatibilityMap | 用于向前兼容性的键和值字符串列表，以避免在当前 API 版本中添加新元素时发生重大更改。 将来的版本中将在此处记录向前兼容性更改。 目前没有针对 Audience 对象的向前兼容性更改。 |
KeyValuePairOfstringstring 数组 |
| ID | 受众Microsoft广告标识符。 加： 只读 更新： 必需和只读 |
long |
| MembershipDuration | 创建受众时，可以指定Microsoft广告应查找与受众定义匹配的操作的时间。 最短持续时间为 1 天，允许的最大持续时间为 390 天。 对于没有过期，还可以将持续时间设置为 -1。 加： 自选。 如果未指定，则默认情况下，成员资格持续时间将设置为 30。 更新： 自选。 如果未为更新设置任何值，则不会更改此设置。 |
int |
| 名称 | 访问群体的名称。 该名称最多可包含 128 个字符。 加： 必填 更新： 自选。 如果未为更新设置任何值，则不会更改此设置。 |
string |
| ParentId | 帐户或客户的Microsoft广告标识符。 如果 “作用域 ”设置为 “帐户”，则这是帐户 ID，否则为客户 ID。 加： 必填 更新： 只读。 不能更改父 ID。 |
long |
| 范围 | 作用域定义哪些帐户可以使用此受众。 如果范围设置为 “帐户”，则受众只能与一个帐户中的市场活动和广告组相关联，即通过 ParentId。 如果范围设置为 “客户”，则受众可以与客户所有帐户中的市场活动和广告组相关联。 加： 必填 更新： 自选。 可以将范围从“帐户”更改为“客户”，但不能将范围从“客户”更改为“帐户”。 |
EntityScope |
| SearchSize | 搜索网络中此受众的活动成员的总数。 这样就可以了解可以面向多少搜索用户。 受众至少需要有 300 人，Microsoft广告将使用它进行优化。 在生成受众时，此属性将最多为零或空 48 小时，例如，如果添加或更新客户列表成员身份持续时间。 加： 只读 更新： 只读 |
long |
| SupportedCampaignTypes | 支持此受众的市场活动类型列表。 支持的值为 Audience、DynamicSearchAds、Search 和 Shopping。 将来可能会添加新的市场活动类型，因此不应依赖于一组固定值。 加： 只读 更新： 只读 |
字符串 数组 |
| 类型 | 访问群体的类型。 检索客户列表访问群体时，此值为 CustomerList 。 有关访问群体类型的详细信息，请参阅 访问群体数据对象备注。 加： 只读 更新： 只读 |
AudienceType |
要求
服务： CampaignManagementService.svc v13
Namespace： https://bingads.microsoft.com/CampaignManagement/v13