受众数据对象 - 市场活动管理
定义访问群体的基本对象。
不要尝试实例化 受众。 可以创建派生自它的一个或多个以下对象。
- CombinedList
- CustomAudience
- CustomerList
- ImpressionBasedRemarketingList
- InMarketAudience
- ProductAudience
- RemarketingList
- SimilarRemarketingList
注意
Microsoft广告将为试点参与者的再营销列表自动生成类似的受众，即 GetCustomerPilotFeatures 返回功能标识符 317。
语法
<xs:complexType name="Audience" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:sequence>
<xs:element minOccurs="0" name="AudienceNetworkSize" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="CustomerShare" nillable="true" type="tns:CustomerShare" />
<xs:element minOccurs="0" name="Description" nillable="true" type="xs:string" />
<xs:element xmlns:q124="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q124:ArrayOfKeyValuePairOfstringstring" />
<xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="MembershipDuration" nillable="true" type="xs:int" />
<xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="ParentId" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="Scope" nillable="true" type="tns:EntityScope" />
<xs:element minOccurs="0" name="SearchSize" nillable="true" type="xs:long" />
<xs:element xmlns:q125="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="SupportedCampaignTypes" nillable="true" type="q125:ArrayOfstring" />
<xs:element minOccurs="0" name="Type" type="tns:AudienceType" />
</xs:sequence>
</xs:complexType>
元素
Audience 对象具有以下元素：AudienceNetworkSize、CustomerShare、Description、ForwardCompatibilityMap、Id、MembershipDuration、Name、ParentId、Scope、SearchSize、SupportedCampaignTypes、Type。
| 元素 | 说明 | 数据类型 |
|---|---|---|
| AudienceNetworkSize | 在受众网络中是此受众的活跃成员的总数。 这让你了解可以面向多少受众网络用户。 有关继承此元素的对象（例如 RemarketingList），请参阅文档中的更多详细信息。 |
long |
| CustomerShare | 确定共享受众的客户和帐户的列表。 详细信息包括访问群体关联计数。 仅 RemarketingList 支持此元素。 其他类型的访问群体不能在客户层次结构中共享。 |
CustomerShare |
| 说明 | 受众的说明。 使用说明来帮助你记住你面向的受众。 说明最多可以包含 1,024 个字符。 |
string |
| ForwardCompatibilityMap | 用于向前兼容性的键和值字符串列表，以避免在当前 API 版本中添加新元素时发生重大更改。 将来的版本中将在此处记录向前兼容性更改。 此对象当前没有向前兼容性更改。 |
KeyValuePairOfstringstring 数组 |
| ID | 受众Microsoft广告标识符。 | long |
| MembershipDuration | 创建受众时，可以指定Microsoft广告应查找与受众定义匹配的操作的时间。 最短持续时间为 1 天，允许的最大持续时间为 180 天。 |
int |
| 名称 | 访问群体的名称。 该名称最多可包含 128 个字符。 | string |
| ParentId | 帐户或客户的Microsoft广告标识符。 如果 “作用域 ”设置为 “帐户”，则这是帐户 ID，否则为客户 ID。 |
long |
| 范围 | 作用域定义哪些帐户可以使用此受众。 如果范围设置为 “帐户”，则受众只能与一个帐户中的市场活动和广告组相关联，即通过 ParentId。 如果范围设置为 “客户”，则受众可以与客户所有帐户中的市场活动和广告组相关联。 |
EntityScope |
| SearchSize | 搜索网络中此受众的活动成员的总数。 这样就可以了解可以面向多少搜索用户。 有关继承此元素的对象（例如 RemarketingList），请参阅文档中的更多详细信息。 |
long |
| SupportedCampaignTypes | 支持此受众的市场活动类型列表。 支持的值为 Audience、DynamicSearchAds、Search 和 Shopping。 将来可能会添加新的市场活动类型，因此不应依赖于一组固定值。 |
字符串 数组 |
| 类型 | 访问群体的类型。 有关访问群体类型的详细信息，请参阅 备注。 | AudienceType |
备注
对于 Java 和 .NET 语言，请勿设置 Type 元素，因为该值取决于是实例化自定义访问群体还是其他类型的访问群体。 如果手动生成 SOAP，请使用“受众”节点的 type 属性，如以下示例所示。
<Audiences xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<Audience i:type="CustomAudience">
<Description i:nil="false">Custom Audience Description</Description>
<ForwardCompatibilityMap xmlns:e43="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
<e43:KeyValuePairOfstringstring>
<e43:key i:nil="false"></e43:key>
<e43:value i:nil="false"></e43:value>
</e43:KeyValuePairOfstringstring>
</ForwardCompatibilityMap>
<Id i:nil="true" />
<MembershipDuration i:nil="false">30</MembershipDuration>
<Name i:nil="false">Custom Audience Name</Name>
<ParentId i:nil="false">ParentIdHere</ParentId>
<Scope>Customer</Scope>
</Audience>
</Audiences>
要求
服务： CampaignManagementService.svc v13
Namespace： https://bingads.microsoft.com/CampaignManagement/v13