About Decisions

Once you create a metric, you can evaluate data, monitor trends, and act on results.

Illuminate includes the Decisions module. You define what to act on by choosing metrics, creating actions, and adding rules that control when actions run.

When creating a Decision, you:

  1. Choose a Business Object and a linked metric. For asset tracking, use Hours since order (Number) and Trailer ID (String).
  2. Define actions. For example, notify a transportation manager when a delivery is delayed.
  3. Set rules with conditions and actions. For example, trigger a notification only when goods are 2 hours late or more.

Decisions help product managers test engagement and monetization strategies before deployment. With Illuminate, you use real data instead of assumptions and act through automated conditions and actions.

Decision structure

A Decision consists of three elements: actions, conditions, and rules.

Actions

Actions define what happens when conditions are met.

In each action, add variables you control during setup. Create new variables or reuse ones from rules. To add a variable, type ${. Select a suggestion, or type ${Variable name} and choose Create new variable: Variable name.

Available action types:

Action TypePurpose
Send Message
Sends a message to a user or channel using the PubNub Publish API.

In Body, enter the quoted message. Optionally add variables (${variable}); you can also use variables in Channel and Meta.

Example:

"Welcome to ${levelName}, enter discount code ${discountCode} within the first 5 minutes to buy ${purchaseItem}."
Webhook
Sends a request to a URL for a third-party service.

In Payload, enter the quoted message. Optionally add variables (${variable}); you can also use variables in Webhook URL and in Headers (Key, Value).

Example:

"${message}. Use ${discountCode}"
Update User
Sets predefined or custom user metadata as key/value pairs. You can use variables in all fields.
Used with PubNub App Context user.
Update Channel
Sets predefined or custom channel metadata as key/value pairs. You can use variables in all fields.
Used with PubNub App Context channel.
Update Membership
Sets predefined or custom membership metadata as key/value pairs. You can use variables in all fields.
Used with PubNub App Context membership.
Facilitating collaboration

Use each action type’s Documentation / Notes section to collaborate. For example, add an action as an analyst and ask a developer to validate a webhook URL or payload.

Action execution limit

Control how often an action runs when conditions are met.

Action execution limit

For each action in your decision rules, you can select one of the following options:

  • Always (default) – Execute the action whenever the conditions are met.
  • Once per interval – Execute the action once within a specified time interval whenever the conditions are met.
  • Once per interval per condition – Execute the action once for each unique condition value within a specified time interval whenever the conditions are met.

Action execution options

Reset action execution limit

The limit resets when you deactivate a Decision. After a reset, past executions are not considered. You can also click Reset limit while a Decision is active.

Action execution limit reset

Action history

Track action history from the Ellipsis (...) menu in:

  • Each Decision chart on a dashboard
  • Each Decision on the Decisions home page
  • The Decision table in view mode

The Action history page shows the 50 most recent actions for a Decision. Use it to verify actions run.

Decisions — Action history

Filter by any table value, such as status, trigger value, or failure reason. Expand a row to see what conditions triggered an action. The condition, threshold, and actual trigger value appear.

For example, Max of Minutes waiting ≥ 1 (6) means the condition is Max of Minutes waiting, the threshold is ≥ 1, and the value that triggered the action is 6.

Decisions — Action history details

An action can fail for one of the following reasons:

  • Action configuration is invalid
  • HTTP timeout error during dispatch
  • Publish action was unsuccessful
  • App Context action was unsuccessful
  • Webhook action was unsuccessful
  • Received status code is other than 2xx

Conditions

Conditions are criteria that must be met to trigger an action.

For example, notify a transportation manager when goods arrive two hours late. Use a rule with action type Send Message and a delay condition. Choose how often to evaluate it.

Rules

Rules evaluate conditions and run actions when conditions are met. Each rule is a row in the Decision table. You can save a Decision without a rule. When you save, you can create a rule now or later by selecting the Decision and clicking Edit Rules. You need at least one rule to activate a Decision.

Each Decision has configuration that controls which rules run and how often:

Action TypePurpose
Hit policy
Triggers the first matching rule (Single) or all matching rules (Multiple).
Aggregation window
Auto-populated from the metric’s Period for Function. Shows how often the metric runs the function for data fields.
Evaluation frequency
Lookback window that sets how often Illuminate runs rules in this Decision.
Conditions
Requirements you define in the table. Specify thresholds that trigger actions.
Decision rules order

Each row in the Decision table is a separate Decision rule with conditions and actions. The order of rules determines execution order. To change it, select Edit Rules and use Move up or Move down under the Ellipsis (...) menu next to each rule.

Additional details

To work effectively with Decisions, keep the following in mind:

  • Conditions come from data fields in the selected metric. If the metric aggregates data (for example, Count or Sum), the condition reflects that.
  • To create or save a Decision, select a Business Object and a metric. You can add actions and rules, then activate the Decision.
  • To activate a Decision:
    • Have at least one action and one rule.
    • Ensure the related Business Object is active.
  • After activation:
    • Rules run and actions execute.
    • You can edit the Decision (Edit Configuration) and rules (Edit Rules).
    • You can add rules and actions.
    • The metric used in this Decision stays fixed.
    • You can add the Decision to a Dashboard.
  • To stop evaluation and execution, deactivate the Decision.

Home page

The Decisions home page lists your Decisions and shows:

  • The number of configurations (actions) for each Decision
  • Activation status

Use the Ellipsis (...) menu to edit configuration or rules, view action history, activate or deactivate, or delete a Decision.

Decisions — Home page

Settings

On a Decision page, you can edit configuration and rules, activate or deactivate, or delete the Decision.

Decision — settings

Last updated on