Salesforce B2C Commerce 24.5 > Storefront Toolkit

Test Promotions Using the Promotions Tracing Tool

⚠️ The annual cost of maintaining the server where this website is hosted, the domain, and keeping it up-to-date is approximately €3,000 per year. Help us with a small donation to cover these expenses. Support Now!

0 / 10000 €

The promotions tracing tool lets you test promotions before publishing them to the storefront. You can see which promotions are applicable for a particular cart. If a promotion isn’t applied to a cart, you can see the reasons why.

Because the Storefront Toolkit is available only in staging and development environments, you can’t test promotions in production environments. The tracing tool works only for evaluating the cart. It doesn’t work for Product Detail or Product List pages.

Make sure the promotions that you want to test are enabled and assigned to active campaigns.
For example, you have a promotion that discounts an order by 20 percent for a purchase of at least $200 in men’s clothing.
Launch the storefront.
Add products to the cart and then navigate to the cart.
For example, add men’s clothing items to the cart.
Enable promotion tracing:
1. Click the Preview Settings Tool icon. .
2. Select Enable Promotion Tracing and enter a Promotion Trace ID.
  The Promotion Trace ID lets you track promotion log messages in the Request Log.
3. Click Preview.
  Log messages are saved to the Request Log. Messages indicate the promotions that were applied to the cart and those that were evaluated but not applied.
To open the Request Log, click the Request Log icon.
Search the Request Log for the Promotion Trace ID.
In an environment with many promotions, the entire Request Log sometimes isn’t visible in the Request Log window. We recommend that you copy the log to a text editor and search for the Promotion Trace ID there.

For example, if you entered TraceTest for the Promotion Test ID, search for TraceTest.
To convert the results to a readable format, copy the block containing the promotion test information to any JSON parser.
Promotions are reported as follows:
- applicablePromotions: Promotions that a shopper is eligible for based on the context and products in the cart, for example, time, customer group assignment, or source code entry.
- qualifiedPromotions: Promotions that a shopper is eligible for based on the qualifying products in the cart before the promotions are processed through the ranking and exclusivity algorithm.
- appliedPromotions: Promotions applied to the cart after the promotions are processed through the ranking and exclusivity algorithm.
For example, opening this log message in a JSON parser makes it clear that the 20 percent off order promotion wasn’t applied because the $200 threshold wasn’t met.
If conditions are met for the promotion, the log message displayed in the JSON parser indicates that the discount was applied.