Skip to main content
Contextual conditions allow you to control when a merchandising rule applies based on visitor session data. Using JSON Logic expressions, you can target specific audiences with tailored merchandising strategies.

​
How contextual conditions work

Contextual conditions are evaluated at request time against session context data including:
  • Geographic data: Country, state/province, city
  • Customer attributes: Customer tags, account status, purchase history
  • UTM parameters: Marketing source, medium, campaign
  • Device information: Device type, operating system
  • Shopping channel: Online store, mobile app, etc.
The system uses JSON Logic to evaluate conditions. If a rule’s conditions evaluate to true for the current session, that rule is applied. Rules without contextual conditions always match.

​
JSON Logic examples

Target US visitors: 
{
  "==": [
    {"var": "geo.country"},
    "US"
  ]
}
Target mobile users in California: 
{
  "and": [
    {"==": [{"var": "geo.state"}, "CA"]},
    {"==": [{"var": "device"}, "mobile"]}
  ]
}
Target visitors from specific marketing campaigns: 
{
  "in": [
    {"var": "marketing_campaign"},
    ["summer-sale", "holiday-promo"]
  ]
}
The contextual conditions form in the dashboard provides a user-friendly interface for building these JSON Logic expressions without writing code directly.

​
Use cases

Geographic Merchandising: Show region-specific products or promotions based on visitor location. Campaign-Specific Merchandising: Display different product arrangements for visitors arriving from specific marketing campaigns. Device-Optimized Merchandising: Adjust product ordering based on device type for optimal mobile or desktop experiences. Customer Segment Targeting: Show VIP customers different merchandising than first-time visitors.

​
See also