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