Item Groups
An Item Group is a collection of items used to define which items members must purchase to qualify for an offer and which items they can receive as rewards. It is required for all item-based offers. While an item is typically a product, it can also be a service or discount. Items in an Item Group are identified by either their name (Item Label) or a unique code (Item ID).
Redemption Process
When a member attempts to redeem an offer (for item-based rewards), their order is checked against the Item Group. The validation process ensures that the items in the order match those listed in the Item Group, either by name or ID.
If all offer conditions are met, the associated discount is calculated and returned to the Partner Ordering Platform to be applied to the order. However, if the order doesn’t meet the required conditions, an error is triggered, preventing the offer from being redeemed.
This workflow may vary slightly depending on the integration type. For details specific to your integration, please contact your Customer Success Manager.
How it Works
When you’re creating an offer, all item based offers will require Item Group(s) to identify which items qualify for the offer:
Discount ( $ ) on an item
Discount ( % ) on an item
Free Items
BOGO
Price Adjustments
Multiply Points on every qualifying items, or on the subtotal after at least 1 qualifying item is in the basket
For specific use cases, see Example Offers & Item Groups. For instructions on creating and managing item groups, see Manage Item Groups.
Things to Know
You must have Admin or Marketing Manager permissions to manage your Item Groups.
Always follow the Item Formatting Guidelines on how to upload your items and manage your Item Groups.
If you are using an Item ID or Label which maps to multiple items in your POS system, it is possible for a member to buy any item associated with the Item ID or Label to qualify for the offer. If you want to qualify a single item, the Item ID or Label must be unique.
For item-based offers, if an item is set to not earn points at the account level (see Manage Your Item Qualifiers), it will be excluded from both regular and bonus points in Date & Time or Recurring campaigns with a multiply points offer. For instance, if a double points offer on cookies would normally earn 6 points (3 regular points and 3 bonus points), the member will earn 0 points. However, in a Purchase Item campaign, the item will not earn regular points but will still receive bonus points. In this case, the item would earn 0 regular points and 3 bonus points, totaling 3 points.
The discount calculation depends on the cost of the qualifying item(s) and other configured offer rules — such as Make Offer Lowest Value or Sum Parent Modifier Qualifying Items.
For example, if an offer gives 50% off the lowest-priced qualifying item and the member purchases a salad for $8 and a side for $4, the $4 side would receive the 50% discount.