通过

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

  • 项目

定义自定义事件再营销规则。

再营销规则是用于确定要添加到再营销列表的人员的条件。 对于自定义事件规则，必须包含以下一个或多个条件事件运算符对： (ActionOperator 和 Action) 、 (CategoryOperator 和 Category) 、 (LabelOperator 和 Label) 、 (ValueOperator 和 Value) 。 如果指定了多个条件，则使用逻辑 AND 运算符联接这些条件。 换句话说，只有在满足所有指定的规则条件时，才会将访问者添加到再营销列表。

有关详细示例，请参阅下面的 “备注 ”部分。

语法

<xs:complexType name="CustomEventsRule" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:RemarketingRule">
      <xs:sequence>
        <xs:element minOccurs="0" name="Action" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="ActionOperator" type="tns:StringOperator" />
        <xs:element minOccurs="0" name="Category" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="CategoryOperator" type="tns:StringOperator" />
        <xs:element minOccurs="0" name="Label" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="LabelOperator" type="tns:StringOperator" />
        <xs:element minOccurs="0" name="Value" nillable="true" type="xs:decimal" />
        <xs:element minOccurs="0" name="ValueOperator" type="tns:NumberOperator" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

元素

CustomEventsRule 对象具有以下元素：Action、ActionOperator、Category、CategoryOperator、Label、LabelOperator、Value、ValueOperator。

元素 说明 数据类型
操作 要跟踪的用户交互的类型。例如“播放”或“暂停”。

如果在添加或更新操作期间指定了此元素，则还需要 ActionOperator 元素。

加： 如果包含一个或多个其他事件，则为可选;必须包含以下一个或多个事件运算符对： (ActionOperator 和 Action) 、 (CategoryOperator 和 Category) 、 (LabelOperator 和 Label) 、 (ValueOperator 和 Value) 。
更新： 如果包含一个或多个其他事件，则为可选;如果在更新期间未包括 ActionOperator 和 Action ，则将删除任何现有的 ActionOperator 和 Action 设置。		 string
ActionOperator 可应用于 Action 元素的值的运算符。

如果在添加或更新操作期间指定了此元素，则 还需要 Action 元素。

加： 如果包含一个或多个其他事件，则为可选;必须包含以下一个或多个事件运算符对： (ActionOperator 和 Action) 、 (CategoryOperator 和 Category) 、 (LabelOperator 和 Label) 、 (ValueOperator 和 Value) 。
更新： 如果包含一个或多个其他事件，则为可选;如果在更新期间未包括 ActionOperator 和 Action ，则将删除任何现有的 ActionOperator 和 Action 设置。		 StringOperator
类别 要跟踪的事件类别。例如，“video”。

如果在添加或更新操作期间指定了此元素，则 还需要 CategoryOperator 元素。

加： 如果包含一个或多个其他事件，则为可选;必须包含以下一个或多个事件运算符对： (ActionOperator 和 Action) 、 (CategoryOperator 和 Category) 、 (LabelOperator 和 Label) 、 (ValueOperator 和 Value) 。
更新： 如果包含一个或多个其他事件，则为可选;如果在更新期间未包括 CategoryOperator 和 Category ，则将删除任何现有的 CategoryOperator 和 Category 设置。		 string
CategoryOperator 可应用于 Category 元素的值的运算符。

加： 如果包含一个或多个其他事件，则为可选;必须包含以下一个或多个事件运算符对： (ActionOperator 和 Action) 、 (CategoryOperator 和 Category) 、 (LabelOperator 和 Label) 、 (ValueOperator 和 Value) 。
更新： 如果包含一个或多个其他事件，则为可选;如果在更新期间未包括 CategoryOperator 和 Category ，则将删除任何现有的 CategoryOperator 和 Category 设置。		 StringOperator
标签 导致操作的元素的名称。 例如“trailer”或“behindthescenes”。

如果在添加或更新操作期间指定了此元素，则还需要 LabelOperator 元素。

加： 如果包含一个或多个其他事件，则为可选;必须包含以下一个或多个事件运算符对： (ActionOperator 和 Action) 、 (CategoryOperator 和 Category) 、 (LabelOperator 和 Label) 、 (ValueOperator 和 Value) 。
更新： 如果包含一个或多个其他事件，则为可选;如果在更新期间未包括 LabelOperator 和 Label ，则将删除任何现有的 LabelOperator 和 Label 设置。		 string
LabelOperator 可应用于 Label 元素值的运算符。

加： 如果包含一个或多个其他事件，则为可选;必须包含以下一个或多个事件运算符对： (ActionOperator 和 Action) 、 (CategoryOperator 和 Category) 、 (LabelOperator 和 Label) 、 (ValueOperator 和 Value) 。
更新： 如果包含一个或多个其他事件，则为可选;如果在更新期间未包括 LabelOperator 和 Label ，则将删除任何现有的 LabelOperator 和 Label 设置。		 StringOperator
值 与该事件关联的正整数值。 例如，该值可以是视频播放的持续时间。

如果在添加或更新操作期间指定了此元素，则还需要 ValueOperator 元素。

加： 如果包含一个或多个其他事件，则为可选;必须包含以下一个或多个事件运算符对： (ActionOperator 和 Action) 、 (CategoryOperator 和 Category) 、 (LabelOperator 和 Label) 、 (ValueOperator 和 Value) 。
更新： 如果包含一个或多个其他事件，则为可选;如果在更新过程中不包括 ValueOperator 和 Value ，则将删除任何现有的 ValueOperator 和 Value 设置		 十进制
ValueOperator 可应用于 Value 元素的值的运算符。

加： 如果包含一个或多个其他事件，则为可选;必须包含以下一个或多个事件运算符对： (ActionOperator 和 Action) 、 (CategoryOperator 和 Category) 、 (LabelOperator 和 Label) 、 (ValueOperator 和 Value) 。
更新： 如果包含一个或多个其他事件，则为可选;如果在更新过程中不包括 ValueOperator 和 Value ，则将删除任何现有的 ValueOperator 和 Value 设置。		 NumberOperator

CustomEventsRule 对象具有 Inherited Elements。

继承的元素

从 RemarketingRule 继承的元素

CustomEventsRule 对象派生自 RemarketingRule 对象，并继承以下元素：类型。 以下说明特定于 CustomEventsRule，可能不适用于从 RemarketingRule 对象继承相同元素的其他对象。

元素 说明 数据类型
类型 再营销规则的类型。 有关再营销规则类型的详细信息，请参阅 RemarketingRule 数据对象备注。

加： 只读
更新： 只读		 string

备注

对于 CustomEvents 规则，必须包含以下一个或多个条件事件运算符对： (ActionOperator 和 Action) 、 (CategoryOperator 和 Category) 、 (LabelOperator 和 Label) 、 (ValueOperator 和 Value) 。 如果指定了多个条件，则使用逻辑 AND 运算符联接这些条件。 换句话说，只有在满足所有指定的规则条件时，才会将访问者添加到再营销列表。

例如，假设设置了以下自定义事件。

<Rule i:type="CustomEventsRule">
  <Type i:nil="true" />
  <Action>play</Action>
  <ActionOperator>Equals</ActionOperator>
  <Category>video</Category>
  <CategoryOperator>Equals</CategoryOperator>
  <Label>trailer</Label>
  <LabelOperator>Equals</LabelOperator>
  <Value>5.00</Value>
  <ValueOperator>Equals</ValueOperator>
</Rule>

上述定义将转换为以下逻辑表达式：

(类别等于视频) 和 (操作等于播放) 和 (标签等于尾部) 和 (值等于 5)

计算逻辑表达式确定将添加到再营销列表的人员。

要求

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