Реализация акции «Купи X — получи 1 бесплатно» в Shopify

1. Контекст

• Платформа: Shopify

• Корзина: Monster Cart Upsell + Free Gifts (основная корзина сайта)

• Бандлы и volume-скидки: WideBundle

• Тема: кастомная (используется своя кнопка Add to Cart)

2. Цель

Реализовать акцию Buy X Get 1 Free (например, купи 3 упаковки и получи 1 бесплатно) с автоматическим добавлением подарка в корзину, при этом:

• акция не ломает и не обходит систему бандл-скидок WideBundle;

• корректно работает с Monster Cart;

• поддерживает несколько акций одновременно.

3. Базовые требования

1. Возможность настраивать:

   
   

   • количество X (2 / 3 / 4 и т.д.);

   • товары-участники (SKU / коллекция / теги);

   • подарок (тот же или другой товар).

2. Подарок:

   
   

   • добавляется автоматически при выполнении условия;

   • имеет цену $0;

   • удаляется автоматически, если условие больше не выполняется.

3. Если в корзине выполнены условия нескольких акций, добавляются все соответствующие подарки.

4. Подарок:

   
   

   • не участвует в расчёте скидок WideBundle;

   • не влияет на tier бандла;

   • не увеличивает размер скидки.

4. Критичные ограничения

• WideBundle уже используется для:

  • bundle-скидок,

  • volume-discount логики.

• Акция 3+1 НЕ ДОЛЖНА ломать:

  • расчёт бандл-скидок,

  • логику WideBundle.

• Приоритет логики:

  
  

  1. Сначала считается скидка WideBundle

  2. Затем добавляется бесплатный подарок

5. WideBundle — важный нюанс

• В WideBundle есть нативная функция добавления подарка.

• Она срабатывает только при клике на кнопку их виджета Add to Cart.

• Сейчас используется кастомная кнопка, поэтому подарок не добавляется.

6. Предпочтительный путь реализации

Приоритет №1 (желательно):

• Использовать нативную логику WideBundle.

• Реализовать так, чтобы:

  
  

  • визуально кнопка была нашего дизайна;

  • технически она триггерила Add to Cart WideBundle

    (через JS / прокси-клик / подмену кнопки / API WideBundle).

Приоритет №2:

• Стороннее приложение для auto-gift,

• при условии отсутствия конфликтов с WideBundle и Monster Cart.

Приоритет №3:

• Кастомная cart-логика (только если первые варианты невозможны).

7. Требования к результату

• Подарок:

  • корректно отображается в Monster Cart;

  • сохраняется на Checkout;

  • остаётся бесплатным.

• Работает на desktop и mobile.

• Нет дублирования подарков и “зацикливания”.

8. Обязательные сценарии тестирования

1. Купили X товаров → подарок добавился автоматически.

2. Уменьшили количество ниже X → подарок удалился.

3. Две разные акции одновременно → добавлены оба подарка.

4. WideBundle-скидка считается корректно до и после добавления подарка.

5. Подарок не влияет на скидочные tiers.

6. Обновление страницы / переходы не ломают логику.

9. Deliverables

• Реализованная логика акции.

• Обоснование выбранного способа (WideBundle / app / кастом).

• Краткая инструкция: как менять X, товары и подарок.

10. Ключевая формулировка (must)

Акция «Купи X — получи 1 бесплатно» должна полностью сохранять логику WideBundle и Monster Cart. Подарок добавляется поверх существующих скидок и не участвует в их расчёте.