通过

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

  • 项目

定义再营销列表。

提示

有关实现概述，请参阅 通用事件跟踪 技术指南。

注意

如果你是试点参与者，Microsoft广告将自动为再营销列表生成类似的受众。 不能为再营销列表创建或编辑类似的受众。 话虽如此，可以添加和删除类似的再营销列表关联和排除项。 如果删除源再营销列表，也会删除类似的受众。 如果类似的受众与市场活动或广告组相关联，则无法删除源再营销列表。 有关更多详细信息，请参阅 SimilarRemarketingList 。

语法

<xs:complexType name="RemarketingList" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Audience">
      <xs:sequence>
        <xs:element minOccurs="0" name="Rule" nillable="true" type="tns:RemarketingRule" />
        <xs:element minOccurs="0" name="TagId" nillable="true" type="xs:long" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

元素

RemarketingList 对象具有以下元素：Rule、TagId。

元素 说明 数据类型
Rule 规则包含用于确定要添加到再营销列表的人员的条件。

可以选择以下四种类型的规则之一来面向不同的访问群体： CustomEventsRule、 PageVisitorsRule、 PageVisitorsWhoDidNotVisitAnotherPageRule 和 PageVisitorsWhoVisitedAnotherPageRule。

加： 必填
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。 如果要保留任何以前的规则项，则必须在更新期间再次显式设置它们。 可以选择在更新期间更改规则的类型。		 RemarketingRule
TagId 与再营销列表一起使用的通用事件跟踪 (UET) 标记的Microsoft广告标识符。

在依赖标记 ID 之前，请注意，UET 标记可以与其他客户共享或从其他客户共享。 共享 UET 标记和访问群体仅适用于试点客户。 有关在客户层次结构中共享访问群体和 UET 标记的概述，请参阅 共享受众和 UET 标记 技术指南。

加： 必填
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。		 long

RemarketingList 对象具有 Inherited Elements。

继承的元素

从受众继承的元素

RemarketingList 对象派生自 Audience 对象，并继承以下元素：AudienceNetworkSize、CustomerShare、Description、ForwardCompatibilityMap、Id、MembershipDuration、Name、ParentId、Scope、SearchSize、SupportedCampaignTypes、Type。 下面的说明特定于 RemarketingList，可能不适用于从 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 天，允许的最大持续时间为 180 天。

加： 自选。 如果未指定，则默认情况下，成员资格持续时间将设置为 30。
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。		 int
名称 访问群体的名称。 该名称最多可包含 128 个字符。

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

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

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

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

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

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

在构建受众时，此属性最多为零或为空，例如，添加或更新再营销列表成员资格持续时间、规则或标记标识符。

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

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

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

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

加： 只读
更新： 只读		 AudienceType

要求

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