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

定义自定义受众。

注意

仅支持更新 “名称” 和 “说明 ”。 可以使用必应广告 API 删除但不能添加自定义受众。 话虽如此，可以添加和删除自定义受众关联和排除项。

自定义受众是使用自己的客户数据创建更丰富的用户细分而生成的一种再营销列表。 可以将自定义受众与再营销列表结合使用，通常通过数据管理提供程序 (DMP) 。 当 DMP 连接到我们的自定义受众功能时，你可以将自定义受众导入Microsoft广告中，以便进行搜索再营销。 可以独立于再营销使用自定义受众，无需 UET。

提示

有关自定义访问群体的概述，请参阅 关于自定义访问群体 帮助主题。

语法

XML

<xs:complexType name="CustomAudience" 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>

JSON

{
  "AudienceNetworkSize": "LongValueHere",
  "CustomerShare": {
    "CustomerAccountShares": [
      {
        "AccountId": "LongValueHere",
        "Associations": [
          {
            "AssociationCount": "LongValueHere",
            "UsageType": "ValueHere"
          }
        ],
        "CustomerId": "LongValueHere"
      }
    ],
    "OwnerCustomerId": "LongValueHere"
  },
  "Description": "ValueHere",
  "ForwardCompatibilityMap": [
    {
      "key": "ValueHere",
      "value": "ValueHere"
    }
  ],
  "Id": "LongValueHere",
  "MembershipDuration": IntValueHere,
  "Name": "ValueHere",
  "ParentId": "LongValueHere",
  "Scope": "ValueHere",
  "SearchSize": "LongValueHere",
  "SupportedCampaignTypes": [
    "ValueHere"
  ],
  "Type": "Custom"
}

元素

CustomAudience 对象具有 Inherited Elements。

继承的元素

从受众继承的元素

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

元素	说明	数据类型
AudienceNetworkSize	在受众网络中是此受众的活跃成员的总数。 这让你了解可以面向多少受众网络用户。 受众至少需要有 300 人，Microsoft广告将使用它进行优化。 加： 不支持 更新： 只读	long
CustomerShare	自定义访问群体不支持此元素。 加： 不支持 更新： 不支持	CustomerShare
说明	受众的说明。 使用说明来帮助你记住你面向的受众。 说明最多可以包含 1,024 个字符。 加： 不支持 更新： 自选。 如果未为更新设置任何值，则不会更改此设置。 若要删除以前的设置，请将此 elemment 设置为空字符串值 (“”) 。	string
ForwardCompatibilityMap	用于向前兼容性的键和值字符串列表，以避免在当前 API 版本中添加新元素时发生重大更改。 将来的版本中将在此处记录向前兼容性更改。 目前没有针对 Audience 对象的向前兼容性更改。	KeyValuePairOfstringstring 数组
ID	受众Microsoft广告标识符。 加： 不支持 更新： 必需和只读	long
MembershipDuration	成员资格持续时间决定了广告Microsoft应查找与自定义受众定义匹配的操作，以便将人员添加到列表中。 对于自定义受众，不会在 Microsoft Advertising Web 应用程序中设置成员资格持续时间，并且Microsoft广告会遵循自定义受众提供商设置。 通过必应广告 API 请求自定义受众时，返回的成员身份持续时间将为 null。 加： 不支持 更新： 不支持	int
名称	访问群体的名称。 该名称最多可包含 128 个字符。 加： 不支持 更新： 自选。 如果未为更新设置任何值，则不会更改此设置。	string
ParentId	包含自定义受众的客户Microsoft广告标识符。 加： 不支持 更新： 不支持	long
范围	作用域定义哪些帐户可以使用此受众。 对于自定义受众，唯一支持的范围是 “客户”，并且受众可以与所有客户帐户中的市场活动和广告组相关联。 加： 不支持 更新： 不支持	EntityScope
SearchSize	搜索网络中此受众的活动成员的总数。 这样就可以了解可以面向多少搜索用户。 受众至少需要有 300 人，Microsoft广告将使用它进行优化。 在生成访问群体时，此属性最多为零或空 24 小时，例如，如果已从 DMP 导入了新的自定义访问群体，则生成访问群体需要 24 小时，在此期间，此属性将为零或空。 加： 不支持 更新： 只读	long
SupportedCampaignTypes	支持此受众的市场活动类型列表。 支持的值为 Audience、DynamicSearchAds、Search 和 Shopping。 将来可能会添加新的市场活动类型，因此不应依赖于一组固定值。 加： 不支持 更新： 只读	字符串 数组
类型	访问群体的类型。 检索 自定义 受众时，此值为“自定义”。 有关访问群体类型的详细信息，请参阅 访问群体数据对象备注。 加： 不支持 更新： 只读	AudienceType

要求

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