- Menu
- Sitemap
Introduction
This concept provides an overview of how to configure promotion inclusion/exclusion groups and explains some implementation aspects.
In general, a promotion can be applied to orders, to shipping costs, or to a single product. The inclusion/exclusion feature applies to the product item level.
However, there may exist some products which should not be discounted at all. Therefore, an inclusion/exclusion feature has been implemented to define
- groups of products which can be discounted and
- groups of products which cannot be discounted.
The granularity varies from selecting categories to picking up single products. Selecting a category means that all products belonging to this category, and those belonging to any child category, will be considered.
Inclusion/Exclusion Lists
Application Level Exclusion
There may exist products which cannot be discounted at all. It is inconvenient to define the set of excluded products for each promotion. Therefore, it is possible to define one product exclusion group which is valid for all promotions of an application.
Another way is to define a set of excluded categories. This is the more convenient way to exclude all products of a category instead of adding them to the exclusion list individually.
Setting up application level exclusion groups can be done at <channel> | Applications | <application> on the Promotions tab under Application Level Exclusions.
Note
Application level exclusion groups are valid for all promotions of an application that belongs to a consumer channel.
Promotion Level Inclusion/Exclusion
Product inclusion/exclusion groups of a promotion can be defined for conditions, as well as for actions:
- An item inclusion/exclusion condition requires at least one included product.
- A product exclusion condition can prevent a promotion to be applied even if an included product is in the shopping cart.
Assume you have an included product in your cart. Then add an excluded product - the promotion no longer applies to the cart! If you want to grant a discount on some items (all items of a category except one brand), you can implement this using product actions, see below.
- Product inclusion action: discount is granted on each product in the cart which belongs to the group of products selected for inclusion.
- Product exclusion action: discount is NOT granted on any product in the cart which belongs to the group of products selected for exclusion.
The promotion discount may be based on the order, an item, the shipping costs or a free gift. Each of these promotion discount types can be configured to trigger a specific promotion action, e.g., an item percentage off discount.
- Order
- Order Percentage Off
- Order Value Off
- Item
- Item Percentage Off
- Item Target Price
- Item Value Off
- Shipping
- Shipping Percentage Off
- Shipping Target Price
- Shipping Value Off
- Free Gift
- Automatic Gift
- Hidden Gift
Note
If a product is in an inclusion set at promotion level, but also in the application level exclusion set, it will not be considered! To overrule this regulation, the flag Override Application Level Exclusions must be enabled. In general, exclusions win over inclusions.
Note
Per default, application level exclusions are stronger than promotion level definitions. However, each promotion can be configured to overrule the setting.
Implementation
This subsection does not cover all implementation done in detail, but it explains some interesting aspects.
A promotion can have more than one rule. Internally, this is represented by an instance of Rebate. Each rule consists of one or more conditions and one action. Currently, only one action can be configured, but the framework itself allows more than one action.
As mentioned before, each condition and action can have groups of included or excluded products, or categories respectively. Internally, inclusion/exclusion groups are represented by an instance of RebateFilterGroup. It can be one of two types:
- PRODUCT: filter group which refers to products
- CATEGORY: filter group which refers to categories
The scope is one of this.
- NONE: fall back
- ACTION: filter group belonging to promotion actions
- CONDITION: filter group for promotion condition
- APPLICATION: application level filter group
All business logic to access filter groups, to assign them to/unassign them from conditions/actions are provided by RebateFilterGroupRepository.
The items assigned to a rule filter group are referenced by RebateFilterObjectAssignment. It maps the item's id (product or category uuid) to the rule filter group id.
The RebateFilterGroupAssignment references a rule filter group to a condition or action.
Application Level Exclusions
The application level exclusion is represented by an instance of RebateFilterGroup with scope APPLICATION. If there are neither product nor category exclusions defined, no RebateFilterGroup will exist. If all products or categories are removed from an existing application exclusion group, the instance of RebateFilterGroup will be removed as well.
The RebateFilterGroupRepository provides methods to handle application-wide inclusion/exclusion groups.
Including the Wizard
Enfinity Suite/Intershop offers wizards to select products and categories. These wizards are used for assigning products or categories to inclusion/exclusion groups.
The pipeline ViewPromotionRebateInclusionsExclusions provides call and callback nodes for the product and category wizards at promotion level, and the pipeline ViewApplicationPromotionPreferenceInclusionsExclusions likewise at store level.
There are some important parameters which must be passed to the wizard for proper working.
ParameterName | Description |
|---|---|
PipelineComponentName | Name of the component, not important. |
PipelineComponentCaller | Who calls the component. You can use it e.g. in component templates to place special text. |
PipelineComponentStartPipeline | The start pipeline of the component. |
PipelineComponentReturnPipeline | The callback pipeline of your application. |
PipelineComponentReturnValueName | The callback pipeline of your application will expect the returnValue with this dictionaryKey. |
PipelineComponentCancelPipeline | The callback-pipeline in case of "cancel" button is used (optional). |
PipelineComponentBackToPipeline | A pipeline within your application in case of "back" button at component. |
In addition, all parameters passed to and through the wizard must be stored in a map named PipelineComponentParameters. This map is kept in the session and passed back when returning to the caller pipeline.
Furthermore, each wizard requires some individual parameters:
Name | Description | Starting Pipeline | Parameters |
|---|---|---|---|
ProductSelectWizard | select one or more products | ViewProductSelectWizard-Search | ProductSelectionFinishButton- text of button, if should differ from "Finish" |
CategorySelectWizard | select one or more categories | ViewCategorySelectWizard-PrepareCatalogAssignment | AlreadySelectedCategoryUUIDMap- map of uuid->uuid, lines are marked selected/grey |
CategorySearchWizard | select one or more categories | ViewCategorySearchWizard-Search | AlreadySelectedCategoryUUIDs uuid iterator of categories, which already have been selected before |
Assigning Objects
The central processing of assigning/unassigning items to and from a rule filter group is done in ProcessPromotionRebateInclusionsExclusions-AssignOrUnassignAllObjects. Depending on the number of returned elements the assignment/unassignment of products/categories to/from the rule filter group may be performed in a batch job.
The threshold is configured in
# Threshold to perform the product and category assignment to a promotion's rebate filter group in a batch job. intershop.cartridges.bc_marketing.promotion.assignment.threshold = 1000
The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.