Skip to main content
Omneo uses JSON Logic for conditions in reaction filters and claimable benefit eligibility rules. JSON Logic is a small, portable specification for expressing rules as JSON.

​
Basic syntax

A condition is a JSON object where the key is the operator and the value is an array of operands: 
{ "operator": [left, right] }
The { "var": "field_name" } expression reads a value from the event context.

​
Single condition

Profile’s first name is “Jane”: 
{ "===": [{"var": "first_name"}, "Jane"] }

​
Comparison operators

OperatorMeaning
===Strictly equal
!==Not equal
>Greater than
>=Greater than or equal
<Less than
<=Less than or equal
inValue exists in array
!Logical NOT

​
OR condition

Profile has “tag-1” or “tag-2”: 
{
  "or": [
    { "in": ["tag-1", {"var": "flattened_tags"}] },
    { "in": ["tag-2", {"var": "flattened_tags"}] }
  ]
}

​
AND condition

Birth year before 1980 AND tier is “tier-2”: 
{
  "and": [
    { "<": [{"var": "birth_year"}, 1980] },
    { "===": [{"var": "tier_handle"}, "tier-2"] }
  ]
}
12-month spend over $1,000 AND in tier-2: 
{
  "and": [
    { ">": [{"var": "aggregations.spend_12m"}, 1000] },
    { "===": [{"var": "tier_handle"}, "tier-2"] }
  ]
}

​
NOT condition

Exclude profiles with “tag-1”: 
{ "!": {"in": ["tag-1", {"var": "flattened_tags"}]} }
Exclude profiles with “tag-1” AND “tag-2”: 
{
  "and": [
    { "!": {"in": ["tag-1", {"var": "flattened_tags"}]} },
    { "!": {"in": ["tag-2", {"var": "flattened_tags"}]} }
  ]
}

​
Available variables

​
Level 1: Profile fields (root level)

Accessed as first_name, tier_handle, email, etc.:
VariableTypeExample
first_namestring"Jane"
last_namestring"Smith"
emailstring"jane@example.com"
tier_handlestring"gold"
birth_yearinteger1985
birth_monthinteger9
birth_dayinteger15
genderstring"female"
flattened_tagsarray["vip", "stylist-client"]
flattened_statusesarray["active"]
reward_balancenumber25.00
point_balancenumber1500
joined_atdatetime"2023-01-15 00:00:00"

​
Level 2: Nested objects

Accessed with dot notation, e.g., aggregations.spend_12m:
VariableTypeDescription
aggregations.spend_12mnumberSpend in last 12 months
aggregations.spend_allnumberLifetime spend
aggregations.spend_atv_12mnumberAverage transaction value (12m)
aggregations.shop_countintegerTotal transaction count
tier.handlestringCurrent tier handle
tier.namestringCurrent tier name
definition.handlestringHandle of the triggering definition (tier, benefit, etc.)

​
Level 3: Deeply nested

Accessed as attributes.comms.email_promo, etc.:
VariableTypeDescription
attributes.comms.email_promobooleanEmail promotional opt-in
attributes.comms.email_optoutbooleanEmail global opt-out
attributes.comms.sms_promobooleanSMS promotional opt-in

​
Full JSON Logic reference

For the complete operator reference, see jsonlogic.com. All standard JSON Logic operators are supported.