1. Audiences

Audience rule comparators

Important

Feature availability is part of a phased rollout. Your organization may not see this functionality yet. It will become available when your environment is included in the rollout.

When you create or edit an audience, you select a comparator for each audience rule. A comparator defines how the selected attribute value is matched.

For example, if you select the Email attribute, you can use the contains comparator to match profiles whose email address includes a specific domain.

The available comparators can have the type String, Number, Boolean, Date, and Other.

The available comparators depend on the selected attribute and are grouped by value type: String, Number, Boolean, Date, and Other.

String comparators

Use string comparators to match text values.

ComparatorDescription
is equal toMatches the exact text value.
is not equal toExcludes the exact text value.
is inMatches any value in a list of text values.
is not inExcludes values in a list of text values.
containsMatches text that includes the specified value.
does not containExcludes text that includes the specified value.
starts withMatches text that begins with the specified value.
does not start withExcludes text that begins with the specified value.
ends withMatches text that ends with the specified value.
does not end withExcludes text that ends with the specified value.
is nullMatches when no value exists.
is not nullMatches when a value exists.

Number comparators

Use number comparators to match numeric values.

ComparatorDescription
is equal toMatches the specified number.
is not equal toExcludes the specified number.
is greater thanMatches values greater than the specified number.
is greater than or equal toMatches values greater than or equal to the specified number.
is less thanMatches values less than the specified number.
is less than or equal toMatches values less than or equal to the specified number.
is betweenMatches values within a range.
is not in betweenMatches values outside a range.
is nullMatches when no value exists.
is not nullMatches when a value exists.

Boolean comparators

Use Boolean comparators to match true or false values.

ComparatorDescription
is trueMatches when the value is true.
is falseMatches when the value is false.
is nullMatches when no value exists.
is not nullMatches when a value exists.

Date comparators

Use date comparators to match time-based attribute values.

Note

Date comparisons use UTC, not your organization’s local timezone. This can affect results near day boundaries.

ComparatorDescription
is in the pastMatches dates within a specified past time period.
is not in the pastExcludes dates within a specified past time period.
is in the nextMatches dates within a specified future time period.
is not in the nextExcludes dates within a specified future time period.
is now plusMatches dates after the current date by a specified amount of time.
is now minusMatches dates before the current date by a specified amount of time.
is on the dayMatches the specified date.
is not on the dayExcludes the specified date.
is betweenMatches dates within a specified range.
is not in betweenMatches dates outside a specified range.
is beforeMatches dates earlier than the specified date.
is afterMatches dates later than the specified date.
is in the yearMatches dates in the specified year.
is not in the yearExcludes dates in the specified year.

Other comparators

Use these comparators to match supported attribute values that do not fit the categories above.

ComparatorDescription
containsMatches when the attribute value contains the specified value.
does not containExcludes attribute values that contain the specified value.
is nullMatches when no value exists.
is not nullMatches when a value exists.
If you have suggestions for improving this article, let us know!