Message conditions
Message conditions let you control when a message is displayed to a user based on their current context or past behavior. All conditions are evaluated with AND logic — the message is shown only when every condition is met.
You can configure conditions in the message editor under the Conditions section in the lateral panel.
Condition types
Screen
Available on: iOS, Android, .NET MAUI, React Native, and Flutter SDKs.
Display the message based on the current screen name, as reported by your app through Screeb.TrackScreen(...).
| Operator | Description |
|---|---|
| Contains | Screen name contains the given string |
| Does not contain | Screen name does not contain the given string |
| Equal | Screen name exactly matches, e.g. HomeScreen |
| Not equal | Screen name does not exactly match |
Delay
Display the message after the user has spent a given number of seconds on the current screen.
| Field | Description |
|---|---|
| Duration (sec) | Seconds to wait before displaying the message (0–9999) |
Session duration
Display the message after the user has accumulated a given number of seconds on the app across all screens (current session).
| Field | Description |
|---|---|
| Duration (sec) | Total seconds spent on the app (0–9999) |
Event count
Display the message based on how many times a user has triggered a custom event tracked with Screeb.TrackEvent('...').
| Field | Description |
|---|---|
| Events | One or more event names to match |
| Operator | Greater than, less than, equal to, not equal to |
| Count | Number of times the event was triggered |
Example: display the message after the user has triggered Product added to cart more than 3 times.
You can track custom events with the TrackEvent command.
Event sequence
Display the message based on whether a user has (or has not) performed a specific list of events, in order.
| Field | Description |
|---|---|
| Operator | Equal (performed in sequence) or Not equal (not yet performed in sequence) |
| Events | An ordered list of event names |
Example: display the message only after the user has performed Visit Pricing, then Create Account, then Upgrade Plan in that exact order.
Combining conditions
All conditions in the list are combined with AND logic. The message is shown only when every condition is satisfied simultaneously.
Use the Add button to stack multiple conditions. Remove individual conditions with the delete (trash) icon next to each rule.
Debugging conditions
If your message is not being displayed, you can inspect which conditions are failing:
await Screeb.DebugTargeting();
This prints each active message with its conditions and their pass/fail status. See Troubleshooting for details.