Implementation of the promotion "Buy X - Get 1 Free" in Shopify

1. Kontekst

• Platforma: Shopify

• Koszyk: Monster Cart Upsell + Free Gifts (główny koszyk strony)

• Bundle i zniżki wolumenowe: WideBundle

• Motyw: niestandardowy (używana własna przycisk Dodaj do koszyka)

2. Cel

Wdrożyć promocję Kup X, otrzymaj 1 za darmo (na przykład, kup 3 opakowania i otrzymaj 1 za darmo) z automatycznym dodawaniem prezentu do koszyka, przy tym:

• promocja nie łamie i nie omija systemu zniżek bundle WideBundle;

• poprawnie działa z Monster Cart;

• wspiera wiele promocji jednocześnie.

3. Podstawowe wymagania

1. Możliwość konfigurowania:

   
   

   • liczba X (2 / 3 / 4 itd.);

   • produkty biorące udział (SKU / kolekcja / tagi);

   • prezent (ten sam lub inny produkt).

2. Prezent:

   
   

   • dodawany automatycznie po spełnieniu warunku;

   • ma cenę $0;

   • usuwany automatycznie, jeśli warunek nie jest już spełniony.

3. Jeśli w koszyku spełnione są warunki wielu promocji, dodawane są wszystkie odpowiednie prezenty.

4. Prezent:

   
   

   • nie bierze udziału w obliczaniu zniżek WideBundle;

   • nie wpływa na poziom bundle;

   • nie zwiększa wysokości zniżki.

4. Krytyczne ograniczenia

• WideBundle jest już używane do:

  • zniżek bundle,

  • logiki zniżek wolumenowych.

• Promocja 3+1 NIE MOŻE łamać:

  • obliczeń zniżek bundle,

  • logiki WideBundle.

• Priorytet logiki:

  
  

  1. Najpierw obliczana jest zniżka WideBundle

  2. Następnie dodawany jest darmowy prezent

5. WideBundle — ważny niuans

• W WideBundle istnieje natywna funkcja dodawania prezentu.

• Aktywuje się tylko po kliknięciu przycisku ich widgetu Dodaj do koszyka.

• Obecnie używana jest niestandardowa przycisk, dlatego prezent nie jest dodawany.

6. Preferowany sposób realizacji

Priorytet nr 1 (pożądany):

• Użyć natywnej logiki WideBundle.

• Wdrożyć tak, aby:

  
  

  • wizualnie przycisk był naszego projektu;

  • technicznie wyzwalał Dodaj do koszyka WideBundle

    (poprzez JS / proxy-click / zamianę przycisku / API WideBundle).

Priorytet nr 2:

• Zewnętrzna aplikacja do auto-gift,

• pod warunkiem braku konfliktów z WideBundle i Monster Cart.

Priorytet nr 3:

• Logika koszyka na zamówienie (tylko jeśli pierwsze opcje są niemożliwe).

7. Wymagania dotyczące wyniku

• Prezent:

  • poprawnie wyświetla się w Monster Cart;

  • zachowuje się na Checkout;

  • pozostaje darmowy.

• Działa na desktopie i mobile.

• Brak duplikacji prezentów i “zapętleń”.

8. Obowiązkowe scenariusze testowania

1. Kupiono X produktów → prezent dodany automatycznie.

2. Zmniejszono liczbę poniżej X → prezent usunięty.

3. Dwie różne promocje jednocześnie → dodane oba prezenty.

4. Zniżka WideBundle obliczana poprawnie przed i po dodaniu prezentu.

5. Prezent nie wpływa na poziomy zniżek.

6. Odświeżenie strony / przejścia nie łamią logiki.

9. Wyniki

• Wdrożona logika promocji.

• Uzasadnienie wybranego sposobu (WideBundle / aplikacja / niestandardowe).

• Krótka instrukcja: jak zmieniać X, produkty i prezent.

10. Kluczowe sformułowanie (must)

Promocja „Kup X — otrzymaj 1 za darmo” musi w pełni zachować logikę WideBundle i Monster Cart. Prezent dodawany jest ponad istniejące zniżki i nie bierze udziału w ich obliczeniach.