Rule Conditions and Functions

Describes all dynamic tag management rule conditions and their functions.

Custom Script in a Rule Condition

When using custom code in rule conditions for a page load rule, you must use the boolean return true when you want the rule to fire.

Conditions and Functions

The following table describes condition types, conditions, functions, and applicable notes:

Condition Type Condition Function Notes

URL

Protocol

Indicate rule to fire on HTTP or HTTPS.

Subdomain

Indicate rule to fire or not fire on specified subdomain(s).

Enable regex on this condition to include multiple scenarios in a single condition.

Path

Indicate rule to fire or not fire on specified URL path(s).

Enable regex on this condition to include multiple scenarios in a single condition.

The path condition functions based on the _satellite.data.URI, which is inclusive of query params.

Parameter

Indicate rule to fire if specific URL parameter(s) with specific values are present.

Enable regex on this condition to include multiple scenarios in a single condition.

Technology

Cookie Opt-out

Indicate rule to fire only if user accepts cookies based on presence of sat_track cookie that is set to 'true'

Requires data element setup.

Cookie can be given custom name on the Edit Property page.

Browser

Indicate rule to fire only in specified browsers.

Operating System

Indicate rule to fire only in specified operating systems.

Device Type

Indicate rule to fire only on specified devices.

Screen Resolution

Indicate rule to fire within specified screen-resolution ranges.

Window Size

Indicate rule to fire within specified window-size ranges.

Engagement

Traffic Source

Indicate rule to fire if visit came from specified source.

Enable regex on this condition to include multiple scenarios in a single condition.

Landing Page

Indicate rule to fire if visit landed on specified page(s).

Enable regex on this condition to include multiple scenarios in a single condition.

New/Returning Visitor

Indicate rule to fire only if new/returning visit.

Sessions

Indicate rule to fire if visitor has had >, =, or < specified number of sessions.

Page Views

Indicate rule to fire if visitor has had >, =, or < specified number of page views in this session or all sessions.

Time on Site

Indicate rule to fire if visit persists for specified # of minutes.

Registered User

Indicate rule to fire based on user registration status as indicated in data element. If the indicated data element has a value, then the condition evaluates as "true" (does not include the default value).

Requires data element setup.

Logged In

Indicate rule to fire if user is / is not logged in as indicated in data element. If the indicated data element has a value, then the condition evaluates as "true" (does not include the default value).

Requires data element setup.

Previous Converter

Indicate rule to fire if user is / is not a previous converter as indicated data element. If the indicated data element has a value, then the condition evaluates as "true" (does not include the default value).

Requires data element setup.

Cart Item Quantity

Indicate rule to fire if user has certain number of items in cart as indicated in data element.

Requires data element setup.

Cart Amount

Indicate rule to fire if user has certain dollar value in cart as indicated in data element.

Requires data element setup.

Data

Cookie

Indicate rule to fire if specified cookie with specified value is present.

Enable regex on this condition to include multiple scenarios in a single condition.

Data Element Value

Indicate rule to fire if specified data element with specified value is present.

Requires data element setup.

Enable regex on this condition to include multiple scenarios in a single condition.

Variable Set

Indicate rule to fire if specified JS object with specified value is present. It may be necessary to prefix the object path with the appropriate scope depending on the scenario - 'this.', 'event.', 'target.', 'window.', or 'param.'

Enable regex on this condition to include multiple scenarios in a single condition.

Custom

Opens a blank text box to input custom script.