Mk bogo

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.
+
+<Info>
+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**.
+</Info>
+
+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.
+
+<Steps>
+  <Step title="Create campaign">
+    Start a **Discount Coupon** campaign.
+  </Step>
+
+  <Step title="Configure Buy condition">
+    In the **Discount value** step, choose:
+
+    **Bundles > Buy X, get Y for free**
+
+    Select **Kenya – Espresso (250g)** and set the minimum quantity to **1**.
+  </Step>
+
+  <Step title="Configure free reward">
+    In **Discount effect**, choose:
+
+    **Free products: Always add new units items**
+
+    Select **Kenya – Espresso (250g)** again and set the unit quantity to **1**.
+  </Step>
+
+  <Step title="Save campaign">
+    Save the campaign.
+
+    When the code is applied, Voucherify adds the second product at **$0**.
+  </Step>
+</Steps>
+
+## 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.
+
+<Steps>
+  <Step title="Create campaign">
+    Start a **Discount Coupon** campaign.
+  </Step>
+
+  <Step title="Configure bundle condition">
+    In the **Discount value** step, choose:
+
+    **Bundles > Buy X, get Y for free**
+
+    Select **Arabica (250g)** and set the minimum quantity to **2**.
+  </Step>
+
+  <Step title="Configure free unit">
+    In **Discount effect**, choose:
+
+    **Free products: Always add new units items**
+
+    Select **Arabica (250g)** and set the unit quantity to **1**.
+  </Step>
+
+  <Step title="Save campaign">
+    Save the campaign.
+
+    Voucherify adds 1 free unit when the customer buys at least 2.
+  </Step>
+</Steps>
+
+## 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
+
+<Steps>
+  <Step title="Create campaign">
+    Start a **Discount Coupon** campaign.
+  </Step>
+
+  <Step title="Configure required collection">
+    In the **Discount value** step, choose:
+
+    **Bundles > Buy X, get Y for free**
+
+    Select **All coffees** and set the minimum quantity to **1**.
+  </Step>
+
+  <Step title="Configure gift reward">
+    In **Discount effect**, choose:
+
+    **Free products: Always add new units items**
+
+    Select **Kenya – Espresso (250g)** and set the unit quantity to **1**.
+  </Step>
+
+  <Step title="Save campaign">
+    Save the campaign.
+
+    Voucherify adds the free product when the required condition is met.
+  </Step>
+</Steps>
+
+## 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**
+
+<Steps>
+  <Step title="Create campaign">
+    Start a **Discount Coupon** campaign.
+  </Step>
+
+  <Step title="Configure required condition">
+    In the **Discount value** step, choose:
+
+    **Bundles > Discount percentage off bundle items**
+
+    Select **All coffees** and set the minimum quantity to **1**.
+  </Step>
+
+  <Step title="Configure 100% discount">
+    Choose:
+
+    **Percent discount: Apply the discount to item subtotal**
+
+    Set the discount to **100%**.
+  </Step>
+
+  <Step title="Configure discount cap">
+    Set the **Maximum discount amount** to **$100**.
+
+    Select **Roast Master – coffee machine** as the discounted product.
+  </Step>
+
+  <Step title="Save campaign">
+    Save the campaign.
+
+    Voucherify applies the discount up to the defined maximum amount.
+  </Step>
+</Steps>
+
+<Tip>
+Keep BOGO offers simple. Clearly define what the customer must buy and what they receive.
+</Tip>
+
+## Related features
+
+<AccordionGroup>
+
+<Accordion title="Validation rules">
+
+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).
+
+</Accordion>
+
+<Accordion title="Customer segments">
+
+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).
+
+</Accordion>
+
+</AccordionGroup>

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"
                 ]
               },
               {