Manage Item Groups

An Item Group is a list of line-items used to limit the eligible items for an offer redemption. When a member wants to redeem an offer, their order will be validated for the correct item names and quantity of items, then the correct discount is applied. When the member’s order does not have the specified line-items from the Item Group, an error occurs that prevents the offer from being redeemed.

Note: this workflow varies slightly per integration type. Contact your Customer Success Manager for more details.

In this article, you will learn how to manage and use Item Groups within your offer configurations.

Things to Know

• When opening a Downloaded CSV Report file of your Item Group from the Dashboard in Excel, it's often better to import the data rather than directly opening the file. This allows you to specify the correct encoding (UTF-8) and delimiter settings.

• Be cautious when saving CSV files from Excel, as it may change the encoding to a non-UTF-8 format. If possible, use "Save As" and explicitly choose "CSV UTF-8 (Comma delimited) (*.csv)".

Formatting Your File

Download Item Group CSV Template

Please follow these file formatting header rules before uploading your Inventory:

• Your file must be in a comma-separated value (CSV) format. We recommend saving as a UTF-8 file to preserve any special character formatting.

• Ensure your files do not include any duplicates.

• Headers should always be present. The column headers are:

  • item_name - Item name(s) is/are the minimum requirement and should always be entered as it is printed on the receipt (or as it is sent in the API integrations).

  • quantity - the value is always 1. If left blank, the value will default to 1.

  • adjusted_cost - adjusted cost is only required for a Price Adjustment offer type. Otherwise, leave blank. Learn more about Price Adjustment offer types.

Offer types Fixed Discount ($) and Fixed Discount (%) DO NOT require a qualifying item group.

When you are setting up an offer, the way to format your qualifying item groups are dependent on the offer type. Here are example Item Groups for each offer type:

Free Item

When you're setting up a Free Item offer, enter all the items that qualify as the free item. This means, if there is variability in how your item is identified across your pos systems, you’ll need to include every version from all your systems. Use the exact naming that is used. In the offer setup, set this item group as the Eligible Qualifier and Reward Items. The member will be able to redeem any one of these items as a free item.

BOGO

You're setting up a Buy One Get One (BOGO) offer, enter all the items that qualify for the BOGO offer. With this offer, set the item group as the Eligible Qualifier Items and Eligible Reward Items. If any two of these items are in their cart, the member will be able to redeem one as the free item (of equal or lesser value).

For more advanced BOGO offers, you can also define separate Item Groups for the Eligible Qualifier Items and the Eligible Reward Items. For example, Buy a sandwich, get a free chips. Where the Eligible Qualifier Items group will consist of sandwich line-items and the Eligible Rewards Items group will consist of chip line-items.

Price Adjustment

When you’re setting up a Price Adjustment offer type, enter all the items that qualify for a price adjustment and the discounted price. In the offer setup set this group as the Eligible Qualifier Items and the Eligible Reward Items. The member will be able to purchase any of the line-items at the discounted price (e.g. $5 Sub Special, usually priced at $7).

Note: the "adjusted_cost" is the cost of the item when the discount is applied (the amount of the discount will be calculated automatically).

Create an Item Group

Before you create your Item Group, identify your campaign objective and review the Formatting Item Groups Guidelines.

Navigate to Campaigns > Item Groups.
    Click the add add icon to create a new item group.
    Name your item group.
    Drag and drop or upload your CSV file containing your group of items.

IMPORTANT: Your file must follow the Formatting Item Groups Guidelines.
Click on Save to create your item group.
    

View an Item Group

There are 2 ways to view the items in group — viewing direct within the Dashboard, and downloading it as a CSV file. Downloading the item group is also helpful when you want to update a group.

1. Navigate to Campaigns / Item Groups.

2. In the row of the Item Group, go to Manage / View.

   

Delete Item(s) within a Group

An Item Group must have at least 1 item. If you want to update all the items in a list, we recommend updating your Campaign, as seen below:

1. Navigate to Campaigns / Item Groups.

2. In the row of the Item Group, go to Manage / View.

   

3. Select the checkbox next to any item(s) you want to remove.

   

4. Click the Delete :delete: icon.

5. Confirm your deletion of selection item(s).

Download Item Group CSV File

1. Navigate to Campaigns / Item Groups.

2. In the row of the Item Group, go to Manage / View.

   

3. Click the Download :download: icon. The file will directly download to your device.

Edit an Item

1. Navigate to Campaigns / Item Groups.

2. In the row of the Item Group, go to Manage / View.

   

3. Click on the pencil icon next to the Item Name, Quantity or Price Adjustment to edit the entry.
   Note: you can only edit one value at a time.

   

4. Enter your updated Item Name, Quantity or Price Adjustment value and click the check mark icon to save. Click the x icon to discard your changes.

   

Upload/Overwrite an Item Group

Upload your Item Group will overwrite all its contents. This is recommended for any modifications — such as an add, remove, and/or edit item(s).

1. Navigate to Campaigns / Item Groups.

2. In the row of the Item Group, go to Manage / View.

   

3. Click the Upload :upload: icon.

4. Upload your formatted CSV file containing the your item settings and Save Changes.