Offer engine V2

---

Overview

Offer Engine V2 is the next generation of Offer Engine V1, designed to make creating promotions, volume discounts, and BOGO offers significantly more flexible and powerful.

While Offer Engine V1 supported:

• Percentage discounts

• Fixed amount discounts

• Volume tier pricing

• Free Gift With Purchase offers

• Product and Collection page widgets

it was limited to a single offer list per store.

Offer Engine V2 introduces:

• Multiple BOGO offer types

• Advanced volume discounts

• Automatic gift management

• Customer-selectable gifts

• Multiple quantity breakpoints

• Improved product page widgets

• Automatic cart synchronization

• Fully customizable offer appearance

---

Getting Started

Step 1: Create an Offer

Navigate to:

Offer Engine V2 → Create Offer

After creating an offer, you will see two theme extensions:

Core Embed

Handles all offer logic and cart updates.

To enable:

1. Open Shopify Theme Editor

2. Go to App Embeds

3. Enable Dollarlabs Core

This is required for automatic cart calculations and gift management.

Offer Bar Block

Displays offers directly on product pages.

To enable:

1. Open a Product Template in the Theme Editor

2. Add the Offer Bar block

3. Save the theme

---

Configuring an Offer

Basic Information

Internal Title

Used only inside the app for identification.

Example:

Holiday Sale

Discount Title

Customer-facing title displayed in widgets.

Example:

Holiday Sale

---

Scope

Choose where the offer applies.

Supported scopes include:

• Products

• Variants

• Collections

Exclusions

Even when targeting an entire collection, you can exclude specific products.

Example:

Collection: Hydrogen
Exclude: Product A

---

Placements

Choose where the offer appears.

Currently Supported

• Product Page

Coming Soon

• Cart Page

• Collection Page

---

Display Conditions

Control when customers see the offer.

Examples:

Customer Targeting

Show offers only to:

• Logged-in customers

• Specific customer segments

URL Targeting

Display offers only on specific URLs or campaigns.

Example:

Only show on:
?campaign=summer-sale

---

Offer Types

Offer Engine V2 supports two primary offer categories:

1. BOGO Offers

2. Quantity Breaks

---

BOGO Offers

1. Buy X, Get Same Item Free

The customer receives the same product for free.

Example

Buy 1 → Get 1 Free

Purchased	Free
1	1
2	2
3	3

The free quantity automatically scales with the purchased quantity.

Custom Buy/Get Ratios

You can modify both quantities.

Example:

Buy 3
Get 1 Free

Purchased	Free
3	1
6	2
9	3

---

2. Buy From Scope, Get Specific Gift

Customers purchase products from the configured scope and automatically receive a predefined gift.

Example

Offer Scope:

Hydrogen Collection

Rule:

Buy 3 products
Get Free Water Bottle

When the customer purchases 3 eligible products, the specified gift is automatically added to the cart.

---

3. Choose Gift

Customers earn a gift but can choose which gift they want.

Example

Rule:

Buy 3 products
Choose 1 free gift

Available Gifts:

• Water Bottle

• Tote Bag

• Notebook

The customer selects their preferred gift directly from the offer widget.

---

4. Buy X, Get Gift List

Customers receive multiple predefined gifts automatically.

Example

Rule:

Buy 12 products
Receive:
- Gift A
- Gift B

Both gifts are automatically added to the cart.

---

Quantity Breaks

Quantity Breaks allow merchants to offer discounted pricing when customers purchase larger quantities.

Example

Quantity	Price
1-9	Regular Price
10-49	Discounted Price
50+	Best Price

Multiple breakpoints can be configured within a single offer.

---

Automatic Cart Scaling

One of the biggest improvements in Offer Engine V2 is automatic cart synchronization.

Whenever a customer changes quantities in the cart:

• Gift quantities update automatically

• BOGO quantities recalculate automatically

• Volume discounts remain accurate

No manual adjustments are required.

---

Example: Buy 1 Get 1 Free

Customer Cart:

Product Quantity = 2

Result:

Free Quantity = 2

Increase quantity:

Product Quantity = 5

Result:

Free Quantity = 5

---

Example: Buy 12 Get Gift List

Rule:

Buy 12
Receive:
- Gift A
- Gift B

Cart Quantity:

24 Products

Result:

Gift A = 2
Gift B = 2

Because the offer has been qualified twice.

---

Example: Buy 3 Get Specific Gift

Rule:

Buy 3
Get Free Water Bottle

Cart Quantity:

6 Products

Result:

2 Free Water Bottles

Offer rewards automatically scale based on qualifying quantities.

---

Customizing the Offer Widget

Offer Engine V2 includes extensive customization options.

Content

Customize all customer-facing text.

Examples:

• Offer titles

• Button labels

• Gift selection messages

• Quantity break descriptions

A live preview updates as changes are made.

---

Appearance

Match the widget to your store branding.

Customize:

• Primary colors

• Background colors

• Text colors

• Borders

---

Advanced Styling

Add custom CSS for complete control over widget styling.

Example use cases:

• Custom spacing

• Typography adjustments

• Unique layouts

• Brand-specific styling

---

Need Help?

If you need assistance configuring an offer or have a use case that isn't currently supported, feel free to reach out to the Dollarlabs team. We're happy to help you get the most out of Offer Engine V2.