diff --git a/documentation/build/bogo-scenarios.mdx b/documentation/build/bogo-scenarios.mdx new file mode 100644 index 000000000..b7da6a04d --- /dev/null +++ b/documentation/build/bogo-scenarios.mdx @@ -0,0 +1,194 @@ +--- +title: "Create BOGO scenarios" +description: "Step-by-step guide to setting up Buy One Get One (BOGO) campaigns in Voucherify" +keywords: ['BOGO', 'buy one get one', 'bundles tutorial', 'cart promotions'] +--- + +BOGO (Buy One Get One) campaigns reward customers when they buy specific products or product groups. + +In Voucherify, BOGO offers are configured using the **Bundles** discount category. + + +This guide uses products and collections available in a fresh Voucherify Sandbox environment. + +Examples are based on default demo shop data, including collections such as **All Products** and **All coffees**, and products such as **Kenya – Espresso (250g)**, **Arabica (250g)**, and **Roast Master – coffee machine**. + + +This guide focuses only on configuration steps. +To understand bundle multiplication, discount limits, and bundle behavior, see the [Product bundles](/build/product-bundles) overview. + +## Scenario 1: Buy one, get one free + +This scenario shows the simplest BOGO setup where a customer receives the same product for free. + +If a customer buys one **Kenya – Espresso (250g)**, they get a second unit for free. + + + + Start a **Discount Coupon** campaign. + + + + In the **Discount value** step, choose: + + **Bundles > Buy X, get Y for free** + + Select **Kenya – Espresso (250g)** and set the minimum quantity to **1**. + + + + In **Discount effect**, choose: + + **Free products: Always add new units items** + + Select **Kenya – Espresso (250g)** again and set the unit quantity to **1**. + + + + Save the campaign. + + When the code is applied, Voucherify adds the second product at **$0**. + + + +## Scenario 2: Buy 2, get 1 free + +This scenario extends the basic BOGO setup by increasing the required quantity. + +If a customer buys 2 items, they receive 1 extra unit for free. + + + + Start a **Discount Coupon** campaign. + + + + In the **Discount value** step, choose: + + **Bundles > Buy X, get Y for free** + + Select **Arabica (250g)** and set the minimum quantity to **2**. + + + + In **Discount effect**, choose: + + **Free products: Always add new units items** + + Select **Arabica (250g)** and set the unit quantity to **1**. + + + + Save the campaign. + + Voucherify adds 1 free unit when the customer buys at least 2. + + + +## Scenario 3: Buy from one collection, get a free gift + +This scenario shows how to separate required products from the reward by using collections. + +Example: + +- Buy any product from **All coffees** +- Get **Kenya – Espresso (250g)** for free + + + + Start a **Discount Coupon** campaign. + + + + In the **Discount value** step, choose: + + **Bundles > Buy X, get Y for free** + + Select **All coffees** and set the minimum quantity to **1**. + + + + In **Discount effect**, choose: + + **Free products: Always add new units items** + + Select **Kenya – Espresso (250g)** and set the unit quantity to **1**. + + + + Save the campaign. + + Voucherify adds the free product when the required condition is met. + + + +## Scenario 4: BOGO with a value limit (Free items up to $100) + +This scenario shows how to replace free items with a capped discount. + +Example: + +- Buy at least one item from **All coffees** +- Get **Roast Master – coffee machine** discounted up to **$100** + + + + Start a **Discount Coupon** campaign. + + + + In the **Discount value** step, choose: + + **Bundles > Discount percentage off bundle items** + + Select **All coffees** and set the minimum quantity to **1**. + + + + Choose: + + **Percent discount: Apply the discount to item subtotal** + + Set the discount to **100%**. + + + + Set the **Maximum discount amount** to **$100**. + + Select **Roast Master – coffee machine** as the discounted product. + + + + Save the campaign. + + Voucherify applies the discount up to the defined maximum amount. + + + + +Keep BOGO offers simple. Clearly define what the customer must buy and what they receive. + + +## Related features + + + + + +Use validation rules to control who can redeem the campaign and in what circumstances. For example, you can limit a BOGO campaign to selected customer segments, sales channels, order value, or cart conditions. + +Validation rules complement bundle configuration, bundles define **what must be in the cart**, while validation rules define **when the campaign is allowed**. + +See [Validation rules](/optimize/create-validation-rules). + + + + + +Target BOGO campaigns to specific audiences, such as new customers or loyalty members, by combining bundle logic with segmentation. + +See [Customer segments](/prepare/customer-segments). + + + + \ No newline at end of file diff --git a/documentation/docs.json b/documentation/docs.json index 32d0950ba..539c677ab 100644 --- a/documentation/docs.json +++ b/documentation/docs.json @@ -207,7 +207,8 @@ "build/create-discount-promotions", "build/discount-types-and-effects", "build/discount-code-import", - "build/product-bundles" + "build/product-bundles", + "build/bogo-scenarios" ] }, {