PageVisitorsWhoVisitedAnotherPageRule Data Object - Campaign Management

Defines a page visitors who visited another page remarketing rule.

Remarketing rules are conditions used to determine who to add to your remarketing list. For the PageVisitorsWhoVisitedAnotherPage rule, you must include one or more rule item groups for the page visited (RuleItemGroups), and you must also include one or more rule item groups for another page that must have been visited (AnotherRuleItemGroups).

For each rule item group within RuleItemGroups, the rule item conditions for the same page are joined using the logical AND operator. Then, each result from the list of rule item groups are joined using the logical OR operator.

Likewise for each rule item group within AnotherRuleItemGroups, the rule item conditions for the same page are joined using the logical AND operator. Then, each result from the list of rule item groups are joined using the logical OR operator.

In other words the visitor will be added to your remarketing list if any of the rule item group conditions are met, and any of the another rule item group conditions are met.

For a detailed example, see the Remarks section below.

Syntax

<xs:complexType name="PageVisitorsWhoVisitedAnotherPageRule" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:RemarketingRule">
      <xs:sequence>
        <xs:element minOccurs="0" name="AnotherRuleItemGroups" nillable="true" type="tns:ArrayOfRuleItemGroup" />
        <xs:element minOccurs="0" name="RuleItemGroups" nillable="true" type="tns:ArrayOfRuleItemGroup" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elements

Element Description Data Type
AnotherRuleItemGroups The list of rule item groups related to other pages the audience visited.

The maximum number of rule item groups in this element is 100. The maximum number of rule items per rule item group is 100.

Add: Required
Update: Required. If you want to keep any of the previous rule item groups, then you must explicitly set them again during update.
RuleItemGroup array
RuleItemGroups The list of rule item groups related to pages the audience visited.

The maximum number of rule item groups in this element is 100. The maximum number of rule items per rule item group is 100.

Add: Required
Update: Required. If you want to keep any of the previous rule item groups, then you must explicitly set them again during update.
RuleItemGroup array

The PageVisitorsWhoVisitedAnotherPageRule object has Inherited Elements.

Inherited Elements

Inherited Elements from RemarketingRule

The PageVisitorsWhoVisitedAnotherPageRule object derives from the RemarketingRule object, and inherits the following elements. The descriptions below are specific to PageVisitorsWhoVisitedAnotherPageRule, and might not apply to other objects that inherit the same elements from the RemarketingRule object.

Element Description Data Type
Type The type of the remarketing rule. For more information about remarketing rule types, see the RemarketingRule Data Object Remarks.

Add: Read-only
Update: Read-only
string

Remarks

Remarketing rules are conditions used to determine who to add to your remarketing list. For the PageVisitorsWhoVisitedAnotherPage rule, you must include one or more rule item groups for the page visited (RuleItemGroups), and you must also include one or more rule item groups for another page that must have been visited (AnotherRuleItemGroups).

For each rule item group within RuleItemGroups, the rule item conditions for the same page are joined using the logical AND operator. Then, each result from the list of rule item groups are joined using the logical OR operator.

Likewise for each rule item group within AnotherRuleItemGroups, the rule item conditions for the same page are joined using the logical AND operator. Then, each result from the list of rule item groups are joined using the logical OR operator.

In other words the visitor will be added to your remarketing list if any of the rule item group conditions are met, and any of the another rule item group conditions are met.

For example let's say that the following rule item groups are set.

<Rule i:type="PageVisitorsWhoVisitedAnotherPageRule">
  <Type i:nil="true" />
  <AnotherRuleItemGroups>
    <RuleItemGroup>
      <Items>
        <RuleItem i:type="StringRuleItem">
          <Type i:nil="true" />
          <Operand>Url</Operand>
          <Operator>BeginsWith</Operator>
          <Value>A</Value>
        </RuleItem>
        <RuleItem i:type="StringRuleItem">
          <Type i:nil="true" />
          <Operand>ReferrerUrl</Operand>
          <Operator>BeginsWith</Operator>
          <Value>B</Value>
        </RuleItem>
      </Items>
    </RuleItemGroup>
    <RuleItemGroup>
      <Items>
        <RuleItem i:type="StringRuleItem">
          <Type i:nil="true" />
          <Operand>Url</Operand>
          <Operator>Contains</Operator>
          <Value>C</Value>
        </RuleItem>
      </Items>
    </RuleItemGroup>
  </AnotherRuleItemGroups>
  <RuleItemGroups>
    <RuleItemGroup>
      <Items>
        <RuleItem i:type="StringRuleItem">
          <Type i:nil="true" />
          <Operand>Url</Operand>
          <Operator>Contains</Operator>
          <Value>X</Value>
        </RuleItem>
        <RuleItem i:type="StringRuleItem">
          <Type i:nil="true" />
          <Operand>ReferrerUrl</Operand>
          <Operator>DoesNotContain</Operator>
          <Value>Z</Value>
        </RuleItem>
      </Items>
    </RuleItemGroup>
    <RuleItemGroup>
      <Items>
        <RuleItem i:type="StringRuleItem">
          <Type i:nil="true" />
          <Operand>Url</Operand>
          <Operator>DoesNotBeginWith</Operator>
          <Value>Y</Value>
        </RuleItem>
      </Items>
    </RuleItemGroup>
    <RuleItemGroup>
      <Items>
        <RuleItem i:type="StringRuleItem">
          <Type i:nil="true" />
          <Operand>ReferrerUrl</Operand>
          <Operator>Equals</Operator>
          <Value>Z</Value>
        </RuleItem>
      </Items>
    </RuleItemGroup>
  </RuleItemGroups>
</Rule>

The above definition is translated to the following logical expression:

(((Url Contains X) and (ReferrerUrl NotEquals Z)) or ((Url DoesNotBeginWith Y)) or ((ReferrerUrl Equals Z))) and (((Url BeginsWith A) and (ReferrerUrl BeginsWith B)) or ((Url Contains C)))

Evaluation of the logical expression determines which of the following example users will be added to the remarketing list.

User Url Visited Referrer Url Added to List
User 1 A
X No. Evaluation of the logical expression results as False.

(((Url Contains X) and (ReferrerUrl NotEquals Z)) or ((Url DoesNotBeginWith Y)) or ((ReferrerUrl Equals Z))) and (((Url BeginsWith A) and (ReferrerUrl BeginsWith B)) or ((Url Contains C)))

((False and True) or (True) or (False)) and ((True and False) or (False))

(False or True or False) and (False or False)

True and False

False
User 2 B
Y No. Evaluation of the logical expression results as False.

(((Url Contains X) and (ReferrerUrl NotEquals Z)) or ((Url DoesNotBeginWith Y)) or ((ReferrerUrl Equals Z))) and (((Url BeginsWith A) and (ReferrerUrl BeginsWith B)) or ((Url Contains C)))

((False and True) or (True) or (False)) and ((False and False) or (False))

(False or True or False) and (False or False)

True and False
False
User 3 C
Z Yes. Evaluation of the logical expression results as True.

(((Url Contains X) and (ReferrerUrl NotEquals Z)) or ((Url DoesNotBeginWith Y)) or ((ReferrerUrl Equals Z))) and (((Url BeginsWith A) and (ReferrerUrl BeginsWith B)) or ((Url Contains C)))

((False and True) or (True) or (True)) and ((False and False) or (True))

(False or True or True) and (False or True)

True and True

True

Requirements

Service: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13