# Consume Group in Campaigns The Akinon campaign system supports **two distinct consumption modes** when multiple campaigns are applied to basket items: 1. **Without Consume Group** (Condition Application Group) – Campaigns are allowed to combine freely, even if they consume the same basket items. 2. **With Consume Group** (Condition Application Group) – Campaigns are restricted to consume items sequentially within the same group, preventing overlapping usage of the same products. A campaign is considered *combinable* if two conditions are met: * In the **Campaign Information** tab, the **“Can be combined with other campaigns”** checkbox must be enabled.
* In the **Campaign Condition** tab, the **“Condition Application Type”** must be set to **“Campaign products can be included in other campaigns.”**
Both approaches are valid and intentional. The choice depends on the business rules and how marketers want multiple campaigns to interact in practice. To better understand these modes, let’s walk through two real-life examples. The first scenario demonstrates a simple *Buy X, Pay for Y* campaign, while the second focuses on *quantity-based percentage discounts*. ## **Example Basket 1 – Buy 3, Pay for 2** * Product A × 5 The basket contains 5 items of the same product. #### **Active Campaigns** 1. **Campaign 1**: “Buy 3, Pay for 2” *(combinable with other campaigns: checkbox enabled, condition type set to ‘Campaign products can be included in other campaigns’)* 2. **Campaign 2**: “Buy 3, Pay for 2” *(combinable with other campaigns: checkbox enabled, condition type set to ‘Campaign products can be included in other campaigns’)* Both campaigns share the same structure and are marked as combinable.
### **Mode 1 – Without Consume Group** When the **Consume Group feature is not used**, campaigns marked as *combinable* can both be applied, even if they share the same condition and discount structure. * **Campaign 1** consumes 3 of the 5 items and applies its discount. * **Campaign 2** also consumes 3 of the 5 items and applies its discount.
**Result:** Both campaigns are applied on the same set of items. This behavior is correct in this mode because the system interprets *combinable* literally — campaigns do not block each other, and all eligible ones can be triggered simultaneously. ### **Mode 2 – With Consume Group** To enable controlled consumption, the system provides **Consume Group logic**. #### **Step 1 – Enable Dynamic Setting** Activate the feature via `BASKET_OFFER_IS_CONSUME_GROUP_ENABLED` dynamic setting by selecting **Yes**.
This adds a new field, **Condition Application Group**, to the Campaign Conditions tab. #### **Step 2 – Assign to Same Group** For the **Consume** mechanism to take effect, the campaigns must first be explicitly assigned to the **same group** (e.g., `group1`) by giving the **Condition Application Group** field any unique identifier. Once campaigns are grouped under the same identifier, the evaluation process changes: * The campaigns are no longer treated as independent and parallel promotions. * Instead, they are processed **sequentially**, following the **priority values** defined for each campaign. * The campaign with the **higher priority value** is evaluated first. If it fully consumes the applicable basket conditions, subsequent campaigns in the same group may not be triggered. * If the first campaign only partially consumes the conditions, the system continues to evaluate the next campaign(s) in the group until all applicable conditions are exhausted. This ensures that **only one campaign per group can be applied at a time**, unless there is remaining eligibility after the higher-priority campaign has been evaluated.
#### **Basket Evaluation with Consume Group** **Case A – Basket with 5 Items** * **Campaign 1** consumes 3 out of 5 items and applies its discount. * Only 2 items remain, so **Campaign 2** cannot meet its condition. * **Result:** Only Campaign 1 is applied.
**Case B – Basket with 6 Items** * **Campaign 1** consumes 3 out of 6 items and applies its discount. * **Campaign 2** then finds 3 items still available and applies its discount. * **Result:** Both campaigns are applied, but only when there are enough items to satisfy both independently.
## **Example Basket 2 – Quantity-Based Percentage Discounts** While the first basket scenario highlights how consume logic affects identical promotions with the same threshold, real-world campaigns often involve **tiered benefits** — for example, different discount percentages based on different quantity thresholds. The following scenario demonstrates how consume groups work in this more layered setup. * Product A × 10 * Product B × 7\ **Total: 17 items** #### **Active Campaigns** 1. **Campaign 1**: Buy 10 or more items → Get **10% discount** *(combinable with other campaigns: checkbox enabled, condition type set to ‘Campaign products can be included in other campaigns’)* 2. **Campaign 2**: Buy 15 or more items → Get **20% discount** *(combinable with other campaigns: checkbox enabled, condition type set to ‘Campaign products can be included in other campaigns’)* ### **Mode 1 – Without Consume Group** If no consume group is defined, both campaigns are eligible to run: * Basket contains **17 items**, which satisfies both conditions. * **Campaign 1** applies 10% discount. * **Campaign 2** applies 20% discount. **Result:** Both campaigns apply on the same basket, and the customer benefits from both discounts. This is correct behavior in **without consume group** mode, since campaigns marked as *combinable* can overlap without restrictions. ### **Mode 2 – With Consume Group** To ensure that only one campaign applies at a time, while still keeping them combinable with other unrelated campaigns, both campaigns should be placed in the same consume group (e.g., `group2`). Additionally, the consume logic must be activated via `BASKET_OFFER_IS_CONSUME_GROUP_ENABLED` dynamic setting by selecting **Yes.** Without enabling this setting, campaigns in the same group will continue to work in parallel, regardless of group assignment. Also, “Priority” values are used to determine which campaign should apply first. * **Campaign 1** (10 items, 10% discount): Lower priority * **Campaign 2** (15 items, 20% discount): Higher priority #### **Basket Evaluation with Consume Group** **Case A – Basket with 17 Items** * Basket satisfies both conditions. * Since campaigns are in the same consume group, only the **higher-priority campaign** applies. * **Result:** 20% discount from Campaign 2 is applied, Campaign 1 is skipped. **Case B – Basket with 25 Items** * Basket satisfies both conditions multiple times. * **Campaign 2** applies once for 15 items (20% discount). * **Campaign 1** then finds another 10 items available and applies its 10% discount. * **Result:** Both campaigns apply, but on separate sets of items, ensuring no overlap. ## **Comparison of the Two Modes**
AspectWithout Consume GroupWith Consume Group
Campaign InteractionCampaigns can freely overlapCampaigns respect group restrictions
Item ConsumptionSame items can be reused by multiple campaignsItems are consumed sequentially and cannot be reused
Use CaseAggressive promotions, maximum stackingControlled promotions, fair distribution of discounts