This page equips Business administrators with a user guide for the Infosys Equinox Commerce platform’s Promotions microservice.

Getting Started

Accessing the Promotions Console

Overview

The Promotions microservice (“Promotions”) allows Marketing Managers to create and manage promotion groups and promotions. As with all microservices in the Infosys Equinox Commerce solution, promotion groups and promotions are associated with a store managed by the Store microservice.

A core component of Promotions is the embedded drools rule engine which executes business rules at scale, to evaluate for active promotions (See https://www.drools.org/ for details about drools by Red Hat, Inc.). For example, when rule conditions match, the engine fires responses that return data to the Storefront, to execute an action (like applying a discount to an item in the cart).

Promotions provides a flexible rules-based approach to manage your promotions workflow and thus supports a wide range of client use cases. You can define rule patterns based on a range of expressions consisting of various logical operators and data models that represent product information, user data, shipment type, location, payment or any custom-defined fields. The models can be extended to meet your needs that may not be supported out of the box. Contact your Account Manager for more information about extending models and creating custom actions.

For a detailed overview of the Promotions microservice, see the Promotions Microservice Overview.

Service Glossary

• Business – the parent of a store or set of stores. The basic use of a business is to manage common sets of users, catalogs, and other services for the stores associated with the business.
• Business Admin – a role that manages business settings, creates and manages stores, and enables microservice(s) for a business.
• Commission Volume (CV): It is the currency value associated with each product based on which the compensation is paid to the users (for example, users such as Retail Members and Brand Affiliate). The CV value for each product can differ from time to time.
• Lists – create custom lists for use in promotions (e.g. issue discounts to a list of users identified by their email address). List creation and use DO NOT require the workflow approval process.
• Marketing Manager – creates, manages, and approves promotions.
• Model – describes the context of a promotion or offer type (for example, stock-keeping unit (SKU), Cart, Payment, User, Store, or Cookie).
• Omni-channel – a multichannel approach to sales that seeks to provide consumers with a seamless shopping experience, whether shopping online (on a desktop, a mobile, or a tablet device), by telephone, or in person at a physical store (https://searchcio.techtarget.com/definition/omnichannel).
• Point Volume (PV): It is a value that is pre-defined on the product. PV determines the bonus percentage. It is the points that the users earn for achieving their bonus (for example, users such as Retail Members and Brand Affiliates).
• Product – a good, service, or idea that has a combination of tangible and intangible attributes and can have multiple variants which are referred to as stock-keeping units (SKUs). In Infosys Equinox Commerce, the consumer or buyer evaluates a product (for example, a men’s dress shoe available in black and brown and sizes from 10 to 15), but actually purchases an SKU associated with the product (for example, a black-colored version of the dress shoe in size 12) rather than the product itself.
• Promotion Codes – activate promotions that have not been configured to auto-apply. The Codes can be created manually or be generated by the Promotion microservice. Promotion Code creation and use do NOT require the workflow approval process.
• Promotion Editor – defines and manages offers and discounts for consumers or buyers on the Commerce site and submits them to the Marketing Manager for approval.
• Purchase Order (PO) – indicates the official order issued by a buyer to a seller on the agreed product or services.
• Project – a container or wrapper entity to hold changes made to a promotion group or promotion. New and updated pricing should pass through the Project approval workflow process before it is reflected in a store’s promotions.
• Project Notes – comments entered by Project Editor or Approver to add context to project actions.
• Project Workflows – make business processes more efficient by managing and tracking the human tasks involved with a process and then providing a record of that process when it completes.
• Promotion – offers presented to consumers or buyers in a client’s Storefront and Apps.
• Promotion Group – container for individual promotions that are grouped logically based on an event or marketing campaign. The creation of a Promotion Group is required and should be defined before a Promotion can be created.
• Rules Engine – an environment that provides a flexible definition of business rules such as promotions.
• Stock Keeping Unit (SKU) – a particular variant of a product that is available for purchase by a consumer or buyer.
• Store – represents a specific physical location or online store of a business.
• Store Manager – associates a price list for each currency supported by a store.
• Storefront – a consumer-facing website that presents products, content, and promotions across multiple channels such as desktop, tablet, and mobile.
• Sharing Bonus (SB): It is a bonus that is paid to the users who invite other users to buy the product (for example, Brand Affiliate user).  A sharing bonus can be configured for specific products. The bonus percentage is defined for a product based on the business requirement.

End-to-End Sequence to Configure a Promotion

You need to configure the promotions in the following sequence:

1. Configure the Store-Properties – ensure if the store properties are configured.
   Note: Only a Business Admin can configure the store properties.
2. Configure the Promotion’s Collection-Properties – ensure if the collection properties are configured.
   Note: Only a Business Admin can configure the collection properties.
3. Create a Promotion Group
4. Create a Promotion within the promotions group.
5. Configure the following to create a promotion offer:
   • Configure Rule-Based Conditions for a Promotion.
   • Configure Actions and Conditions for Promotion Offers.
   • Create Users List to associate promotion offers to multiple users, values, accounts, etc.
   • Configure Promocodes; see Generate Promocodes List to configure promocodes for multiple users.
6. Submit and approve the project. Only the approved promotions will reflect as successful promotion offers.
   The promotion offers appear on the storefront.

Prerequisites for Setting Up Promotions Admin Console

Before you start, ensure that you:

• have valid credentials to access the Promotions Admin console.
• set up the promotions-related store properties in the Foundation Admin Console under the Advanced tab of the Store Overview page. For more information, see Foundation Admin Guide.
• configure the collection properties in the Foundation Admin Console.

Accessing the Promotions Console

Overview | Manage Promotions To access the Promotions Admin console,

1. Log in to the Foundation service for your business (URL provided by Infosys Equinox).
   
2. Click Promotions on the StoreOps page.
   
   The Promotions landing page appears:
   

Manage Promotions

Accessing the Promotions Console | Projects and ApprovalsIn the Promotions console, with the necessary privileges, you can manage:

• Promotions via the project approval workflow. For creating promotion groups and promotions, see the video below or the step-by-step instructions:
  
  Note: The above video is updated for Release 8.11.
• List
• Promo Codes List

The landing page for each section contains a list of all Promotion Group, List, and Promo Codes List, respectively, for a store.

Working with Promotion Groups

In the Promotion Groups page, you can:

• view the list of all existing Promotion Groups
• create a new Promotion Group via the project approval workflow.
• delete an inactive Promotion Group
• search by Project, Priority, Status, Date, or Stop further processing.
• sort by Promotion group name, Priority, Status, Start Date, End Date, Stop further processing by ascending/descending order.

Creating a New Promotion Group

A Promotion Group enables you to organize multiple similar promotions. Once you create a new promotion group, you can create a new promotion, manage the existing promotions, and/or clone an existing promotion.

To create a new promotion group,

1. Click the Create Promotion Group button.
   The Select Project pop-up opens. This is required to create a promotion group and get it approved with the Promotion Manager.
2. Select the required project. For example,
   
   Note: If the project is not available, then create a new project. For more information, see “Creating a New Project“.
3. In the Create Promotion Group page, enter/select the required information:
   

   Field	Description
   Group Name*	Enter a name that describes the promotion group.
   Date Range*	Select the start date and time, end date and time, and click the Apply button. Note: The promotion created within the promotion group is bound within the start and end dates. If you DO NOT select the date and time, then you can apply the default date and time to the promotion. group. The default data and time are set as follows: Date Picker Description Start date Sets the next date of the current date (that is, current date + 1 day) Start time (24-hour clock) Sets the start time as “00:00:00” End date Sets 6 days from the start date (that is, start date + 6 days) End time (24-hour clock) Displays the end time as “23.59:00.”
   Status*	Select a status: In-Active to deactivate the promotion group. Later, you can change the status to ‘Active’ if required. Active to activate the promotion group. The promotion engine checks only active promotion groups and promotions.
   Priority*	Enter a priority number between 0 and 25 where 25 is the highest and 0 is the lowest in the priority order. The promotion engine reads the active promotion groups and active promotions in it as per the priority order.
   Stop further processing	Select any one of the following options to stop further processing of the succeeding promotion groups: Never (default selection) – Whether or not the condition matches in the current promotion group, continue to execute the succeeding promotion groups in order of priority. Always – Whether the condition matches or not in the current promotion group, the promotion engine stops executing the succeeding promotion group. If stop condition matches – Enables you to define the stop condition. The promotion engine stops executing when the stop condition matches.  You can specify the business rule that stops the promotion engine from further processing. See Configuring Conditions for more information.

4. Click the Save button to save the newly created promotion group and view the summary details of the promotion group. Now, you can create new promotions within the group.

Note:

• • Fields marked with * are mandatory.
  • To cancel creating the promotion group, click the Cancel button.
  • For editing the existing promotion group, see Editing Existing Promotion Group.

Creating a New Promotion

You can create one or more promotions within the Promotion Group with a different set of conditions, offer periods, actions, and priorities for each promotion via the project approval workflow. The promotion engine executes the promotion group based on priority, active status, and conditions. If the condition matches, the promotion engine reads each active promotion within the group and executes the promotion offer based on the priority order, conditions, and actions set for each promotion.

While creating a promotion, you can add a locale-specific display message and description.

To create a new promotion,

1. In the Promotions section, click the Create Promotion button. 
   
   Note: If you are not in a project, then on clicking the Create Promotion button, the Select Project pop-up opens. This is required to create a promotion and get it approved with the Promotion Manager. If the project is not available, then create a new project. For more information, see “Creating a New Project“.
2. In the Create Promotion page, enter/select the required information:
   
   The following table provides the field description to create a promotion:

   Field/Section	Description
   Promotion Name*	Enter a name that describes the promotion.
   Date Range*	Select the start date and time, and the end date and time for the promotion. The promotion offer will be applicable only on the selected date and time, otherwise, the promotion expires. You will be able to select the date for a promotion that falls within the promotion group duration. Note: The promotion created within the promotion group is bound to be within this start and end dates. If you DO NOT select the date and time, then you can apply the default start and end date and time that are displayed in the promotion.
   Status*	Select a status: In-Active to deactivate the promotion. Later, you can change the status to ‘Active’ if required. Active to activate the promotion. The promotion engine checks only active promotion groups and promotions.
   Recurrence Setting	Enable this toggle to set the promotion with additional settings for recurrence. A recurrence promotion is executed only on the specified hours of the specified weekdays. When this toggle is enabled, the below fields are displayed to set the time range and weekdays of the recurrence promotion: Time Range – Select the start time and end time for the recurrence promotion. Note:  The time zone of the promotion is configured using the timeZone collection property. Occurs Every – Select the required weekdays for the recurrence promotion. The value can be all weekdays or a specific set of days. For example, Friday, Saturday, and Sunday. Note: By default, this toggle is disabled.
   Offer On	Select one offer rule based on which the offer types can be configured in the Actions page: Item Price Rules – to set up a price offer on an item: Product Price Offer – to provide an offer on the product price. Product Personalization – to provide discounts on gift-wrapping and personalization for a specific set of products. Bundle Product Offer – to provide a promotion offer on the bundled products. Summed Up Product Price Offer –to create offers for products (or a range of products within a category) and apply discounts based on the “summed up” value of items added to the cart that match defined. This value is displayed in the drop-down list in the Actions page only when the offer on “Item Price Rules” and offer type “% offer” are selected. Note: The items in the cart that do not match the conditions are ignored. This offer is displayed only if the collection property “ruleengine.settings” is configured with the value “Summed Up Product Price Offer”. BOGO Rules – to set up any one of the following offer types: Buy X Get Y – a customer gets a percentage offer or currency offer on buying X number of items. Buy X And Y – a customer gets a percentage offer or currency offer on buying two different specific items. GWP – a customer gets a predefined gift along with the purchase of a predefined product. In the Actions tab, you can configure, a particular product ID and/or SKU ID, so that a gift is offered on purchasing a product. Bundle GWP– a customer gets a predefined gift along with the purchase of a predefined bundled product. In the Actions tab, you can configure, a normal product as a gift for any special product, so that a particular product is eligible for the promotion for a bundle of products. a particular category, so that all the products within the category are eligible for the promotion. Note: This offer is displayed only if the value “BundleGWP” is configured in the collection property “ruleengine.settings“.  Item Shipping Rules – to set up a shipping price offer on an item: Product Shipping Offer – to provide shipping discounts on a product. Bundle Product Shipping Offer – to provide a shipping offer on the bundled products. Cart Price Rules – to set up any one of the following offer types: Cart Price Offer – to set up a cart price offer on an order. Trade In Offer – to provide an offer on an old item while exchanging with a new item. Cart GWP – to provide a gift with a purchase discount at the cart level. This is a predefined gift based on the cart price value. Note: This offer is displayed only if the value “CartGWP” is configured in the collection property “ruleengine.settings“. Cart Shipping Rules – to set up a cart shipping offer on an order. The account-based promotion offers can be set up in the action conditions using the B2B Accounts model. See setting B2B Accounts in the conditions. For information on returning, replacing, or exchanging an order or item(s), see CSR Functionalities in the Order Admin Guide. Note: You can configure the Offer On (offer rules), only if the relevant values are defined in the collection property “ruleengine.settings“. The offer rules are executed based on the execution order mentioned in the collection property executionOrder. For examples, refer to Examples on Configuring Conditions and Actions.
   Offer Type	Select an offer type: Fixed Offer – The set offer value will be the sale/shipping price of the item/cart. Amount Offer – The set offer value set will be a discount on the original sale/shipping price of the item/cart or on the customer’s payment method (but the rule type should be Cart Price Rules). % Offer – The set offer value set will be a percentage discount on the: original sale/shipping price of the item/cart customer’s payment method (but the rule type should be Cart Price Rules) bundled products. Note: You can also set the actual discount value between the maximum and minimum range on the Actions page. Formula – Once selected, the Formula field appears on the Actions page for calculating promotion offers. It is a customized discount based on a formula or logic.
   Priority	Enter a priority number between 0 and 25 where 25 is the highest and 0 is the lowest in the priority order. The promotion engine reads the active promotion groups and active promotions in the order of priority.
   Promotion Class	Promotion class is used to classify the promotion. In the Promotion Class dropdown list, select any one of the following discount types: Discount type Functionality Material Bundle Discount Discount from Bundle (promotion for bundle/SKUKIT) Sales Channel Discount Discount from Subscription Advertise Discount Discount from Promotion Order Drop Discount Discount from GWP/Gift (full amount off) Program Discount Discount from Loyalty (for Loyalty point Redeem) Customer Svc Discount Manual Discount from Agent Note: This field appears only if the collection property “promotionclass” is configured. This above functionality is mentioned only for reference purposes and there is no functionality/logic behind this.
   Frequency	This field allows you to customize the frequency-based promotion to offer free gifts with the customer’s first purchase. In this field, select, Weekly: Configure a promotion for a weekly frequency. Every: Select the value based on which the gift offers are promoted every week or once every two weeks. Promotion Identifier: This is a unique identifier for frequency-based promotion. When a user uses the promotion, the timestamp is stored in this identifier in “UserProperties“. Note: The system calculates the first day from the day the user places an order. For example, if the user places the order today, he or she can place the order using this promotion after 7 days only. Monthly: Configure a promotion for a monthly frequency. That is, the customers will get a gift on their first purchase on a monthly basis. Every: Select the value based on which the gift offers are promoted on the first purchase made. For example, if the value is “1,” the offer will be applied once every month. If the value is “2,” the offer will be applied once every two months. Promotion Identifier: The promotion identifier is the user-based identifier. Specify the promotion identifier using which the customer property is configured for the customer at the backend, which updates the frequency process. For example, if the user places the order today in the month of “November,” then he or she can place the order using this promotion in the upcoming month of “December.” If the value 2 is defined in the field “Every,” then the user receives the offer when he/she places an order in January. Onetime: If the customer loyalty opt-in user is eligible for the “one-time” frequency, then the user would receive the gift ONLY ONCE on his first purchase. Note: For frequency-based promotions, the promo code option is invalid. You cannot configure the promo codes for the same promotions. For multiple scenarios, see Configuring the frequency-based promotions.
   Locale Specific Message Description	In this section, enter a locale-specific display message and description. The default locale is en_US. You can add multiple locales to a promotion. In Collection Properties of Promotion, the initial locale will be set to default. All locales configured here will be displayed in the drop-down list. Note: If the translation app is installed in your store, the description given for a locale is automatically translated to other locales once you save the promotion.

   Note: Fields marked with * are mandatory.

3. Click the Save button to save the promotion to the promotion group. 
   
   After saving, a unique ID is created. Now, you can start configuring conditions, actions, and promo codes.
   Note: If required, you can edit or clone the promotion.

Configuring Conditions

Overview

You can add one or more rules or group of rules to a promotion group and/or a promotion. You can create a maximum of three levels of groups for each promotion group or promotion. By default, a row will be shown to add a rule. After setting the conditions to the promotion group or promotion, you may choose to click on Generate Condition to check if the set condition is appropriate for your use case.

Options for Configuring Rules or Group of Rules

The following table describes various options available in configuring conditions:

Option Available in a Condition	Description
	Set logical operators such as NOT, AND, and OR in a rule. These operators apply the rules that are direct descendants in the condition builder. The logical operators display the list of parameters associated with the offer type which is configured for the promotion. For example, for the Item Price Rule offer type, the parameters relevant to items such as name, product ID, and category ID are displayed. You can also configure conditions for special products such as bundles, fixed bundles, SKU KITs, and Collections. Refer to Creating Additional Item Types section in Catalog Admin Guide. Examples: To create a condition where you need to provide an offer on a T-shirt from Adidas brand, you can set the following condition: To create a condition where you need to provide an offer on a product either from the brands Adidas or Nike, you can set the following condition: To create a condition where you need to provide an offer on a product that neither belongs to the brands Adidas nor Puma, you can set the following condition:
	Add one or more rules in the condition. For example, to create a rule where you need products from the category with Category ID as T-Shirts and product ID as 110003 or110013, you can set the following rule:
	Add a collection of rules within the group in the condition. For example, if you need to provide an offer on all products either from the category Boys or the category Men with the brand Polo, you can create the following condition with groups:
Operand/Operators/Values	Select the operands and operators for the condition. You can create different conditions by changing the combination of operands and operators. You can enter or select the required value(s) for the selected item. Note: To configure for B2B Accounts, select Account Id, Account Type, or Account Rep in the operand. The appears only for SKU ID, product ID, and user ID operands to select the value(s) by using filters. For more details, see Filtering Values for Conditions.
	Delete a rule or a rule group of conditions.
	Generate conditions and validate against your appropriate use case, after creating conditions using the condition builders. Click this button to view the generated conditions. For example,

Filtering Values for Conditions

This section describes how to filter values of operands such as SKU ID, product ID, and/or user ID to configure conditions.

To filter the values of an operand,

1. 1. In a particular promotion, click the CONDITIONS tab.
   2. Add rules as per your business requirements. For example,
      Note: See Configuring Conditions for more information.
   3. Clickof the required operand. For example, for the ProductId operand:
      
      
   4. Clickof the required SKU, product, or user to add the value to the condition.
      Note:
      • To remove a SKU, product, or user from the condition, clickof the item.
      • To search for the required SKUs, products, or users, use.

Creating Conditions for a Promotion

This section describes how to set rules and group of rules to configure conditions.

To configure the conditions and stop further processing for the promotion,

1. In a particular promotion, click the CONDITIONS tab.
2. Add rules as per your business requirements. See Configuring Conditions for more information.
3. Click the Generate Conditions button and verify the result.
4. In the Stop further processing section, select any one of the following options to stop further processing of the succeeding promotion:
   • Never (default selection) –Whether the condition matches or not in the current promotion group, continue to execute the succeeding promotion groups in order of priority. By default, this option will be selected.
   • Always –Whether the condition matches or not in the current promotion group, the promotion engine stops executing the succeeding promotion group.
   • If condition matches – When the current promotion’s condition matches, the promotion engine stops executing the succeeding promotion group.
     Note: When you configure the promotion with promo codes, the rule engine stops further processing the condition once the promo code is matched to the condition.
   • If stop condition matches – Enables, you to define the stop condition. The promotion engine stops executing when the stop condition matches.  You can specify the business rule that can stop the processing of promotions. See Configuring Conditions for more information.
5. Click the Save button.
   Note: To cancel the conditions without saving, click the Cancel button.
   The condition is updated as follows:
   

Authoring Actions to the Promotion

Actions allow you to define the discount value for the promotions. After creating a new promotion and creating conditions for it, you need to specify what needs to be done when the condition matches. This is configured using actions. Within a promotion, you can also create multiple different actions based on the action condition and assign different offer values to each action. The actions will vary according to the promotion offer rules and the promotion offer type that is configured while creating a promotion.

You can set rules to configure discounts for the transaction price by configuring various conditions and actions. In addition to the transaction price, you can also configure discounts for additional components like Point Volume (PV), Commission Volume (CV), and Sharing Bonus (SB) for the Item Price and Cart Price rules in the actions. For detailed information on PV, CV, and SB, refer to Defining PV, CV, and SB.

Create an Action

To create an action,

1. In a particular promotion, click the ACTIONS tab after configuring the required conditions.
2. Click Add Actions.
   The Add Action field details appear:
   
3. Enter an action name, that describes the action.
   A list of parameters will be displayed based on the selected Offer On and Offer Type.

   While creating a promotion, if		Then, in the ACTIONS tab
   Offer On is	Offer Type is	Select the Action Type	Set the following Action parameters
   Item Price Rules	Fixed Offer	Product Price Offer	In the Purchase Type drop-down list, select any one of the following: Batch Purchase Quantity – The customer must buy the products as per the multiple quantity threshold, as specified in the Purchase Quantity field. For example, when the purchase quantity is specified as 3, the user gets a discount for the purchase of 3 items and for the multiples such as 6 items, 9 items, and so on. Minimum Purchase Quantity – The customer must buy the products as per the minimum quantity threshold, which is specified in the Purchase Quantity field to get the discount. Maximum Purchase Quantity – The customer must buy the products as per the maximum quantity threshold, which is specified in the Purchase Quantity field to get the discount. In the Purchase Quantity field, enter the quantity value in numeric format. Select any one of the discount types: Each Discount – to provide discounts for each of the products. This value is shown by default. Flat Discount – to provide a flat discount on the final total amount. Enter the fixed offer amount. In the Offer on Other Values field, perform the following: Select the value to configure discounts on PV, CV, and/or SB in addition to the product’s transaction price. Enter the discount values for the selected values in the Fixed Offer on “value” field. Note: To enable the Offer on Other Values field, refer to Defining PV, CV, and/or SB values.
   	Amount Offer	Product Price Offer	In the Purchase Type drop-down list, select any one of the following: Batch Purchase Quantity – The customer must buy the products in large numbers as specified in the Purchase Quantity field. Minimum Purchase Quantity – The customer must buy the products as per the minimum quantity threshold, which is specified in the Purchase Quantity field to get the discount. Maximum Purchase Quantity – The customer must buy the products as per the maximum quantity threshold, which is specified in the Purchase Quantity field to get the discount. In the Purchase Quantity field, enter the quantity value in numeric format. Select any one of the discount types: Each Discount – to provide discounts for each of the products. This value is shown by default. Flat Discount – to provide a flat discount on the final total amount. In Offer Amount, enter the offer amount. In the Offer on Other Values field, perform the following: Select the value to configure discounts on PV, CV, and/or SB in addition to the product’s transaction price. Enter the discount values for the selected values in the Fixed Offer in the “value” field. Note: To enable the Offer on Other Values field, refer to Defining PV, CV, and/or SB values.
   	% Offer	Product Price Offer	In the Purchase Type drop-down list, select any one of the following: Batch Purchase Quantity – The customer must buy the products in large numbers as specified in the Purchase Quantity field. Minimum Purchase Quantity – The customer must buy the products as per the minimum quantity threshold, which is specified in the Purchase Quantity field to get the discount. Maximum Purchase Quantity – The customer must buy the products as per the maximum quantity threshold, which is specified in the Purchase Quantity field to get the discount. In the Purchase Quantity field, enter the quantity value in numeric format. Select any one of the discount types: Each Discount – to provide discounts for each of the products. This value is shown by default. Flat Discount – to provide a flat discount on the final total amount.  In % Offer, enter the percentage offer in numeric format. In the Offer on Other Values field, perform the following: Select the value to configure discounts on PV, CV, and/or SB in addition to the product’s transaction price. Enter the discount values for the selected values in the Fixed Offer in the “value” field. Note: To enable the Offer on Other Values field, refer to Defining PV, CV, and/or SB values.
   	Formula	Product Price Offer	In the Purchase Type drop-down list, select any one of the following: Batch Purchase Quantity – The customer must buy the products in large numbers as specified in the Purchase Quantity field. Minimum Purchase Quantity – The customer must buy the products as per the minimum quantity threshold, which is specified in the Purchase Quantity field to get the discount. Maximum Purchase Quantity – The customer must buy the products as per the maximum quantity threshold, which is specified in the Purchase Quantity field to get the discount. In the Purchase Quantity field, enter the quantity value in numeric format. Select any one of the discount types: Each Discount – to provide discounts for each of the products. This value is shown by default. Flat Discount – to provide a flat discount on the final total amount. Enter the formula to provide the discount. In the Offer on Other Values field, perform the following: Select the value to configure discounts on PV, CV, and/or SB in addition to the product’s transaction price. Enter the discount values for the selected values in the Fixed Offer in the “value” field. Note: To enable the Offer on Other Values field, refer to Defining PV, CV, and/or SB values.
   Item Price Rules	Fixed Offer	Product Personalization	Enter the personalization type, for example, Gift Wrapping Enter the fixed offer amount.
   	Amount Offer	Product Personalization	Enter the personalization type, for example, Gift Wrapping In Offer Amount, enter the offer amount.
   	% Offer	Product Personalization	Enter the personalization type, for example, Gift Wrapping In % Offer, enter the percentage offer in numeric format. Enter the minimum discount amount. Enter the maximum discount amount. Note: The Minimum Discount and Maximum Discount are applicable only for the Transactional Price.
   	Formula	Product Personalization	Enter the personalization type, for example, Gift Wrapping Enter the formula to provide the discount.
   Item Price Rules	Fixed Offer	Bundle Product Offer	In @ Amount, enter the fixed offer amount. In Offer on Other Values: Select the value to configure discounts on PV, CV, and/or SB in addition to the available transaction price of the bundle of products. Note: To enable the Offer on Other Values field, refer to Defining PV, CV, and/or SB values.
   	Amount Offer	Bundle Product Offer	In Offer Amount, enter the offer amount. In Offer on Other Values: Select the value to configure discounts on PV, CV, and/or SB in addition to the available transaction price of the bundle of products. Note: To enable the Offer on Other Values field, refer to Defining PV, CV, and/or SB values.
   	% Offer	Bundle Product Offer	In % Amount, enter the percentage offer in numeric format. In Offer on Other Values: Select the value to configure discounts on PV, CV, and/or SB in addition to the available transaction price of the bundle of products. Note: To enable the Offer on Other Values field, refer to Defining PV, CV, and/or SB values.
   Item Price Rules	Amount Offer	Summed Up Product Price Offer	In Summed Up Value, select the operators to provide offers based on the summed-up amount of matching items by product type, brand, and quantity. In Offer Amount, enter the offer amount.
   	% Offer	Summed Up Product Price Offer	In Summed Up Value, select the operators to provide offers based on the summed-up amount of matching items by product type, brand, and quantity. In Offer Amount, enter the offer amount.
   BOGO Rules	Fixed Offer	Buy X Get Y	In the Buy Item Condition section, add rules for buying item(s) as per your business requirements. This is optional. See Configuring Conditions for more information. In Buy Item Quantity, enter the quantity (in numeric format) that the customer has to buy. In the Get Item Condition section, add rules for getting item(s) as per your business requirements. This is optional. See Configuring Conditions for more information. In Get Item Quantity, enter the quantity (in numeric format) that the customer will get the items. Select any one of the following discount types: Each Discount – to provide discounts for each of the products. This value is shown by default. Flat Discount – to provide a flat discount on the final total amount. In @ Amount, enter the fixed offer amount.
   	Amount Offer	Buy X Get Y	In the Buy Item Condition section, add rules for buying item(s) as per your business requirements. This is optional. See Configuring Conditions for more information. In Buy Item Quantity, enter the quantity (in numeric format) that the customer has to buy. In the Get Item Condition section, add rules for getting item(s) as per your business requirements. This is optional. See Configuring Conditions for more information. In Get Item Quantity, enter the quantity (in numeric format) that the customer will get the items. Select any one of the following discount types: Each Discount – to provide discounts for each of the products. This value is shown by default. Flat Discount – to provide a flat discount on the final total amount. In Offer Amount, enter the offer amount.
   	% Offer	Buy X Get Y	In the Buy Item Condition section, add rules for buying item(s) as per your business requirements. This is optional. See Configuring Conditions for more information. In Buy Item Quantity, enter the quantity (in numeric format) that the customer has to buy. In the Get Item Condition section, add rules for getting item(s) as per your business requirements. This is optional. See Configuring Conditions for more information. In Get Item Quantity, enter the quantity (in numeric format) that the customer will get the items. In % Offer, enter the percentage offer (in numeric format).
   BOGO Rules	Fixed Offer	GWP	In the Buy Item Condition section, add rules for buying item(s) as per your business requirements. This is optional. See Configuring Conditions for more information. In Buy Item Quantity, enter the quantity (in numeric format) that the customer has to buy. In the Get Item Condition section, add rules for getting item(s) as per your business requirements. This is optional. See Configuring Conditions for more information. In Get Item Quantity, enter the quantity (in numeric format) that the customer will get the items. In Gift Product Id, enter an identifier of the Gift product. In Gift Sku Id, enter an identifier of the Gift SKU.
   	Amount Offer	GWP	In the Buy Item Condition section, add rules for buying item(s) as per your business requirements. This is optional. See Configuring Conditions for more information. In Buy Item Quantity, enter the quantity (in numeric format) that the customer has to buy. In the Get Item Condition section, add rules for getting item(s) as per your business requirements. This is optional. See Configuring Conditions for more information. In Get Item Quantity, enter the quantity (in numeric format) that the customer will get the items. In Gift Product Id, enter an identifier of the Gift product. In Gift SKU ID, enter an identifier of the Gift SKU.
   	% Offer	GWP	In the Buy Item Condition section, add rules for buying item(s) as per your business requirements. This is optional. See Configuring Conditions for more information. In Buy Item Quantity, enter the quantity (in numeric format) that the customer has to buy. In the Get Item Condition section, add rules for getting item(s) as per your business requirements. This is optional. See Configuring Conditions for more information. In Get Item Quantity, enter the quantity (in numeric format) that the customer will get the items. In Gift Product Id, enter an identifier of the Gift product. In Gift Sku Id, enter an identifier of the Gift SKU.
   BOGO Rules	Fixed Offer	Bundle GWP	In the Buy Item Condition section, add rules for buying item(s) as per your business requirements. This is optional. See Configuring Conditions for more information. In Buy Item Quantity*, enter the quantity (in numeric format) that the customer has to buy. In Gift Product Id*, enter a bundle product identifier of the Gift product. In Gift Sku Id*, enter a bundle SKU Kit identifier of the Gift SKU.
   	Amount Offer	Bundle GWP	In the Buy Item Condition section, add rules for buying item(s) as per your business requirements. This is optional. See Configuring Conditions for more information. In Buy Item Quantity*, enter the quantity (in numeric format) that the customer must buy. In Gift Product Id*, enter a bundle product identifier of the Gift product. In Gift Sku Id*, enter a bundle SKU Kit identifier of the Gift SKU.
   	% Offer	Bundle GWP	In the Buy Item Condition section, add rules for buying item(s) as per your business requirements. This is optional. See Configuring Conditions for more information. In Buy Item Quantity*, enter the quantity (in numeric format) that the customer must buy. In Gift Product Id*, enter a bundle product identifier of the Gift product. In Gift Sku Id*, enter a bundle SKU Kit identifier of the Gift SKU.
   BOGO Rules	Fixed Offer	Buy X and Y	In the Buy X Item Condition section, add rules for buying item(s) as per your business requirements. This is optional. See Configuring Conditions for more information. In Buy X Item Quantity, enter the quantity (in numeric format) that the customer has to buy. In the Buy Y Item Condition section, add rules for buying item(s) as per your business requirements. This is optional. See Configuring Conditions for more information. In Buy Y Item Quantity, enter the quantity (in numeric format) that the customer has to buy. Select any one of the following discount types: Each Discount – to provide discounts for each of the products. This value is shown by default. Flat Discount – to provide a flat discount on the final total amount. In @ Amount, enter the fixed offer amount.
   	Amount Offer	Buy X and Y	In the Buy X Item Condition section, add rules for buying item(s) as per your business requirements. This is optional. See Configuring Conditions for more information. In Buy X Item Quantity, enter the quantity (in numeric format) that the customer has to buy. In the Buy Y Item Condition section, add rules for buying item(s) as per your business requirements. This is optional. See Configuring Conditions for more information. In Buy Y Item Quantity, enter the quantity (in numeric format) that the customer has to buy. Select any one of the following discount types: Each Discount – to provide discounts for each of the products. This value is shown by default. Flat Discount – to provide a flat discount on the final total amount. In Offer Amount, enter the offer amount.
   	% Offer	Buy X and Y	In the Buy X Item Condition section, add rules for buying item(s) as per your business requirements. This is optional. See Configuring Conditions for more information. In Buy X Item Quantity, enter the quantity (in numeric format) that the customer has to buy. In the Buy Y Item Condition section, add rules for buying item(s) as per your business requirements. This is optional. See Configuring Conditions for more information. In Buy Y Item Quantity, enter the quantity (in numeric format) that the customer has to buy. In % Offer, enter the percentage offer in numeric format.
   Item Shipping Rules	Fixed Offer	Product Shipping Offer	In the Purchase Type drop-down list, select any one of the following: Batch Purchase Quantity – The customer must buy the products in large numbers as specified in the Purchase Quantity field. Minimum Purchase Quantity – The customer must buy the products as per the minimum quantity threshold, which is specified in the Purchase Quantity field to get the discount. Maximum Purchase Quantity – The customer must buy the products as per the maximum quantity threshold, which is specified in the Purchase Quantity field to get the discount. In the Purchase Quantity field, enter the quantity value in numeric format. Select any one of the discount types: Each Discount – to provide discounts for each of the products. This value is shown by default. Flat Discount – to provide a flat discount on the final total amount. In @ Amount, enter the fixed offer amount.
   	Amount Offer	Product Shipping Offer	In the Purchase Type drop-down list, select any one of the following: Batch Purchase Quantity – The customer must buy the products in large numbers as specified in the Purchase Quantity field. Minimum Purchase Quantity – The customer must buy the products as per the minimum quantity threshold, which is specified in the Purchase Quantity field to get the discount. Maximum Purchase Quantity – The customer must buy the products as per the maximum quantity threshold, which is specified in the Purchase Quantity field to get the discount. In the Purchase Quantity field, enter the quantity value in numeric format. Select any one of the discount types: Each Discount – to provide discounts for each of the products. This value is shown by default. Flat Discount – to provide a flat discount on the final total amount. In Offer Amount, enter the offer amount.
   	% Offer	Product Shipping Offer	In the Purchase Type drop-down list, select any one of the following: Batch Purchase Quantity – The customer must buy the products in large numbers as specified in the Purchase Quantity field. Minimum Purchase Quantity – The customer must buy the products as per the minimum quantity threshold, which is specified in the Purchase Quantity field to get the discount. Maximum Purchase Quantity – The customer must buy the products as per the maximum quantity threshold, which is specified in the Purchase Quantity field to get the discount. In the Purchase Quantity field, enter the quantity value in numeric format. Select any one of the discount types: Each Discount – to provide discounts for each of the products. This value is shown by default. Flat Discount – to provide a flat discount on the final total amount. In % Offer, enter the percentage offer in numeric format.
   	Formula	Product Shipping Offer	In the Purchase Type drop-down list, select any one of the following: Batch Purchase Quantity – The customer must buy the products in large numbers as specified in the Purchase Quantity field. Minimum Purchase Quantity – The customer must buy the products as per the minimum quantity threshold, which is specified in the Purchase Quantity field to get the discount. Maximum Purchase Quantity – The customer must buy the products as per the maximum quantity threshold, which is specified in the Purchase Quantity field to get the discount. In the Purchase Quantity field, enter the quantity value in numeric format. Select any one of the discount types: Each Discount – to provide discounts for each of the products. This value is shown by default. Flat Discount – to provide a flat discount on the final total amount. Enter the formula to provide the discount.
   Item Shipping Rules	Fixed Offer	Bundle Product Shipping Offer	In @ Amount, enter the fixed offer amount.
   	Amount Offer	Bundle Product Shipping Offer	In Offer Amount, enter the offer amount.
   	% Offer	Bundle Product Shipping Offer	In % Amount, enter the percentage offer in numeric format.
   Cart Price Rules	Fixed Offer	Cart Price Offer	In @ Amount, enter the fixed offer amount. In Offer on Other Values: Select the value to configure discounts on PV, CV, and/or SB in addition to the available transaction price of the bundle of products. Note: To enable the Offer in the Other Values field, refer to Defining PV, CV, and/or SB values.
   		Cart GWP	In GiftProductId*, enter the product ID. GiftSkuId*, enter the Sku Id. Note: Ensure that you enter the Sku ID that is associated with the product that you mention in the GiftProductId* field. GiftQuantity, enter the number of products to be associated/displayed as a gift on the cart page.
   	Amount Offer	Cart Price Offer	In Offer Amount, enter the offer amount. In Offer on Other Values: Select the value to configure discounts on PV, CV, and/or SB in addition to the available transaction price of the bundle of products. Note: To enable the Offer in the Other Values field, refer to Defining PV, CV, and/or SB values.
   		Trade In Offer	In Offer Amount, enter the offer amount.
   	% Offer	Cart Price Offer	In % Amount, enter the percentage offer in numeric format.
   		Trade In Offer	In % Amount, enter the percentage offer in numeric format.
   		Cart GWP	In GiftProductId*, enter the product ID. GiftSkuId*, enter the Sku Id. Note: Ensure that you enter the Sku ID that is associated with the product that you mention in the GiftProductId* field. GiftQuantity, enter the number of products to be associated/displayed as a gift on the cart page.
   	Formula	Cart Price Offer	In Formula, enter the formula to provide the discount.
   Cart Price Rules	Amount Offer	Trade In Offer	In Offer Amount, enter the offer amount.
   	% Offer	Trade In Offer	In % Amount, enter the percentage offer in numeric format.
   Cart Shipping Rules	Fixed Offer	Cart Shipping Offer	In @ Amount, enter the fixed offer amount.
   	Amount Offer	Cart Shipping Offer	In Offer Amount, enter the offer amount.
   	% Offer	Cart Shipping Offer	In % Amount, enter the percentage offer in numeric format.
   	Formula	Cart Shipping Offer	In Formula, enter the formula to provide the discount.

4. In the Action Conditions section, add rules as per your business requirements. This is optional. See Configuring Conditions for more information.
5. Click the Generate Conditions button and verify the result.
6. In the Locale Specific Message Description section, select the required locale and click the Add Locale button.
   Note:
   • The locales that are configured in the collection properties will appear for selection.
   • If the locale is not added, then the promotion-level locale is considered.
7. Enter the locale-specific display message and description. The Display Message field is mandatory, and the Description field is optional.
   Note: The information entered here overrides the information that is set at the promotion level.
8. Click the Save button.
   Note: To cancel the conditions without saving, click the Cancel button.

View an Action

To view an action,

1. Navigate to a promotion group and then click on the required promotion.
2. Click the ACTIONS tab and view all action details or particular action details.
   

Edit an Action

To edit an action,

1. Navigate to a promotion group and then click on the required promotion.
2. Click the ACTIONS tab.
3. Click the Edit icon against the action that you want to modify.
   
   The edit field details appear under the ACTIONS tab:
   
4. Edit the necessary details and click the Save button to save the changes.

Deleting an Action

To delete an action,

1. Navigate to a promotion group and then click on the required promotion.
2. Click the ACTIONS tab.
3. Click the Delete button against the action that you want to delete.
   
   The action is deleted.

Generating Promo Codes for the Promotion

You can choose to add promo codes to your promotions in the PROMO CODES tab. Adding promo codes to your promotions is optional. You can add promo codes manually or choose a promo code list that is already configured.

A promo code, which is associated with a promotion applies a discount when a set of conditions is met. The customer avails discounts by applying the code against their order on the shopping cart page of the e-commerce site. The codes will expire as per the date range configured in the promotion.

To set up promo codes for a promotion,

1. Navigate to the required promotion.
2. Click the PROMO CODES tab:
   
3. Click Add Promocodes.
4. Select any one of the following promo code types:
   The following table explains the promo code types:

   Promo Code Type	Description
   Multi User Multi Use	Multiple users can use the code multiple times. Note: You can reuse the expired promo codes in a new promotion.
   Multi User Multi Use – M-time Limited Offer	Multiple users can use the code multiple times; however, as per the overall usage count specified in “Overall Maximum usage count“. The field “Overall Maximum usage count” is mandatory. Note: You can reuse the expired promo codes in a new promotion.
   Multi User Multi Use – M-time Limited Offer	Multiple users can use the code multiple times; however, as per the overall usage count specified in “Overall Maximum usage count“. The field “Overall Maximum usage count” is mandatory. Note: You can reuse the expired promo codes in a new promotion.
   Multi User N-time Use Per User	Multiple users can use the code and it expires after a defined number of times per user as specified in “Maximum usage count“. The field “Maximum usage count” is mandatory. Note: You can reuse the expired promo codes in a new promotion.
   Single User Singe Use	A single user can use the code and it expires after using it one time.
   Single User N-time Use	A single user can use the code and it expires after a defined number of times as specified in “Maximum usage count“. The field “Maximum usage count” is mandatory.
   Single User N-Time Use Per X-days	A single user can use the code for a defined number of times as specified in “Maximum usage count” for defined days as specified in “No. of Days Count for maximum usage“. The field “No. of Days Count for maximum usage” is mandatory.

5. In the Promo Code List, select:
   • Manual – to add a promo code manually. To add another promo code, click the Add Code button.
   • a promo code list that is already configured. For more information, see Promo Codes List.
     
6. Click the Save button. The promo codes are added to the promotion.
   Note:
   • To cancel adding the promo codes, click the Cancel button.
   • To view the pre-configured promo code list, click the View button.
7. To export the pre-configured promo code list to the configured email address, click the Export button.

Managing the Existing Promotions

In a particular promotion group, you can:

• view the summary of an existing promotion and/or edit an existing promotion.
• create additional promo codes for a promotion that has been started and is in progress.
• search promotion(s) with default filters such as Project, Priority, Status, Date, Offer on, Offer ID, Offer type, and/or Stop further processing.
• view, update, and/or export the promotional codes.
• clone an existing promotion.
• delete a promotion.
• compare the projects of a promotion.

Viewing and/or Editing an Existing Promotion

To view and/or edit an existing promotion,

1. Navigate to a promotion group, and then to the promotion via the project approval workflow.
   Note: You can edit a promotion only via a project.
2. Click the Edit icon to edit the promotion, conditions, actions, and/or promo codes.
   
3. Make the necessary changes to the promotion.
   Note: You can edit all the fields, except Offer On and Offer Type. See Promotion creation fields.
4. Click the Save button to save the changes.
   Note:
   • In the CONDITIONS tab of the promotion, configure conditions if required. See Configuring Conditions.
   • In the ACTIONS tab of the promotion, configure the action details if required. See Edit an Action.
   • In the PROMO CODES tab, update the promo codes if required. See Generating Promo Codes to the Promotion.

Deleting a Promotion

You can delete a promotion only via a project approval workflow.

To delete a promotion,

1. Navigate to a promotion group, and then to promotion via a project; for example,
   
2. In the promotion list section, click the Delete icon against a promotion that you want to delete.
   
3. Click the Yes button, which deletes the promotion.

Cloning a Promotion

Overview

You can clone a promotion belonging to a promotion group or promotion schedule that has not started, in progress, or has expired. A promotion can be cloned within another promotion group that has not started or is in progress. Promotions cannot be cloned within a promotion group that has expired.

You can associate the promotion to any promotion group within the same store, any other store, or across stores. This avoids recreating a promotion completely, thus saving time. Once cloned, you can make necessary changes except to ‘Offer On’ and ‘Offer Type’ where the existing values will be retained. On the General page, you can edit the conditions and generate promo codes if required.

For steps on cloning an existing promotion, see the section How to Clone a Promotion.

Note:

If the status of the promotion that you clone is ‘ACTIVE’, the status will be automatically changed to ‘INACTIVE’ in the cloned promotion. You can change the status to ‘ACTIVE’ if required.

The promo codes in the source promotion will NOT be cloned.

The following table describes when cloning can be done:

Source Promotion Group	Destination Promotion Group Promotion Group into which the promotion is to be cloned
	YET TO START	STARTED	EXPIRED
Promotion Group that contains the promotion to be cloned (Any Status – YET TO START, STARTED, EXPIRED)	✔	✖	✖

How to Clone a Promotion

To clone a promotion,

1. Navigate to a promotion group and promotion via project approval workflow.
2. Click the Clone button:
   
   The Clone Promotion screen appears:
   
3. In the Promotion Group drop-down list, select:
   • Create New Promotion Group to clone the promotion in a new promotion group. Additional fields appear for creating a new promotion group.
     Note: Follow the same instructions that you do to create a new promotion group.
     
   • Select a promotion group from the list to clone the promotion to the existing promotion group.
     Note: Only the ‘YET TO START’ and ‘STARTED’ promotion groups will be listed in the ‘Promotion Group’ drop-down list.
     
4. Click the Save button to complete cloning.
   

Comparing the Projects of a Promotion

Overview

You can compare the existing projects of a promotion belonging to a promotion group. This helps to find the updates of the promotion performed via these projects. For example,  a Marketing Manager can compare the previously APPROVED project with an OPEN project to find the differences before approving the OPEN project. The projects to be compared can be in any status such as OPEN, SUBMITTED, APPROVED, etc.

For steps on comparing the existing projects of a promotion, see the section How to Compare the Projects of a Promotion.

How to Compare the Projects of a Promotion

To compare the projects of a promotion,

1. Navigate to a promotion group and promotion.
2. Click the Compare Projects button:
   
   Note: If a promotion has less than two projects, the Compare Projects button is disabled.
   The Compare Project screen appears:
   
   Note: On Compare Project screen by default the last updated projects in the Approved status are displayed.
3. Click the edit icon available on the left hand-side to select a project.
   The Select Project popup opens:
   Note: Similarly, select a project using the edit icon available on the right hand side.
4. Click the Select button to complete the selection.
   The comparison of the selected projects is shown.

Managing the Existing Promotion Groups

In the Promotion console home page, you can:

• backdate a particular promotion group’s start and end dates when it has not yet started.
• create or clone a promotion when a promotion group has been started and in progress.
• search by Project, Priority, Status, Date, or Stop further processing.
• view the summary of an existing promotion group or edit an existing promotion group.
• delete a promotion group.
• compare the projects of a promotion group.

Viewing or Editing a Promotion Group

To view and/or edit a promotion group,

1. On the Promotions home page, click on the required promotion group.
   
   The promotion group overview and list of promotions appear:
2. Click the Edit icon to modify the promotion group details:
   
   The Select Project pop-up opens. This is required to create a promotion group and get it approved by the Promotion Manager.
3. Select the required project. For example,
   
   Note: If the project is not available, then create a new project. For more information, see “Creating a New Project“.
4. Click the Edit icon to update the promotion group details. See Promotion Group Field Details.
   
   To create a new promotion, see Create a Promotion.
5. Click the Save button to update the promotion group.

Deleting a Promotion Group

You can delete a promotion group via the project approval workflow.

To delete a promotion group,

1. In the Promotions home page, click the Delete icon.
   
2. Click the Yes button in the confirmation message.
   
   The promotion group is deleted.

Comparing the Projects of a Promotion Group

Overview

You can compare the existing projects of a promotion group. This helps to find the updates of the promotion group performed via these projects. For example,  a Marketing Manager can compare the previously APPROVED project with an OPEN project to find the differences before approving the OPEN project. The projects to be compared can be in any status such as OPEN, SUBMITTED, APPROVED, etc.

For steps on comparing the existing projects of a promotion group, see the section How to Compare the Projects of a Promotion Group.

How to Compare the Projects of a Promotion Group

To compare the projects of a promotion group,

1. Navigate to a promotion group.
2. Click the Compare Projects button:
   
   Note: If a promotion group has less than two projects, the Compare Projects button is disabled.
   The Compare Project screen appears:
   
   Note: On Compare Project screen by default the last updated projects in the Approved status are displayed.
3. Click the edit icon available on the left hand-side to select a project.
   The Select Projects  popup opens:
   
   Note: Similarly, select a project using the edit icon available on the right hand side.
4. Click the Select button to complete the selection.
   The comparison of the selected projects is shown as follows:
   

Managing Promotion Lists

With List, you can upload multiple values to a list that is associated with specific operands. Add the values manually or bulk upload them as a .txt or .csv format file. After creating a list, you can add the required list(s) in the promotion group, promotion, and/or action conditions. While setting a rule, you can select a list for these specific operands and operators ‘in‘ and ‘not in‘.  You can edit a list even after a promotion has started.

On the Lists page, you can:

• create a new list, view/edit the existing list, and/or delete a particular list.
• search list(s) by List Name, Fields, or Status

For creating a promotion list, see the video below or the step-by-step instructions:

Creating a New List

To create a new list,

1. Click List in the left panel.
   
2. Click the Create List button to create a new promotion list.
   
   The Create Promotion List appears:
   
   The following table describes the Create Promotion List screen:

   Field	Description
   List Name	Enter a unique name for the list.
   Status	Assign the status of the list as Active or Inactive. Note: Only the list(s) with Active status appear in the conditions.
   List Type	Associate the list with any one of the following operands: SKU Bundle Cart User Payment B2B Accounts
   Field Type	Select the required field type. The field type appears based on the selected operands.

3. Click the Save button to create the promotion list. Now, you can start using the list for creating the conditions.
   Note: To cancel adding the promotion list, click the Cancel button.

Generating Promotion Lists

You can add list items to a list one by one or bulk upload the list file.

Adding List Items to a List Manually

To add list items to a list manually,

1. In the Promotions Admin console, click List in the left navigation panel.
   
   The following List page appears:
2. Click on a particular list to create a list of items within it. If there is no list available, you need to create a new list. For more information, see Create a New List.
3. Click Add List Items as shown below:
   
4. In List Item, enter the item.
5. To add more list items, click the Add List Item button.
6. Click the Save button to save the newly added list items.
   Note:
   To cancel adding the list items to the list, click the Cancel button.
   To delete a particular list item, click the Delete icon.

Bulk Upload List Items to a List

You can bulk upload promotion list items to a list from your local computer. The list item file should be separated by commas.

To bulk upload list items to a promotion list,

1. In the Promotions Admin console, click List in the left navigation panel.
   
   The following List page appears:
2. Click on a particular list to create a list of items within it. If there is no list available, you need to create a new list. For more information, see Create a New List.
3. Click the UPLOAD LIST tab.
   
4. Click the Add File button and select the .csv or .txt file from your local machine.
5. Once the upload is successful, click the Start Import button to import the uploaded list items onto the list.
   Note: To delete the uploaded file before importing it into the list, click the Delete icon against the uploaded file name.

Managing Promo Code Lists

Promotion codes are unique and can be used for multiple promotions.

In the Promo Codes List page, you can:

• create a new list of promo codes, view/edit the existing promo code list, and/or delete a particular promo code list.
• search list(s) by Promo Code List Name or Status
• download the promo codes into your local machine in a .csv file format.
• send the promo codes to your configured email address.

For creating a promotion code list, see the video below or the step-by-step instructions:

Create a Promo Code List

To create a new promo code list,

1. Click the Promo Codes List button in the left panel.
   
2. Click the Create PromoCode List button to create a new promo code list. The Create Promocode List screen appears:
   
3. The following table describes the Create Promocode List screen:
   

   Field	Description
   Promocode list Name	Enter a unique name for the promo code list. This field is mandatory.
   Status	Assign a status: Active – The promotion codes within the list will be available for use in the configured promotions. Inactive – The promotion codes will NOT be valid or available for use in the configured promotions. Note: Only the promo code list(s) with Active status appear in the promotions.

4. Click the Save button to complete creating the promo code list. Now, you can add promo codes to the list.
   Note: To cancel adding the promo code list, click the Cancel button. 

Generating Promo Codes for the Promo Codes List

Promotion codes are unique for a campaign. You can optionally choose to add promo codes to your promotions in the Promocodes tab.  You can add, generate, or upload unique promo codes to a promotion.

The promo code that is associated with a promotion applies a discount when a set of conditions are met. The customer avails discounts by applying the code against their order on the shopping cart page of the e-commerce site, while the promotion is valid. The codes will expire as per the dates selected in the promotion.

Adding Promo Codes Manually

To add promo codes to the promo codes list,

1. Click the Promo Codes List tab in the left panel.
2. Click the ADD PROMOCODE tab, which is shown by default upon clicking the Promo Codes List tab.
3. Click Add Promo Codes.
   Note:
   • To add another promo code, click the Add Code button.
   • To remove a promo code, click the Delete icon.
4. In Promo Code, enter the promo code and click the Save button.
   Note: This field accepts alphanumeric and special characters (such as hyphen “-” and underscore “_”).
5. The promo code(s) is saved to the promo code list which you can use in a promotion while configuring conditions.

Uploading Promo Codes via a File

You can upload the promo codes in a .csv or .txt format file from your local machine to a promotion. Promo codes in the file should be separated by commas.

To upload the promo codes,

1. Click the Promo Codes List tab in the left panel.
2. Click the UPLOAD LIST tab.
3. Click the Add File button and select the .csv or .txt file from your local machine.
4. Once the upload is successful, click the Start Import button to import the uploaded promo codes onto the promo code list.
   Note: To delete the promo code before importing it into the promo code list, click the Delete icon against the uploaded file name.

Generating Promo Codes Automatically

While generating promo codes, you can:

• add prefix and/or suffix to the system-generated promo codes.
• specify a maximum of 64 characters in the promo code including prefix and suffix characters that the system must generate.
• specify the number of codes the system must generate.
• specify if the promo codes generated can have alphabet, numbers, or alphanumeric characters.

To generate multiple promo codes automatically,

1. Click the Promo Codes List tab in the left panel.
2. Click the USE CODE GENERATOR tab.
3. Enter the number of promo codes you want to generate.
4. Enter the number of characters you want to have in a promo code including prefix and suffix values.
5. In Add Prefix, enter a term to have a prefix value to the promo code. This is optional.
6. In Add Suffix, enter a term to have a suffix value to the promo code. This is optional.
7. Select any one of the following:
   • Letters only – To generate only alphabets.
   • Numbers only – To generate only digits.
   • Use Both – To generate a combination of both digits and alphabets.
8. Click the Save button to generate the promo codes.

Downloading Promo Codes

Once the promo codes are saved, you can download them to your local computer in the CSV file format.

To download the promo codes,

1. In the left panel, click the Promo Codes List tab:
   
2. Click a particular promo code list name.
3. Click the Export button.
   
   The list of promo codes is downloaded to your local computer in a .csv file format.

Sending Promo Codes to Your Email

Once the promo codes are saved, you can send the list of promo codes to your configured email address.

To download the promo codes,

1. In the left panel, click the Promo Codes List tab:
   
2. Click a particular promo code list name.
3. Click the Send Mail button.
   
   The list of promo codes is sent to the configured email address.

Examples of Configuring Conditions and Actions

This section provides various examples of configuring conditions and actions for the various offer types.

Configuring Item Price Rules

This section explains how to configure promotion offers based on the offer rule Item Price Rules. You can,

• Configure a 100% Discount for a Normal Product
• Configure a 100% Discount for a Bundle Product
• 100% Discount for Combination of a Normal Product
• 100% Discount for Combination of a Bundle Product

Configuring a 100% Discount for a Normal Product

Scenario: If the customer orders one quantity of any of the configured items (normal products), the customer receives a $100 discount.

To configure a 100% discount for a normal product,

1. Create a promotion within the promotion group, as below,
   • Offer On: Item Price Rules
   • Offer type: % Offer 
     
2. In the CONDITIONS tab, specify the SKU ID to which you need to provide the discount.
   
3. Click the ACTIONS tab and configure the Action Type, Purchase Type, Purchase Quantity, and % Offers.
   
4. Click Save. Once the promotion is submitted and approved. The promotion appears on the storefront.

Configuring a 100% Discount for a Bundle Product

Scenario: The customer receives a $100 discount when the customer orders 1 quantity of the configured bundle item.

To configure a 100% discount for a bundle product,

1. Create a promotion within the promotion group, with the properties given below,
   • Offer On: Item Price Rules
   • Offer type: % amount or % Offer
     
2. In the CONDITIONS tab, specify the bundle ID to which you need to provide the discount.
   
   Note: While configuring the condition, ensure that you select the Bundle Id option.
   
3. Click the ACTIONS tab and configure the Action Type and % Amount or % offers.
   
   This configuration indicates that, when the bundle item (FixedK1001) is ordered, the customer will get a 100% discount.
4. Click Save. Once the promotion is approved. The promotion appears on the storefront.

100% Discount for Combination of a Normal Product

Scenario: When a combination of more than one product (normal products) is configured for a 100% discount, the system identifies the product that has the lowest price value and displays the promotion for that product.

To configure a 100% discount for a combination of normal products,

1. Create a promotion within the promotion group, as below,
   • Offer On: Item Price Rules
   • Offer type: % Offer
     
2. In the CONDITIONS tab, specify the SKU IDs to which you need to provide the discount.
   
3. Click the ACTIONS tab and configure the Action Type, Purchase Type, Purchase Quantity, and % Offer.
   
4. Click Save. Once the promotion is submitted and approved. The promotion appears on the storefront.

100% Discount for Combination of a Bundle Product

Scenario: When a combination of more than one product (bundle products) is configured for a 100% discount, the system identifies the product that has the lowest price value and displays the promotion for that product.

To configure a 100% discount for a combination of a bundle product,

1. Create a promotion within the promotion group, as below,
   • Offer On: Item Price Rules
   • Offer type: % Offer
     
2. In the CONDITIONS tab, specify the bundle IDs to which you need to provide the discount.
   
   Note: Ensure that you select the condition ID from the bundle option.
   
3. Click the ACTIONS tab and configure the Action Type, Purchase Type, Purchase Quantity, and % Offers.
   
   Note: Ensure that you select the Action Type as “Bundle Product Offer”
4. Click Save. Once the promotion is submitted and approved. The promotion appears on the storefront.

Configuring BOGO Rules

This section explains how to configure promotion offers based on the offer rule BOGO Rules.

You can,

• Configure a Gift for a Bundle Product based on a Product Id
• Configure a Gift for a Bundle Product based on a Category Id

To provide Buy One Get One 10% offer for an item:

1. In the Offer On field, select BOGO Rules.
   
2. In the Offer Type field, select %offer.
3. Click the ACTIONS tab and specify the Action Name and Action Type.
   
4. In the Condition field, define the conditions, Buy Item Quantity, and Get Item Quantity as 1.
5. Click Save. Once the promotion is submitted and approved. The promotion appears on the storefront.

Configuring a Gift for a Bundle Product Based on a Product Id

Scenario: Configure a gift for a bundle product based on a product Id

To configure a gift for a bundle product based on a product ID,

1. Create a promotion within the promotion group, with the below properties,
   • Offer On: BOGO Rules
   • Offer type: % Offer
     
2. Click the ACTIONS tab.
3. In the Action Type field, select Bundle GWP to configure the promotion for a bundle product.
4. In the Buy Item Condition section, click Add Rule and configure the Bundle ID details that need to be purchased. For example, 6102 1465/9996.
   
   Note: Ensure that you select the Id from the Bundle option.
   
5. In the Buy Item Quantity field, enter the number of gift quantities.
6. In the Gift Product Id field, enter the product ID.
7. In the Gift SKU Id field, enter the SKU ID.
   
   Note: Ensure that the entered SKU ID is associated with the given product ID.
   • This configuration indicates that when the customer purchases the bundle product “61021465/9972”, the item “6102 1465/9996” is offered as a gift.
8. Click Save. Once the promotion is submitted and approved. The promotion appears on the storefront.

Configuring a Gift for a Bundle Product Based on a Category ID

You can configure a gift for a bundle product based on a category ID. Here, the configured gift appears on the storefront only when the user accesses the product via the configured category. For example,

Let us consider two categories that have the same bundle of products.

• Category 1: Fashion
  • Products in category 1 are Jean’s bundle, T-Shrit short-sleeve, and T-Shrit long-sleeve.
• Category 2: Work Wear
  • Products in category 2 are jeans bundles, stripped T-shirts, and polishing bars.

Now, when you configure the category “Fashion” and the product “Jean’s bundle” using the condition “AND” as shown in the below scenario. The promotion offer appears on the storefront for the product “Jean’s bundle” ONLY when you access the product from the category “Fashion”.

Note: The promotion offer does not appear on the storefront when you access the same product via other categories for example “Work Wear”.

Scenario: Configure a gift for a bundle product from a particular category.

To configure a gift for a bundle product from a particular category,

1. Create a promotion within the promotion group, with the below properties,
   • Offer On: BOGO Rules
   • Offer type: Fixed Offer
2. Click the Action button.
3. In the Action Type field, select Bundle GWP to configure the promotion for a bundle product.
   
4. In the Buy Item Condition section, click Add Rule.
5. In the operand field, under the Bundle section, select Category Id to configure the promotion based on a category.
   
6. Click the condition “AND” and then click on Add rule and configure the bundle product ID to which you need to configure the promotion offer.
   
   Note: It is mandatory to specify the product ID using the AND condition; only then the promotions offer appear on the storefront.
   

Configuring a Promotion for the Target Group Users

A unique SAP ID is generated in the “reference attribute” during a new user’s sign-up. Infosys Equinox or a third party collects that SAP ID during sign-up. Based on events, such as holiday gifts, etc., a list is created under the “list” section with a collection of the user’s SAP ID and imported to the promotions admin. These user lists are the target group users; you can configure promotions for users associated with the lists.

You can,

• Configure a Promotion for the Target Group Users
• Configure a Promotion for the Target Group Users using the Promo Code

You can also create the required user list for the target group using the Promotion List. See Managing Promotion Lists.

Configuring a Promotion for the Target Group Users

This section explains how to configure promotions for target group users.

Scenario: Only the users associated with the list item receive a gift when any of them places an order.

Prerequisite

Before you begin, ensure that you,

• have the User List with the signed-in users in the List.
• created new list items (list of users and/or values) in the List tab if required.

To configure a promotion for target group users,

1. Create a promotion within the promotion group, as below,
   • Offer On: Cart Price Rules
   • Offer type: % Offer
     
2. Click the ACTIONS tab to specify the Action Type, % Offer, and Action Condition.
   
   Note: In the Actions page, ensure that the mentioned SKU ID is associated with the specified product ID.
3. In the Action Condition section, click Add Rule and add the name of the list.
   
   This configuration indicates that the given product appears as a promotion only for the users who are part of the list. See Creating the User List.
4. Click Save. Once the promotion is submitted and approved. The promotion offer appears on the storefront.

Configuring a Promotion for the Target Group Users using the Promo Code

Scenario: Only the users associated with the list item receive a gift when any of them place an order and only if they enter the promo code.

Prerequisite

Before you begin, ensure that you,

• have the User List with the signed-in users in the List.
• created the required List Item (list of users and/or values) in the List tab.

To configure a promotion for Target Group users using the promo code,

1. Perform Step 1 to Step 4 mentioned in the section Configuring a promotion for the target group users.
2. Click the PROMO CODES tab and specify the promo code as mentioned below.
   
   Note: This configuration indicates that when the list of users associated with the list item (Preferred Customer /Member) places an order, the storefront displays the gift (01550095), and the promo code offers “AF12340”.
3. Click Save.
4. Once the promotion is submitted and approved. The promotion offers appear on the storefront.
   Note: In order to customize the promotion, offer for users using the promocodes type, refer to Generating Promo Codes for the Promotion section in the Promotions Admin User Guide.

Configuring Cart Price Rules

This section explains how to configure an offer on Cart Price Rules.

You can,

• Configure a Promotion for the Cart Price Rules or Trade In Offers
• Configure Cart GWP Promotion

Configuring a Promotion for the Cart Price Rules or Trade In Offers

Scenario: The customer receives a 10% discount whenever the total amount in the cart is greater than or equal to $200.

To configure Cart GWP promotion,

1. Create a promotion within the promotion group, as below,
   • Offer On: Cart Price Rules
   • Offer type: Amount offer
     
2. In the CONDITIONS tab, configure the condition as mentioned in the screen below:
   
3. Click the ACTIONS tab and specify the Action Type and % Offer fields.
   
4. You can specify the Offer on other values, % Offer on PV, and % Offer on CV fields. This is optional.
   Note:
   • These fields appear if you define the PV and CV options in the collection and the store properties. See, Defining PV, CV, and SB.
   • This configuration indicates that whenever the total price in the cart is greater than or equal to 200, the customer receives a 10% discount. You can configure the 10% PV offer and 10% CV offers.
5. Click Save. Once the promotion is submitted and approved. The promotion offer appears on the storefront.

Configuring a Promotion for the Cart GWP

This section explains how to configure Cart GWP.

Scenario: The customer receives the defined product as a gift whenever the cart’s total amount is $1500.

Pre-requisites: Ensure that you create a Promotion group before configuring the promotion. See Creating a Promotion Group.

To configure Cart GWP promotion,

1. Create a promotion within the promotion group, as below,
   • Offer On: Cart Price Rules
   • Offer type: % Offer
2. In the CONDITION tab, configure the condition.
   
   Note: If you do not specify the condition, then the gift appears for all price values on the cart items.
3. Click the Action tab and specify the Action Type, GiftProdutID, GiftSKUID, and GiftQuantity fields.
   Note: Ensure to select the CartGWP option in the Action Type field.
4. Under the Action Condition section, click Add rule and specify to configure the GWP for the preferred cart item.
   
5. In the Cart option, select the required option.
6. Click Save. Once the promotion is submitted and approved. The promotion offer appears on the storefront.

Configuring Item Shipping Rules

Cart Shipping Rules allow you to set up a cart shipping offer.

This section explains how to configure promotion offers based on the offer rule “Item Shipping Rules”.

To configure the item shipping rule for an item,

1. Create a promotion within the promotion group, as below,
   • Offer On: Item Shipping Rules
   • Offer type: % Offer
     
2. In the CONDITION tab, click the Add rule button and specify the necessary condition.
   
3. Click the ACTIONS tab and add actions as shown below.
   
   This configuration indicates the 100 percent shipping offer.
4. Click Save. Once the promotion is submitted and approved. The promotion offers appear on the storefront.

Configuring Cart Shipping Rules

This section explains how to configure promotion offers based on the offer rule “Cart Shipping Rules”.

To configure the cart shipping rules for an item,

1. Create a promotion within the promotion group, as below,
   • Offer On: Cart Shipping Rules
   • Offer type: % Offer
     
2. In the CONDITION section, click the Add rule button and specify the condition.
   
3. Click the ACTIONS tab and add actions as shown below.
   
4. In the Action Conditions section, click the Add rule button and configure the condition as shown below.
   
   Note: This configuration indicates that the customer receives a 100% offer on the overall cart price if the amount is greater than or equal to $99 and the shipping method adheres to the given condition.
5. Click Save. Once the promotion is submitted and approved. The promotion offer appears on the storefront.

Configuration a Promotion with PV and CV Discounts

The Point Volume (PV), Commission Volume (CV), and Sharing Bonus (SB) are the additional components/values assigned to the products. You can apply discounts to the additional values (PV, CV, and/or SB) that are assigned to the products at the item level and cart level.

• Defining PV, CV, and SB
• Configuring Item Level PV and CV Discounts for a Normal Product
• Configuring Item Level PV and CV Discounts for a Bundle Product

Defining PV, CV, and SB

The values of the transaction price, PV, and CV are applicable for both normal products and special products such as bundles, fixed bundles, and SKU kits for the default SKU. In addition to the transaction price, you can configure promotion offers for additional components like PV, CV, and SB using the item price and cart price rules in the Actions tab. The discounts are applied to the product or bundle at the item level and cart level. The promotion admin and/or editor can enable the PV, CV, and SB discounts for the promotion. Before configuring a promotion, it is mandatory to update the below collection property and the store-level properties.

To define PV, CV, and SB,

1. Navigate to the Advanced tab of the store and add the default property Property Key: allowedPromotionPriceFacets and its Property Value: PV, CV, and SB. See Edit a Store.
   Note:
   • When required update the “excludePriceFacets” property to exclude the PriceFacets, which excludes the mentioned value (additional component) from the discount functionality and does not display in the Store Front.
   • For detailed information, see the Adding Store Specific Properties section, in the Configuring Store Properties section.
2. Update the Collection Property “ruleengine.settings” under the Item Price Rule and Cart Price Rule, as well as the actions for % offer, Fixed Offer, and Amount offer. See Collection Properties.
3. As part of displaying the discounted PV, CV, and/or SB for a product on the storefront, you need to configure PV, CV, and SB as custom price types in the Pricing service.  See Adding a Custome Price Type.

Configuring Item Level PV and CV Discounts for a Normal Product

Scenario: This configuration indicates that when the customer orders the item 01001790 or 01550095, the customer receives a 100% discount, a 10% PV offer, and a 20% CV offer.

Pre-requisites

It is mandatory to define the PV and CV options in the collection properties and the store properties. See Defining PV, CV, and SB.

You can define PV and CV discounts on the values of the transaction price. Ensure that the store property “allowedPromotionsPriceFacets” is configured in the Foundation admin Console.

To configure item-level PV and CV discounts for a normal product,

1. Create a promotion within the promotion group with the configurations given below,
   • Offer On: Item Price Rules
   • Offer type: % Offer
     
2. Click the CONDITIONS tab and configure the condition as shown below.
   
3. Click the ACTIONS tab and configure the fields Action Type, Purchase Type, Purchase Quantity, % Offer, Offer on Other Values, % Offer on PV, and % Offer on CV.
   
   This configuration indicates that when the customer orders items 01001790 or 01550095, the customer receives 20% discount, a 10% PV offer, and a 20% CV offer.
4. Click Save. Once the promotion is submitted and approved. The promotion offer appears on the storefront.
   Note: The storefront displays business-defined PV and CV values for the products. The PV and CV discounts appear only for those products that are configured with PV and/or CV offers.

Configuring Item Level PV and CV Discounts for a Bundle Product

Pre-requisites:

Ensure the values PV and CV are added in the collection properties and the store properties to configure discounts for PV and/or CV values. See Defining PV, CV, and SB.

To configure a promotion for a bundle product,

1. Create a promotion within a promotion group with the configurations given below,
   • Offer On: Item Price Rules
   • Offer Type: % Offer
     
2. Click the CONDITIONS tab and configure the condition as shown below.
   
3. Click the Action tab and specify the fields, Action Type, % Amount, Offer on other Values, % Offer on PV, and % Offer on the CV fields.
   
   Note: Select the Bundle Product Offer in the Action Type field.
   Scenario: This configuration indicates that whenever the bundle item “FixedK1001” is ordered, the customer receives a 100% discount, 10% PV offer, and 30% CV offer.
4. Click Save. Once the promotion is approved. The promotion appears on the storefront.

Example 1: If the transaction price of an item is $100, PV is 30, and CV is 20, then the customer can configure a 10% discount for all of them (transaction price, PV, CV, etc.) or a 50% discount for the transaction price, 20% for PV, and 10% for CV. In this scenario, the value of the transaction price becomes $50, the PV value is 24, and the CV value is 18.

Example 2: In the case of multiple discounts for bundles, each discount is applied based on priority.

• Discount 1: A 10% discount applied to the transaction price of $150 results in a $15 discount value, which results in the final discounted value of $135.
• Discount 2: A 5% discount applied to the transaction price of $135 results in a $6.75 discount value, which results in the final discounted value of $128.25.
  Note: In this scenario, the promotion admin first calculates the discount of 10% and then applies the 5% offer to the discounted value.

Discount 1 (with priority 24): Since it is a bundle product, a 10% discount is applied first to the transaction price, PV, and CV values.

Discount 2 (with priority 25): The discounted value receives 5% off that is applied second on the transaction price, PV, and CV values because of a coupon code.

Configuring Frequency-Based Promotions

This section explains how to configure frequency-based promotions.

You can configure the following,

• A promotion for monthly frequency
• promotions frequency with properties
• Channel Type
• Order Type
• Loyalty customer tier-based promotion
• Loyalty Opt-in status

Configuring a Promotion for Monthly Frequency

This section explains how to configure a promotion for a monthly frequency.

To configure a promotion for monthly frequency,

1. Create a promotion within the promotion group and define the fields as shown below.
   
   Note: Select “Monthly” in the frequency field and define the values.
2. Click the CONDITIONS tab and configure the conditions, as shown on the screen:
   
3. Under the Action section, click Add rule to specify the action and the condition as shown on the screen.
   This configuration means the customer avails 10% offer for the first order in a month when the cart level item price is greater or equal to 100.
4. Click Save. Once the promotion is submitted and approved. The promotion offer appears on the storefront.

Configuring the Frequency-Based Promotions with Properties

This section explains how to configure a promotion with the following properties:

• Channel Type
• Order Type
• Loyalty customer tier-based promotion
• Loyalty Opt-in status

Channel Type

You can configure promotions for the channel types:

• Web
• Phone
• WIC (Walk In Centre)

To configure frequency promotions based on the channel type,

1. Create a promotion within the promotion group and define the fields as mentioned below.
   
2. Click the CONDITIONS tab and configure the conditions as shown below.
   
3. Click the ACTIONS tab and define the actions as shown below.
   
   This configuration indicates that when a web user or a CSR user orders the products “01003901” or “01010621”, the user receives the product “01001790” as a gift for the first purchase in a month.
4. Click Save. Once the promotion is submitted and approved. The promotion offer appears on the storefront.

Loyalty Customer Tier-Based Promotion

Scenario: On a monthly basis, a gift must be given to the loyalty T2 or T3 customers whose cart’s total price is greater than or equal to $1000. So that customers obtain the advantage of the offer on their first purchase at the specified monthly frequency.

Prerequisite:

Before you begin, ensure that the opt-in functionality options are configured in the store properties “tierConfigMap” and the collection property “customActionTypesConfig” of the Loyalty service.

To configure frequency promotions with tire-based properties for Loyalty customers,

1. Create a promotion within the promotion group and define the fields as shown below:
   
   Note: Ensure that you select “Monthly” in the frequency field and define the required value.
2. Click the CONDITIONS tab and configure the conditions as shown below:
   
3. Click the ACTIONS tab and define the actions as shown below:
   
   This configuration indicates that whenever the cart’s total price is greater than or equal to 150, the item “01001647” is offered as a gift to T2 or T3 customers once a month on their first purchase. 
4. Under the Action section, click Add rule and configure the condition for the action as shown below:
   
   Note: This configuration indicates that whenever the cart’s total price is greater than or equal to 150, the item “01001647” is offered as a gift ONLY to the Tier 2 or Tier 3 loyalty customers once a month on their first purchase.
5. Click Save. Once the promotion is submitted and approved. The promotion offer appears on the storefront.

Loyalty Opt-in status

Scenario: A gift must be given only to loyalty users based on a monthly frequency. So that Loyalty users get a gift on their first purchase once every month.

Prerequisite:

Before you begin, ensure that the opt-in is in the store properties “allowedRewardTypesForOptIn” and the collection property “customActionTypesConfig” of the Loyalty service.

To configure frequency for the opt-in loyalty customers,

1. Create a promotion within the promotion group and define the fields.
   • Offer type: Cart Price Rules
   • Offer type: Fixed offer or % offer
2. Frequency: Monthly
3. Frequency value: “1” the customer can avail of the offer once a month. “2” the customer can avail of the offer once in two months.
4. Promotion Identifier: Loyalty01
   Note: Ensure to select “Monthly” in the frequency field and define the required value.
5. Click the CONDITIONS tab, click the Add Rule button, and define the rule.
6. Click the ACTIONS tab and define the actions as mentioned below:
   
   Note: Ensure that the specified SKU ID is associated with the specified Product ID.
7. Under the Action Condition section, click Add rule and specify the condition (property value).
   Note:
   • If you do not specify the condition, then the gift appears for all cart items checkout. For different condition-based scenarios, see Loyalty opt-in conditions.
   • Ensure that you select the Property option within the Cart since the offer is for the Cart Price.
8. Click Save. Once the promotion is submitted and approved. The promotion offer appears on the storefront.

Loyalty Opt-In Conditions:

You can configure the following conditions for the loyalty opt-in customers:

• Condition 1: Opting for loyalty:
  • If the user opted loyalty for a month and places his order, then the user gets the gift in his first order.
  • The gift is not applicable if the same user places his second order in the same month.
• Condition 2: Opting for loyalty in the middle of a month:
  • If the user opts for loyalty in the middle of a month, the user receives a gift on the first order. The same offer is not applicable when the user places a second order in the same month.
  • When the user places the order for the next month, the gift is applicable for the first order of that month.
• Condition 3: Loyalty opt-in/opt-out in the same month:
  • The user opt-ins for loyalty, receives a gift on the first order, and opts out in the same month.
  • Again, if the user opts in and places the first order, then the gift is not applicable, because the gift is already provided.

Configuring a Promotion Based on Property Support

The purpose of this functionality is to apply for property support in promotions. You can configure Cart property, User property, and Order property for Storefront users, CSR users, and various other users.

Channel Type

• Web
• Phone
• WIC (Walk In Centre)

Scenario: A gift is provided to the WIC customer.

To configure a promotion based on the channel type (WIC),

1. Create a promotion within the promotion group and define the fields.
   • Offer type: BOGO Rules
   • Offer type: Fixed offer or % Offer
     
2. Click the CONDITIONS tab and configure the condition.
   
3. Click the ACTIONS tab and define the actions.
   
   This configuration indicates that a gift “0100790” is given to the WIC customer.
4. Click Save. Once the promotion is submitted and approved. The promotion offer appears on the storefront.

 

Subscription Order Type

Scenario: A gift is offered to a customer when the cart’s total price value is greater than or equal to $200 and it is a subscription order.

To configure frequency promotions based on the order type,

1. Create a promotion within the promotion group and define the fields.
   • Offer type: Cart Price Rules
   • Offer type: Fixed offer or % Offer
     
2. Click the CONDITIONS tab and click the Add Rule button to define the rule.
   
3. Click the ACTIONS tab and configure the actions.
   
4. Under the Action Condition section, click Add rule and specify the condition (property value).
   
   Note: While configuring conditions for the actions, ensure that you select the property from the cart option for the cart-level offer.
   
   This configuration indicates that when the total price in the cart is greater than or equal to $200, and there is a subscription order, the user receives the product 01001791 as a gift.
5. If the order type is defined as “standard”, then the user receives the gift for all the orders, irrespective of subscription orders.
6. Click Save. Once the promotion is submitted and approved. The promotion offer appears on the storefront.

Standard Order Type

Scenario: A 20% offer is provided when the customer’s cart’s total prize value is greater than or equal to $200 and it is only a standard order.

To configure frequency promotions based on the order type,

1. Create a promotion within the promotion group and define the fields.
   • Offer type: Cart Price Rules
   • Offer type: % offer
     
2. Click the Conditions tab, and click the Add rule button to define the rule.
   
3. Click the ACTIONS tab and configure the actions.
   
4. Under the Action Condition section, click Add rule and specify the condition (property value).
   
   Note: While configuring conditions for the actions, ensure that you select the property from the cart option for the cart-level offer.
5. If the order type is a standard order, the user receives a 20% offer that excludes subscription orders and other property orders.
6. Click Save. Once the promotion is submitted and approved. The promotion offer appears on the storefront.

Configuring a Promotion Based on the Attribute Values

The product attributes are configured with the discount values in the Catalog Service. You can configure a promotion offer for those product attribute IDs so that the discount value is applied to the exact price and the offer displays on the storefront.

This section explains how to configure a promotion based on the attribute values, you can,

• Configuring a Promotion Based on Attribute Values for a Normal Product
• Configuring a Promotion Based on Attribute Values for a Bundle Product

Prerequisite:

Before you begin,

1. It is mandatory to create the property key “productPropertiesForPromotion” with the property values “grpdis,pvdis,cvdis,sbdis,whlpricedis,rtlpricedis” at the store-level in the Foundation Admin Console.
   
2. It is mandatory to update the collection property “ruleengine.settings” with the values “PV, CV, GRP, SB, Retail, and Wholesale”, ONLY then the values are enabled in promotion for configuration. See Collection Properties.
3. Navigate to the Catalog, and then the Attributes tab to check that the required attributes are defined as the default attributes in the Catalog microservice. For example, pvdis, cvdis, rtlpricedis, whspricedis are the attributes in the Catalog. See Creating Attributes and Import Attributes.
   

Configuring a Promotion Based on Attribute Values for a Normal Product

To configure promotions based on the attribute values for a normal product,

1. Create a promotion within the promotion group, and define the fields as shown below.
   
2. Click the ACTIONS tab and define the actions as shown below.
   
3. In the % Offer field, specify the offer as mentioned in the given format ${attribute ID}.
4. If required, configure the PV, CV, SB, GPR, retail, and/or wholesale values as shown in the below screen.
   
   Note:
   • Ensure that you specify the correct attribute ID. The attribute ID should be the same as in the Catalog Attributes. See Managing Attributes.
   • For example, if the attribute ID in the catalog service is “whlpricedisc” then the offer should be as ${whlpricedisc} represented with the same attributes ID in the given format. If the attribute ID is “pvoffer” then the formula should be ${pvoffer}.
     
5. Navigate to the Catalog, and then the Products page to check these attributes are associated with the products. see Adding Attributes to a Product.
6. Click Save. Once the promotion is submitted and approved. The promotion offer appears on the storefront.

Configuring a Promotion Based on Attribute Values for a Bundle Product

To configure a promotion based on the attribute values for a bundle product,

1. Create a promotion within the promotion group, and define the fields as shown in the below screen.
   
2. Click the CONDITIONS tab and configure the condition for a bundle product.
   
   Note: Ensure that you select the ID within the Bundle option.
3. Click the ACTIONS tab and define the actions as shown below.
   
4. In the % Offer field specify the offer as mentioned in the given format ${attribute ID}.
5. If required, configure the PV, CV, SB, GPR, retail, and/or wholesale values as shown below.
   
   Note:
   • Ensure that you specify the correct attribute ID. The attribute ID should be the same as in the Catalog Attributes.
   • For example, if the attribute ID in the catalog service is “whlpricedisc” then the offer should be as ${whlpricedisc} represented with the same attributes ID in the given format. If the attribute ID is “pvoffer” then the formula should be ${pvoffer}.
     
6. Click Save.
7. Navigate to the Catalog > Products page to ensure these attributes are associated with the products. see Adding Attributes to a Product.
   Once the promotion is submitted and approved. The promotion offers appear on the storefront.

Managing Feed Jobs

You can manage the feed jobs of the Promotion microservice via the Batch Jobs dashboard. For more details on Promotion feeds, refer to the page Feed – Promotion. Each feed can contain multiple batch jobs which in turn may contain multiple schedules.

Note: You can also view the batch jobs of a Promotion collection on the collections management page. For more details, see Managing Collections of a Microservice.

With the Promotion Batch Job dashboard, you can:

• View the Job Schedules of a Feed Job
• View the Running Details of a Feed Job
• Edit a Feed Job
• Edit or Retrigger a Job Schedule

For managing the feeds, see the video below or the step-by-step instructions:

Note: The above video is updated for Release 8.11.

View the Job Schedules of a Feed Job

To view the job schedules of a batch job,

1. In the Promotion homepage, click Batch Jobs in the left navigation panel.
   
   The Batch Jobs page is displayed.
   
2. Click a particular batch ID to view the job details of a promotions.
   
   Note: If you want to view the Job Details and Job History, click History.
   
3. Click on a Job ID to view the Job Schedules.
   
   The Job Schedules are displayed.

View the Running Detail of a Feed Job

To view the running details of a feed job,

1. In the Promotion homepage, click Batch Jobs in the left navigation panel.
   
   The Batch Jobs page is displayed.
   
2. Navigate to the Job Schedules page. The Job Schedules are displayed.
   
3. Click History in the left navigation. The history of running job schedules with Run Request ID, Status, Start Time, and End Time is displayed. The Job Histories page is displayed.
   
   Note:
   • The Created Time displays the date and time when the job is created for the first time.
   • The Updated Time displays the date and time as and when the job is updated.
4. Click a particular History ID. The running history details and the summary log of the selected schedule appears:
   
   The following table provides the field description for the History Details page:

   Field	Description
   View Summary	To view the JSON summary, click View Summary.
   Retrigger	To repeat the batch job, click Retrigger.
   Summary Log	To view the log, click Summary Log.

Edit a Feed Job

To edit a feed job,

1. In the Promotion homepage, click Batch Jobs in the left navigation panel.
   
   The Batch Jobs page is displayed.
   
2. Click on Batch ID to view the job schedule details.
   
   Note: If you want to view the history of a particular job, click History.
   
3. Click on a Job ID to view the job schedules.
   
   The Job Schedule Details are displayed.
   
4. Click the Edit icon.
   
5. Edit the details.
   The following table provides the field description to edit Feed Jobs:

   Field	Description
   Name	Update the name of the job.
   Description	Update the description of the job.
   Status	Change the status to any one of the following: ACTIVE – active batch jobs will be triggered. INACTIVE – inactive batch jobs will not be triggered.
   Max Run Time	Update the maximum running time (in seconds) of the job. The feed will be terminated if it exceeds the maximum running time limit.
   Add Job Params	Click the + Add Job Params button to add one or more job params with a Property Key and Property Value. Note: This property key-value pair impacts the configuration of the active job execution.

6. Click Save. The Feed Job details are updated.

Creating a Job Schedule

You can create a job schedule using the Create Schedule button on the Job Schedules page.

To create a job schedule,

1. Navigate to the Job Details page.
2. Click the Create Schedule button.
   
   The Create Schedule Details page is displayed.
   
3. Enter the field details.
   The following table provides the field description for creating a schedule:

   Field	Description
   Name*	Update the name of the job schedule.
   Description*	Update the description of the job schedule.
   Status*	Change the status to any one of the following: ON DEMAND – The job schedule is triggered immediately. INACTIVE – The job schedule is not triggered. SCHEDULED – The job schedule is triggered repeatedly in a given interval of time. The time interval is specified in the field Repeat Interval.
   Batch Interval	Specify the batch refresh interval (in seconds). The value should be less than or equal to Repeat Interval. For example, Repeat Interval is 1800 seconds and Batch Interval is 180 seconds. At each refresh interval, the system checks the completion of the Repeat Interval duration.
   Repeat Interval	Update the frequency interval (in seconds), which triggers the job schedule repeatedly. The job Start Time is updated based on Repeat Interval.
   Last Run Time	Update the last run time (in seconds) of the job schedule.
   Max Run Time	Update the maximum running time (in seconds) of the job schedule. An alert email will be sent if it exceeds the maximum running time limit.
   Start Time	Update the start time of the job schedule.
   End Time	Update the end time of the job schedule.
   Add Job Params	Click the Add Job Params button to add another job parameter with a Property Key and Property Value. This property key-value pair impacts the configuration of the active job execution.

   Note: Fields marked with * are mandatory.

4. Click Save to create the schedule.

Edit or Retrigger a Job Schedule

To edit or retrigger a job schedule,

1. Navigate to the Batch Job details page. For more information, refer to Edit a Feed Job.
2. If you want to edit the Job Schedules under a Job ID, click on a Job Schedule ID. The Schedule Details are displayed.
   
3. Click the Edit icon to edit the job schedule.
   
   Note: To retrigger the Schedule, click Retrigger.
   The edit page is displayed.
4. Edit the Schedule details.
   The following table provides the field description for editing a job schedule:

   Field	Description
   Name	Update the name of the job.
   Description	Update the description of the job.
   Status	Change the status to any one of the following: ON DEMAND – The feed job is triggered immediately if it is scheduled to run the job. INACTIVE – The feed will not be triggered. SCHEDULED – The job will be triggered repeatedly in a given interval of time. The time interval is specified in the field Repeat Interval.
   Batch Interval	Specify the period between feed schedules (in seconds). The feed Start Time is updated based on Batch Interval.
   Repeat Interval	Update the frequency interval in seconds. The job will be triggered repeatedly by this interval.
   Last Run Time	Update the last running time of the job.
   Max Run Time	Update the maximum running time (in seconds) of the job. The feed will be terminated if it exceeds the maximum running time limit.
   Start Time	Update the start time of the job.
   End Time	Update the end time of the job.
   Add Job Params	Click the + Add Job Params button to add one or more job params with a Property Key and Property Value. Note: This property key-value pair impacts the configuration of the active job execution.

5. Click Save. The job schedule details are updated.

Projects Approval Access and Workflow

Based on the business requirements, a Business Admin can enable or disable the project access. This is done using the property defaultprojectaccess while configuring a microservice collection. When the ‘defaultprojectaccess‘ is enabled, the Project icon is not displayed in the header and the select project pop-up is not displayed at the time of creating, editing or cloning promotion actions.

Enabling or Disabling Project Access and Workflow

The Project Approval workflow is processed based on enabling/disabling the collection properties ‘defaultprojectaccess’ and ‘disable_project_workflow’ of the Promotions service.

Note: You can configure the collection properties when you Create a Collection or while Updating a Collection. Also, see Collection Properties.

The three different Project Approval workflow flows are:

Function	Description	Collection Property
		defaultprojectaccess	disable_project_workflow
Mandatory Project Approval workflow	All additions and/or changes to data requires approval by a microservice manager role (for example, Promotion Manager) before they can go into effect. The approval process requires a project approval workflow which is managed via Projects option that is visible in the header. As a mandatory option, the Select Project screen displays automatically until all additions and/changes are associated to a project for approval.	Disable	Disable/enable   Note: The “disable_project_workflow” will work only when “defaultprojectaccess” is enabled.
Skip Project Approval workflow	All additions and/or changes to data directly goes into effect, does not require approval by a microservice manager role. The Projects option will not be visible in the header. The additions and/changes are saved to the default project. The Select Project screen will not be shown.	Enable	Enable
Optional Project Approval Workflow	All additions and/or changes to data directly goes into effect. If the data requires approval by a microservice manager role, the project approval workflow can be initiated via Projects option that is visible in the header. The additions and/changes are saved to the default project. The Select Project screen appears ONLY when you click the Projects links from where you can associate the additions and/changes to a project for approval.	Enable	Disable

Managing Project Approval Workflow

A project approval workflow defines a sequence of states and transitions through which a promotions group and/or promotions pass-through for approval. Once an editor with the editing privileges submits a project, the project goes to the approver who can approve or deny the created or edited promotion groups and/or promotions. An active and approved promotion offers will become live in the storefront.

In the workflow, you can create a new project or select an existing project to manage promotion groups and/or promotions. The project workflow is managed via a feed process and controlled by various statuses.

The possible project statuses are as follows:

Status	Definition
Open	This is the default status upon creating a project or if the project has been reopened for any corrections. At this status, the details within the project can be edited.
Submitted	This status is shown when the changes are submitted to the approver for approval.
Approved	This status is shown when the changes are approved by the approver and the promotion offer becomes live on the storefront as per the promotion period.
Approval Inprogress	This status is shown when the changes are approved by the approver and the approval feed is in progress.
Approval Failed	This status is shown when changes are approved by the approver and the approval feed is failed. Note: The Approve button will be available in the UI to approve the project again by the approver to trigger a new approval feed.
Denied	This status is shown when changes are rejected by the approver and the project cannot be opened or submitted further.

In the project workflow, you can:

• create a project
• view and/or edit the project details
• submit a project
• approve, deny, or reopen the submitted project

Creating a Project

You can create a project to manage new or update of promotion groups and/or promotions.

To create a project,

1. Click the Projects at the top right side of the Promotion console header.
   
   The Select Project pop-up opens:
   
   Note: The Select Project pop-up opens while adding or updating a promotion group or promotion.
2. Enter the project name, and then click the Create Project button.
   
   The project is created with the OPEN status:
   
   Note:
   • The project name must be unique from all other existing project names regardless of the project status.
   • To view and/or edit the project details, see Viewing and/or Editing Project Details.

Viewing, Editing Project Details

To view and/or edit project details,

1. Click on Projects at the top-right side of the Promotion console header.
   The Select Project pop-up opens:
   
2. In the Select Project pop-up, you can view:
   • the list of projects and its status; for example,
     
     Note: By default, only the projects with OPEN status are listed in the Select Project pop-up.
   • You can view all the projects by clicking View All in the Select Project pop-up.
     
     All the projects listed in the Projects page is displayed:
     
3. Click Details against your desired project name to view the project details; for example,
   
   In the project details page, you can:
   • view project details and price list details that are new or updated through this project:
     
   • edit and update the project name and project description:
     

Submitting a Project

Once you have completed creating a new promotion group and/or promotion or updating the existing promotion group and/or promotion, you can submit the project for approval. The approval can approve, deny, reopen the project.

To submit a project,

1. Click on Projects at the top-right side of the Promotion console header:
   
   The Select Project pop-up opens:
   
2. Click Details against your desired project name:
   
   The project details page opens.
   
   Note: Alternatively, you can click View All in the Select Project pop-up window, and then click Details against your desired project name.
3. In the project details page, click the Edit icon.
   
4. Click the Submit button to submit the project.
   
   The project status is changed to SUBMITTED automatically.

Approve, Deny, Reopen a Project by Promotion Admin

The project(s), which are in the submitted status can be reviewed and approved, rejected, or reopened only by the Promotion Admin as part of the project approval workflow.

1. To approve, deny, or reopen a project,
2. Log in to the Foundation service for your business (URL provided by Infosys Equinox). See Accessing the Promotions Console.
3. Click on Projects at the top-right side of the Promotion console header:
   
   The Select Project pop-up opens:
   
4. Click Details against your desired project name:
   
   The project details page opens.
   
   Note: Alternatively, you can click View All in the Select Project pop-up window, and then click Details against your desired project name.
5. In the project details page, click the Edit icon.
   
6. Perform any one of the following actions:
   The below table describes the actions to be performed:

   Click	To
   	approve the submitted promotion groups and/or promotions via the project.
   	reject the submitted promotion groups and/or promotions via the project.
   	reopen the project for further corrections.

   Note: Once the project is approved or denied, the project cannot be edited further.

Promotions | top 

Revision History
2024-01-02 | AN – Updated for Release 8.16.0.
2023-10-14 | JP, AN – Updated for Release 8.15.0.
2023-07-31 | JP – Addressed a few gaps in Promotions List and updated for Release 8.15.0.
2022-12-20 | SW – Updated the document for Release 8.13.0.
2022-04-10 | JP – Fixed link and http issues.
2021-12-30 | HM – Updated the document for Release 8.11.0.
2020-07-20 | SW – Updated the document for Release 8.9.0.
2020-05-25 | JP – Updated the document for Release 8.8.0.
2020-04-16 | JP – Revamped the document.
2019-09-25 | JP – Content updated for September 2019 release.
2019-07-28 | PLK – Minor copyedits.
2019-07-22 | JP – Content updated for July 2019 release.
2019-05-22 | AM – Minor copyedit.
2019-05-08 | AM – Inserted images and updated links.
2019-05-04 | PLK – Content updated for April 2019 release.
2019-01-24 | PLK – Content uploaded. TOC and links.