Working with Buy X Get Y discounts

Buy X Get Y discounts in the Kentico E-commerce Solution are a cross-selling tool which allows you to increase sales of chosen products. The Buy X Get Y discounts application facilitates a number of shopping scenarios, such as:

• buy some of specified products, get the cheapest product for free, e.g., buy 3 pieces of clothes, get the cheapest one for free, or
• buy some of specified products, get a specific other product for free or with a discount, e.g. buy a computer, get Steve Jobs (E-book) for free, or buy Adidas Zebra Crew T-Shirt, get one more with a 50% discount.

To set up a basic Buy X Get Y discount:

1. Open the Buy X Get Y discounts application.
2. Click New Buy X Get Y discount.
3. Type a Name for the discount.
4. Specify “Buy” conditions. Buy conditions indicate the products that customers need to add to their shopping cart to be eligible to get products for free or with a discount.
   • Buy any– select one of the following options:
     • products – for individual products
     • products in sections – for entire sections of the product tree structure
     • products in departments – for entire departments
     • products with brands – for products with assigned brands
     • products in collections – for products assigned to collections
   • Products / Sections / Departments / Brands / Collections – depending on your choice in Buy any, select a list of either products, sections, departments, brands or collections.
   • Minimum unit quantity – specify how many product units customers need to add to their shopping cart to be eligible for the discount.
5. Specify “Get” conditions. Get conditions define what products customers get for free or with a discount.
   • Get – select cheapest unit for discounted amount to automatically apply the discount to the cheapest product from the set specified in “Buy” conditions; select specific product for discounted amount to define a product that will be added to the customer’s order as a gift.
   • Specific product – appears if you selected specific product for discounted amount in Get.
   • Discount – select percentage to apply the discount as a percentage or fixed amount to apply the discount in a specific amount of money in the main currency.
   • Amount – specify an exact value of the discount either as a percentage or fixed amount according to Discount.
6. Click Save.

You have now created a Buy X Get Y discount. Whenever a customer fulfills the “Buy” conditions, they get the discount which you specified in the “Get” conditions. You can find the newly added discount with the lowest priority at the end of the Buy X Get Y discount list. To create more complex Buy X Get Y discount, see all parameters below.

Buy X Get Y discounts shopping examples

Example 1 – buy one item, get another one free (in other words, buy two items for the price of one): A customer adds two pairs of jeans to their shopping cart. The system automatically applies a 100% discount on one of the items. If a customer adds only one pair of jeans to their shopping cart, another pair is not added automatically.

Example 2 – buy multiple items, get the cheapest one free: A customer adds multiple different books to the shopping cart. The system evaluates which item has the lowest price (before applying other discounts) and applies a 100% discount on that item. The discount can also be less than 100%.

Example 3 – buy one item, get a gift: A customer adds a tennis racket to their shopping cart. The system automatically adds a pack of tennis balls (with a 100% discount) to the shopping cart. If the customer adds the balls first and then the racket, the system applies a 100% discount on the set of balls.

Changing Buy X Get Y discount priority

Buy X Get Y discounts are applied based on their priority. The discount priority is determined by the order of items in the discount listing. The higher the discount is, the higher its priority.

Priorities can be changed using drag-and-drop functionality. To change the priorities of your discounts:

1. Open the Buy X Get Y discounts application.

   • The discounts are ordered according to their current priority.

2. Drag a discount using the Move () area to a different position in the listing.
   

   If you cannot use drag-and-drop, expand the Other actions menu by clicking the Other actions button (…) and then click either Move up or Move down to change the discount’s priority.

3. (Optional) Edit () individual discounts and change the Apply lower priority discounts fieldas necessary. If cleared, no other Buy X Get Y discounts are applied to the shopping cart.

Buy X Get Y discounts are now applied based on the new order.

Example – Buy X Get Y discount priority

The following example sets a 10% discount on any book and an additional 5% discount to every bought Steve Jobs (E-book) product.

1. Create a new discount for any book.

   • Name: Buy a book, get 10% off
   • Buy any: products in departments
   • Departments: Books
   • Amount: 10%

2. Create a new discount for the Steve Jobs (E-book) product.

   • Name: Buy Steve Jobs, get 15% off
   • Products: Steve Jobs (E-book)
   • Amount: 15%
     • That is 10% for any book and the additional 5% discount for Steve Jobs (E-book).

3. Drag the Steve Jobs (E-book) discount using the Move () area above the Buy a book, get 10% off discount in the listing.

Now when a customer adds a book to the shopping cart, the discount for all books applies. If the Steve Jobs (E-book) product is added to the shopping cart, the discount just for the book about Steve Jobs applies.

Displaying Buy X Get Y discount data to customers

To display information about applied Buy X Get Y discounts on your store’s checkout pages, you need to correctly format the data of the items in the current shopping cart.

When using the Shopping cart content web part, display Buy X Get Y discount data within the transformation applied to the shopping cart items. You can either call the GetMultiBuyDiscountNames transformation method or work with the DiscountSummary property of the transformed shopping cart items. For detailed information, see Displaying shopping cart details on pages.

Invoices and emails

In invoices and e-commerce notification templates, you can display Buy X Get Y discount data in the transformation applied to the ContentTable items (i.e. the product items in the related order).

To show customers the price reduction granted by Buy X Get Y discounts for each item, display the TotalDiscount value of the transformed order item. The property contains the sum of the discount values for all Buy X Get Y discounts and product coupons applied to the given order item.

<tr>
    <td>{% HTMLEncode(Localize(SKUName)) %} {% HTMLEncode(SKUNumber) %}</td>
    <td>{% Units %}</td>
    <td>{% HTMLEncode(UnitPrice.Format(Currency.CurrencyFormatString)) %}</td>
    <td>{% HTMLEncode(TotalDiscount.Format(Currency.CurrencyFormatString)) %}</td>
    <td>{% HTMLEncode(TotalPrice.Format(Currency.CurrencyFormatString)) %}</td>
</tr>

If you wish to include detailed information about the applied Buy X Get Y discounts, you need to process the data available in the DiscountSummary property of order items. DiscountSummary is a collection of all Buy X Get Y discounts and product coupons that were applied to the given order item. Each record in the collection holds the following properties:

• Name – the name of the discount as specified in the Buy X Get Y discounts application.
• Value – the total amount saved after applying the discount to the given order item (for all product units).

To format the DiscountSummary, either iterate through the collection and manually generate the output, or call the ApplyTransformation macro method and define a Text / XML type transformation for the summary items.

{%
  result = "";
  if (DiscountSummary.Any()) {
    result += "<ul>";
    foreach (item in DiscountSummary) {
      result += "<li>" + HTMLEncode(Localize(item.Name)) + " (" + HTMLEncode(item.Value.Format(Currency.CurrencyFormatString)) + ")</li>"
    };
    result += "</ul>";
  }
  return result;
%}

Reference

Buy X Get Y discount API

Buy X Get Y discounts are called MultiBuyDiscounts in the API. The basic API consists of the following classes:

• MultiBuyDiscountInfo – each object represents a Buy X Get Y discount (or product coupon).
• MultiBuyDiscountInfoProvider – provides management functionality for Buy X Get Y discounts (and product coupons).

The system applies Buy X Get Y discounts on the level of individual items in the shopping cart (each item can contain multiple units of the same product). In the API and macros, you can access related values using the following:

• ShoppingCartInfo.CartItems (ShoppingCartItems in macros) – a collection of all ShoppingCartItemInfo objects within a given shopping cart object.
• ShoppingCartItemInfo.TotalDiscount –decimal value containing the sum of all price reductions granted by Buy X Get Y discounts and product coupons applied to the given shopping cart item.
• ShoppingCartItemInfo.DiscountSummary – a collection of SummaryItem objects applied to the given shopping cart item. The collection contains both Buy X Get Y discounts and product coupons that apply to the shopping cart item.
• SummaryItem – a simplified data view used to summarize applied discounts. Contains only the Name and Value of the discount.