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

定义与再营销列表之一类似的受众。

不能为再营销列表创建或编辑类似的受众。 话虽如此，可以添加和删除类似的再营销列表关联和排除项。 如果删除源再营销列表，也会删除类似的受众。 如果类似的受众与市场活动或广告组相关联，则无法删除源再营销列表。

注意

必须至少有一个与至少 1,000 名用户有活动关联的再营销列表，Microsoft广告才能生成类似的受众。

类似的受众需要在搜索网络或Microsoft受众网络上至少有 300 个用户，然后才能将其与活动市场活动或广告组相关联。

类似的受众最多需要 24 小时才能生成，目标受众在该时间点之前不会生效。

语法

XML

<xs:complexType name="SimilarRemarketingList" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Audience">
      <xs:sequence>
        <xs:element minOccurs="0" name="SourceId" type="xs:long" />
      </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": "SimilarRemarketingList",
  "SourceId": "LongValueHere"
}

元素

SimilarRemarketingList 对象具有以下元素：SourceId。

元素	说明	数据类型
SourceId	Microsoft广告用于生成此类似受众的再营销列表Microsoft广告标识符。 加： 不支持 更新： 不支持	long

SimilarRemarketingList 对象具有 Inherited Elements。

继承的元素

从受众继承的元素

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

元素	说明	数据类型
AudienceNetworkSize	在受众网络中是此受众的活跃成员的总数。 这让你了解可以面向多少受众网络用户。 受众至少需要有 300 人，Microsoft广告将使用它进行优化。 类似受众的受众网络大小可能与 源 再营销列表的受众网络大小不同。 加： 不支持 更新： 不支持	long
CustomerShare	类似的再营销列表不支持此元素。 加： 不支持 更新： 不支持	CustomerShare
说明	此元素不适用于类似的受众。 加： 不支持 更新： 不支持	string
ForwardCompatibilityMap	用于向前兼容性的键和值字符串列表，以避免在当前 API 版本中添加新元素时发生重大更改。 将来的版本中将在此处记录向前兼容性更改。 目前没有针对 Audience 对象的向前兼容性更改。 加： 不支持 更新： 不支持	KeyValuePairOfstringstring 数组
ID	类似受众Microsoft广告标识符。 加： 不支持 更新： 不支持	long
MembershipDuration	此元素不适用于类似的受众。 加： 不支持 更新： 不支持	int
名称	类似受众的名称由Microsoft广告设置。 该名称最多可包含 128 个字符。 加： 不支持 更新： 不支持	string
ParentId	帐户或客户的Microsoft广告标识符。 如果 “作用域 ”设置为 “帐户”，则这是帐户 ID，否则为客户 ID。 加： 不支持 更新： 不支持	long
范围	作用域定义哪些帐户可以使用此受众。 类似受众的范围会自动设置为 源 再营销列表的范围。 如果范围设置为 “帐户”，则受众只能与一个帐户中的市场活动和广告组相关联，即通过 ParentId。 如果范围设置为 “客户”，则受众可以与客户所有帐户中的市场活动和广告组相关联。 加： 不支持 更新： 不支持	EntityScope
SearchSize	搜索网络中此受众的活动成员的总数。 这样就可以了解可以面向多少搜索用户。 受众至少需要有 300 人，Microsoft广告将使用它进行优化。 类似受众的搜索大小可能与 源 再营销列表的搜索大小不同。 在生成源再营销列表（例如，添加或更新源再营销列表的再营销列表成员身份持续时间、规则或标记标识符）时，此属性将最多为零或空 24 小时。 如果与 源 再营销列表关联的 UET 标记的状态为“未验证”或“非活动”，则此属性将为零或空，因为再营销列表无法从您的网站接收生成列表所需的客户信息。 加： 不支持 更新： 不支持	long
SupportedCampaignTypes	支持此受众的市场活动类型列表。 支持的值为 Audience、DynamicSearchAds、Search 和 Shopping。 将来可能会添加新的市场活动类型，因此不应依赖于一组固定值。 加： 不支持 更新： 不支持	字符串 数组
类型	访问群体的类型。 检索再营销列表的类似受众时，此值为 SimilarRemarketingList 。 有关访问群体类型的详细信息，请参阅 访问群体数据对象备注。 加： 不支持 更新： 不支持	AudienceType

要求

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