How to test scenarios

This guide explains how to test your Bloomreach scenarios to ensure they work correctly and deliver the expected results. Testing helps you verify that scenarios are reliable, effective, and aligned with your business goals.

You can test scenarios in three ways:

  • Preview tab.
  • Event triggers.
  • "As live" email testing.

Preview tab

Use the Preview tab for:

  • Check customer flow while building scenarios.
  • Debug existing scenarios when data changes cause conditions to fail.
  • Test non-event triggered scenarios.

What you see in preview

The Preview tab shows how many customers flow through each node.

Preview tab showing customer flow count through scenario nodes

View how many customers pass through each node.

When you start a scenario, a warning message shows the total number of affected customers.

Scenario warning message showing total number of affected customers

The warning message shows the total number of affected customers before you start a scenario.

Why numbers might not match:

In complex scenarios with multiple triggers or actions, the flow count can appear higher than the warning message count. This happens because:

  • Multiple triggers count each customer multiple times (even though both triggers won't fire simultaneously for the same customer).
  • Multiple action nodes multiply the count.

Example: A scenario with 2 triggers and 2 action nodes per customer shows 16 affected customers in the warning message, even though only 4 customers actually enter the scenario.

Scenario with two triggers and two action nodes showing inflated customer count.

A scenario with 2 triggers and 2 action nodes shows 16 affected customers.


Event triggers

When you build a triggered scenario, create a separate testing flow for test customers.

Separate testing flow for test customers in a triggered scenario.

Create a separate testing flow to isolate test customers.

To set up even trigger testing:

  1. Add an event node with required attributes (filters, email address).
  2. Select the Allow scenario triggering checkbox.
  3. Use test customer data to trigger the flow.
Event node settings with Allow scenario triggering checkbox selected.

Select Allow scenario triggering in the event node to enable test customer flow.

Advanced event testing

For more complex testing, specify Custom timestamp to make sure events occur in the correct order.

Custom timestamp field in event trigger settings.

Use a custom timestamp to control event order during advanced testing.

Example: The Jinja snippet {{ time - 60 }} tracks an event 60 seconds before the current time.

The Jinja snippet tracks the event 60 seconds before the current time.

The Jinja snippet sets the event timestamp.

“As live” email testing

Use the custom recipient setting to send all emails to yourself instead of sending them to customers. This helps you test complex scenarios that are difficult to test with simulated data.

❗️

Warning

Bloomreach sends you one email for every customer who enters the email node. If you don't filter your audience, you'll receive thousands of emails. Campaign events are still tracked to each customer's profile.

Prepare for testing

  • Filter your audience to include only test customers (for example, create a test segment with 5-10 profiles).
  • Check the audience size in the scenario warning message.
  • Don't use this method without audience limits.

How it works

Set the scenario live for real customers, but deliver all emails to your configured address. Review the data afterward.

When you use proper audience filtering, this method acts as a safety net to prevent accidental sends during scenario development.

Custom recipient setting routing all scenario emails to a test address.

The custom recipient setting redirects all emails to your address while the scenario runs on your live audience.


© Bloomreach, Inc. All rights reserved.