Item Simulator

Item Simulator

1. Overview

The Campaign Item Simulator allows you to preview the reward tokens (points) that a product would earn under the current campaign before the campaign is saved or published. It also identifies any other active campaigns that reward the same item, enabling you to verify the expected rewards prior to launching the campaign.

The simulator is read-only and does not save, modify, or publish any campaign data.

2. Reaching the "Campaign Item Simulator"

  1. Choose Loyalty 
  2. Choose Campaigns
  3. Click on Edit Campaign icon under the Actions  
  4. Click on the Item Simulator button 
                                                                                                                              Figure 1.0
  1. The Campaign Item Simulator window will be displayed as shown below. 
                                                                                                Figure 1.1

3. Campaign Item Simulator

The Campaign Item Simulator window consists of the following sections.

3.1 Search by UPC

Enter the product UPC and click "Search" to locate the item.
                                                                                                         Figure 1.2

If the UPC exists, the item is added to the simulation list. If no matching product is found, the system displays a No Item Found message.
  1. Click Advanced Search to search for products.
                                                                  Figure 1.3
  1. Enter a Product Name or UPC and click on "Search."
  2. After selecting a product, click on "Apply." It is added to the simulator for evaluation.

3.3 Select Location

Use the Select Location drop-down to choose either:
  1. All Locations
  2. A specific store location
                                                                                                Figure 1.4

The selected location determines the product price used during reward calculation, since pricing may vary between stores.

3.4 Items to Check

Displays all products added for simulation.
                                                                                          Figure 1.5

For each product, the following information is displayed:
  1. Product Name
  2. UPC
  3. Remove Item option
Click "Remove Item" to remove a product from the simulator.

4. Check Item Results

After adding one or more items, click "Check Item Results" to calculate the reward tokens.

                                                                                                      Figure 1.6

The simulator evaluates each selected item against all applicable active campaigns and displays the calculated rewards. Each time this button is clicked, any previous results are cleared, and a new calculation is performed.

5. Reward Calculation

When the simulation is executed, the system performs the following operations for each selected item:
  1. Retrieves the item price for the selected location.
  2. Identifies all active campaigns associated with the account.
  3. Determines whether the item satisfies each campaign's eligibility criteria.
  4. Calculates the reward tokens based on the campaign's reward configuration.
  5. Distributes rewards across configured team levels, when applicable.
  6. Displays the campaign currently being edited at the top of the results.
Notes
Note: Auto Trigger campaigns are excluded from the simulator because they are executed only through automatic events and not through manual reward calculations.

6. Supported Reward Types

The Campaign Item Simulator supports the following campaign reward types:
Reward Type
Description
Percent Dollar Value (Open Ended)
Calculates rewards as a percentage of the purchase amount.
Points Per Dollar Value (Open Ended)
Awards points based on the configured dollar threshold.
Static Point (Open Ended)
Awards a fixed number of points per qualifying quantity.
Percent Dollar Coupon (Points Earned)
Calculates rewards when the campaign's trigger amount is met.
Static Point (Points Earned)
Awards a fixed number of points when the trigger amount is satisfied.

7. Simulation Results

For each qualifying product, the simulator displays:
  1. Product Name
  2. UPC
  3. Total Reward Tokens
  4. Campaign-specific reward details
  5. Team-level reward distribution (Level 1 through Level 5, when configured)
  6. Overall reward total across all qualifying campaigns
If the campaign includes a non-cash tender multiplier, the multiplied reward value is also displayed.
If a campaign has a maximum dollar limit, the simulator ensures the calculated reward does not exceed the configured cap.

7.1 No Campaigns Found

If the selected item does not qualify for any active campaign, the simulator displays the following message:
  1. No Campaigns Found For This Item

8. Limitations

The Campaign Item Simulator has the following limitations:
  1. Available only when editing an existing campaign.
  2. Cannot be accessed while creating a new campaign.
  3. Read-only functionality; no campaign data is saved or modified.
  4. Uses the current unsaved campaign values for simulation, allowing changes to be previewed before saving.
  5. Auto Trigger campaigns are excluded from the results.
  6. Items excluded through account-level blacklists are not considered during the simulation.
  7. Invalid or unknown UPC values return a No Item Found message.
  8. Each simulation run replaces any previously displayed results with a new calculation.