This release 8.20.7 introduces significant enhancements to the Promotions Admin Console, including new capabilities for Proximity Promotions, Cart Price Rule, Cart GWP, BOGO (Buy X Get Y, Buy X and Y), GWP, Bundle GWP, and Redemption on Customer on CSR Admin and storefront.

Promotions Enhancements

Promotion Proximity Enhancements

The Promotion Proximity feature has been introduced to provide proximity-based promotion messaging based on item quantity, item subtotal, or cart total. These messages inform business users (via Promotions Admin console) or end users (via storefront) how close they are to qualifying for a promotion.

Use Case Examples:

  • On the Cart Total: Add $50 more to your cart to avail 5% off!
    Explanation: For a promotion offering 5% off on cart totals above $500, a business user can set the Proximity Threshold to $350. This means customers will start seeing the above message once their cart total reaches $350 or more.
  • On the Item Price: Add 1 more quantity of Women’s Baggy Jeans to get $5 off!

Configuration Details

The proximity promotion capability is enabled by configuring the following collection properties configured in the ruleengine.setting.json file:

Collection Property

Configuration

skipIdentifiers

During rules configuration, this property with the value totalPrice, quantity, fulfillmentType enables proximity promotion based on Total Price, Quantity, and Fulfillment Type.

ruleengine.setting

The class com.skava.promotion.ecomm.model.PromotionSkip has been newly added to support Promotion Proximity enhancements. To configure these enhancements, this class must be defined under the following rule types: Item Shipping Rules, Cart Price Rules, Cart Shipping Rules, and Item Price Rules.

Promotion Admin Console Changes

  • Proximity Message Tab Added: When creating or updating a promotion of type Item Price, Item Shipping, Cart Price, or Cart Shipping, enabling the “Enable Proximity” flag will add a new tab titled “Proximity Message”. This tab appears after the existing tabs: Condition, Action, and Promocode.
    It allows configuration of proximity messages based on item quantity, item subtotal, or cart total.
  • Proximity Threshold Field Introduced: A new field called “Proximity Threshold” has been added to the condition query parameters for item quantity, item subtotal, and cart total nodes. The default value is set as “1” to allow business users to specify the threshold value at which proximity messages should begin displaying to customers.

Enhancements in CSR Admin

  • View Proximity Messages in Cart: Users can view proximity messages in the user’s cart based on promotions configured for Item Price, Item Shipping, Cart Price, or Cart Shipping. These messages are triggered based on item quantity, item subtotal, or cart total, enabling CSR to take appropriate action.

Enhancements in Storefront

  • Proximity Message Display: Customers will now see proximity messages in their cart based on promotions configured for Item Price, Item Shipping, Cart Price, or Cart Shipping. These messages are triggered based on item quantity, item subtotal, or cart total, helping customers understand how close they are to qualifying for a promotion.

Cart Price Rule & GWP Promotion Enhancements

This update introduces several enhancements to the Cart Price Rule promotion type, allowing business users to configure item-based conditions and actions.

Use Case Examples:

  • If a customer adds product A (e.g., Matee – Men’s 3Pk Tanks, SKU: 110018110) to the cart and the total for this product reaches $45 or more, they receive product B (e.g., Men’s Space-Dyed Shirt – White, SKU: 210034110) for free.
  • If product A costs $8.99, the customer must add more than 5 units to qualify.

Configuration Details

The Cart Price Rule and GWP promotion capabilities are enabled by configuring the collection property ruleengine.setting.json as follows:

Capability

Configuration

Cart Price Offer

In the existing class com.skava.promotion.ecomm.action.CartPriceOff, the following action parameters have been introduced to support the summed-up feature: SummedUpAction – to configure summed-up conditions, and offerOnSubTotal – to enable offers on the subtotal at the cart level.

Cart GWP

The class com.skava.promotion.ecomm.action.CartGiftWithPurchase has been newly defined in the Rule Engine configuration to enable summed-up actions for providing Cart Gift With Purchase (GWP) promotion offers.

Multiple Gift with Purchase

The class com.skava.promotion.ecomm.action.CartGiftWithPurchase has been updated with the following action parameters to enable the Multiple Gift with Purchase (GWP) feature:

  • "name": "giftCount" – used to define the number of free gifts
  • "name": "giftItems" – used to enable customers to choose from the available gift items.

Promotion Admin Console Changes

  • SKU & Bundle Condition Support: Business users can now configure Cart Price promotions using item-specific conditions. SKU and Bundle-related nodes are now available in the condition query parameters.
  • “Offer on Subtotal” Option in Actions: A new checkbox labeled “Offer On Subtotal” has been added in the Actions tab of Cart Price Rule promotions. When selected, it reveals a field “Summed Up” to calculate promotions based on Item Sub-total, Item Sub Quantity, or Item Sub PVs or CVs. This enhancement supports both Cart Price Offer and Cart GWP action types.
  • Cart GWP Action Enhancements: Several new capabilities have been added under the Cart GWP action type:
    • Add Gift Items Button: Allows configuration of multiple free gifts that can be automatically added to the cart.
    • Gift Selection Options: Two radio buttons are now available:
      1. “Free gifts are automatically added to the shopping cart” (This is default.)
      2. “Customers can choose free gifts from a list”
  • Product & SKU Selection via Search: Business users can now select Products and SKUs from a searchable list using icons next to the Gift Product ID and Gift SKU ID fields when configuring free items in a promotion.

Enhancements in CSR Admin

  • View Multiple Gift Items in Cart: CSRs can now view multiple gift items added to the cart for CART GWP and BOGO GWP/Bundle GWP promotions, as configured by the business user in the Promotion Admin.

Enhancements in Storefront

  • View Multiple Gift Items in Cart: Customers can now view multiple gift items added to the cart for CART GWP and BOGO GWP/Bundle GWP promotions, as configured by the business user in the Promotion Admin.

BOGO: Buy X Get Y, Buy X and Y, GWP, Bundle GWP Enhancements

This update enhances the flexibility of BOGO (Buy One Get One) promotions, enabling business users to configure more complex promotional offers. Key improvements include:

  • Multiple Buy & Get Support: Added logic to handle multiple BUY and GET conditions across various BOGO action types, including Buy X Get Y, Buy X and Y, GWP, and Bundle GWP.
  • Expanded Gift Options: Business users can now configure multiple free gift items under GWP and Bundle GWP action types within BOGO rules. These gifts are automatically added to the cart when promotion criteria are met.

Use Case Examples:

  • Buy A, B, and C and get Y at 10% off.
  • Buy 3 quantities of Dry Dog Food and receive 1 flea packet and 1 dog shampoo for free.

Configuration Details:

For BOGO (Buy X Get Y, Buy X and Y, GWP, and Bundle GWP) enhancements, the Cart Price Rule and GWP promotion capabilities are enabled by configuring the collection property ruleengine.setting.json as follows:

Capability

Configuration

BOGO Multiple Conditions

In the existing class com.skava.promotion.ecomm.action.BuyXGetY under the BOGO Rules type, introduced additional action parameters to configure multiple BOGO conditions. These include an index parameter with value “0” and the following action parameters: buyItemCondition, buyItemQty, getItemCondition, and getItemQty.

BOGO GWP

In the existing class com.skava.promotion.ecomm.action.GiftWithPurchase, we have introduced the action parameter giftItems to configure gift items as part of the action conditions.

Promotion Admin Console Changes

  • Multiple BUY Item and GET Item Conditions: Ability to configure more than one BUY and GET item condition across all BOGO action types. New buttons have been added: “Add Buy Item Condition” and “Add Get Item Condition”.
  • Multiple Free Gift Items in GWP & Bundle GWP: Ability to configure multiple free items in both GWP and Bundle GWP action types.
    • Added the “Add Gift Items” button, which allows adding multiple gifts to the cart automatically.
    • Search icons next to Gift Product ID and Gift SKU ID fields enable selection of free items.
  • Gift Selection Options for Customers: Ability to choose how free gifts are added to the cart:
    • Automatically added to the cart (default)
    • Customers can choose from a list

Enhancements in CSR Admin

  • Multiple Buy & Get Promotions: CSRs can now apply promotions configured for multiple “Buy” and multiple “Get” combinations in the cart, as set up by business users in the Promotion Admin.

Enhancements in Storefront

  • Support for Multiple BUY & GET Conditions: Customers can now apply promotions configured for multiple “Buy” and multiple “Get” combinations in the cart, as set up by business users in the Promotion Admin.

Redemption on Customer Enhancements

This Promotion enhancements now provide the Promotion Admin with the capability to restrict promotion usage on a customer-specific basis through the “Redemption on Customer” feature. This includes the flexibility to define and apply specific usage or redemption limits directly within the promotion configuration.

Use Case Examples:

  • Offer 10% off on Cat Wet Food for a customer’s first two orders!
  • Provide $5 off on cart totals over $500, limited to once per month per customer!

Promotion Admin Console Changes:

  • Field Renaming and New Option Added:
    • The existing “Frequency” field in the promotion creation section is now renamed to “Redemption on Customer”.
    • A new option, “N-time Use”, has been added alongside the existing “Weekly” and “Monthly” options.
    • The previous “Onetime” option has been removed and replaced by “N-time Use”.
  • Redemption Limit Field: When Weekly, Monthly, or N-time Use is selected, a new field appears “Enter a Redemption Limit” with the default value set to “1”, allowing business users to restrict how many times a customer can use the promotion.
  • Redemption on Customer – Weekly Option: When Weekly is selected, two new radio button options are available:
    • On Promotion Availing Day (default): Redemption count starts from the day the customer first uses the promotion.
    • On Specific Day of the Week: A dropdown listing all seven days of the week, from Sunday to Saturday. It indicates that redemption should be calculated starting from the specified day of the week, based on the promotion’s date range.
    • Existing Fields: In addition to the above fields, the existing fields such as “Every” (Weeks/Months) and Promotion Identifier continue to function as previously designed.
  • Redemption on Customer – Monthly Option: When Monthly is selected, two new radio button options are available for Redemption Cycle Start:
    • On Promotion Availing Day (default): Redemption count starts from the day the customer first uses the promotion.
    • On 1st Day of the Month: Redemption count starts from the first day of the month within the promotion’s date range. For example, if a promotion runs from June 1 to July 31 with a redemption limit of 2, and a customer uses it with a promotion discount on June 12, the system will count that as one redemption, leaving one more opportunity within the date range.

Enhancements in CSR Admin

  • Redemption Limit Awareness: CSRs can now view and apply promotions based on redemption limits configured by business users in the Promotion Admin. These limits can be set for weekly, monthly, or N-time use.

Enhancements in Storefront

  • Redemption Limit Awareness: Customers can now avail promotions based on redemption limits set by business users, including: Weekly, Monthly, or N-time Use.

Revision History
2025-12-15 | JP – Added Release 8.20.7 content.