Zum Inhalt springen
Script-Beispiele

Migrating a BOGO that ran across the whole cart

How most agency-written BOGOs worked: pool every eligible unit, sort it, then peel off the discounted ones. Sort ascending and the cheapest units are free. Sort descending and they are not. The class names differ by one word.

Nachgebaut
Was das Script gemacht hat

It pooled every eligible unit in the cart, sorted them by price, and discounted a share of them.

Händler haben das auf 2 verschiedene Arten geschrieben, und sie bedeuten nicht alle dasselbe. Jede Schreibweise steht unten mit eigenem Warenkorb und eigenen Zahlen.

Im eigenen Shop ausprobieren

Fügen Sie es in die Scripts-Rettung ein und sehen Sie, was daraus wird

  1. Kopieren Sie das Ruby mit der Schaltfläche neben jedem Script auf dieser Seite.
  2. Öffnen Sie im Shopify-Adminbereich Stackable, dann Tools, dann Scripts-Rettung.
  3. Fügen Sie es dort ein, lesen Sie, was das Tool bauen will, und vergleichen Sie das mit den Einstellungen auf dieser Seite.

Die Scripts-Rettung gehört zum Pro-Tarif. Nichts wird veröffentlicht, bevor Sie angeben, was Ihr altes Script berechnet hat, und beide Zahlen auf den Cent genau übereinstimmen.

Bogo cross line interleaved (D17)

Nachgebaut

Gefährliches Paar D17. Diese Datei und ihr Gegenstück sehen fast gleich aus und verhalten sich unterschiedlich, lesen Sie also beide, bevor Sie entscheiden, welche Sie haben.

Das ursprüngliche Ruby

class InterleavedPartitioner
  def initialize(paid_item_count, discounted_item_count)
    @paid_item_count = paid_item_count
    @discounted_item_count = discounted_item_count
  end

  def partition(cart, applicable_line_items)
    sorted_items = applicable_line_items.sort_by { |line_item| line_item.variant.price }.reverse
    discounted_items = []
    paid_items_seen = 0
    discounted_items_seen = 0

    sorted_items.each do |line_item|
      line_item.quantity.times do
        if paid_items_seen < @paid_item_count
          paid_items_seen += 1
        else
          discounted_items_seen += 1
          discounted_items.push(line_item.split(take: 1))
          if discounted_items_seen == @discounted_item_count
            paid_items_seen = 0
            discounted_items_seen = 0
          end
        end
      end
    end

    discounted_items
  end
end

CAMPAIGNS = [
  BogoCampaign.new(
    ProductTagSelector.new("bogo"),
    PercentageDiscount.new(100, "Buy 2 get 1 free"),
    InterleavedPartitioner.new(2, 1)
  ),
]

CAMPAIGNS.each do |campaign|
  campaign.run(Input.cart)
end

Output.cart = Input.cart
Was daraus wird

Erkannt als Buy X, get Y und neu aufgebaut als Angebot vom Typ bxgy. Das sind die echten Konfigurationsschlüssel, mit denen das Angebot gespeichert wird, sodass Sie Ihren eigenen Nachbau Feld für Feld damit abgleichen können.

Jede Einstellung im Detail
EinstellungWertKonfigurationsschlüssel
Offer typebxgytype
Countingper_groupcounting
Recurrencerepeatrecurrence
Tier 1min qty 2 -> free itemtiers[0]
Buy quantity2bxgy.buyQty
Get quantity1bxgy.getQty
Get selectionsame_itembxgy.getSelection
Reward on the get units100% offbxgy.getDiscountPct
Free units are additionaltruebxgy.freeUnitsAreAdditional
Target scopetagstarget.scope
Target includesbogotarget.includeIds
MethodautomaticdiscountMethod
Allocationstandardstacking.allocation
Combines with other discountsnostacking
Sie werden um Bestätigung gebeten
  • Your Script limited this to a tag, vendor, or product type. We carried that filter over, so confirm it selects the products you expect.
Sie werden darauf hingewiesen
  • Your Script used Shopify's own item ordering to choose what to discount. We use the campaign's allocation order, which can pick a different item in a mixed cart.
Der Warenkorb, der es belegt

Aufgebaut in unserem öffentlichen Demo-Shop Meridian Goods, damit sich jeder Preis hier nachrechnen lässt und nicht geglaubt werden muss. Der Rabatt unten ist das, was dieselbe Engine, die im Checkout läuft, für genau diesen Warenkorb berechnet.

  • No Meridian Goods product carries the tag bogo. Set it on Aria Wireless Earbuds in Shopify before you build the cart, and on nothing else.
Der Warenkorb, der dieses Angebot auslöst, und was es kostet
ArtikelMengeEinzelpreis
Aria Wireless Earbuds3$79.00
Zwischensumme$237.00
Rabatt-$79.00
Summe$158.00

Nicht angemeldet oder als Kunde ohne Tags angemeldet.

Die Zahl, an der das Tool Sie misst

Vor dem Veröffentlichen fragt das Tool, was Ihr altes Script mit einem Warenkorb gemacht hat, den Sie bereits haben. Stellen Sie ihn auf 3 von Aria Wireless Earbuds zu $79.00 ein, dann steht die Antwort fest.

Der Rabatt beträgt $79.00. Der Betrag, den der Käufer gezahlt hat, ist $158.00.

Der Vergleich ist exakt, bis auf die kleinste Einheit Ihrer Währung. Ein Cent daneben und das Veröffentlichen bleibt gesperrt, genau darum geht es bei diesem Schritt.

Der Warenkorb, der nichts auslösen darf
  • drop to 1 of the same product, under what the rule needs
Der Warenkorb, der dieses Angebot nicht auslösen darf
ArtikelMengeEinzelpreis
Aria Wireless Earbuds1$79.00
Zwischensumme$79.00
Summe$79.00

Nicht angemeldet oder als Kunde ohne Tags angemeldet.

Bogo cross line low to high (D17)

Nachgebaut

Gefährliches Paar D17. Diese Datei und ihr Gegenstück sehen fast gleich aus und verhalten sich unterschiedlich, lesen Sie also beide, bevor Sie entscheiden, welche Sie haben.

Das ursprüngliche Ruby

class LowToHighPartitioner
  def initialize(paid_item_count, discounted_item_count)
    @paid_item_count = paid_item_count
    @discounted_item_count = discounted_item_count
  end

  def partition(cart, applicable_line_items)
    sorted_items = applicable_line_items.sort_by { |line_item| line_item.variant.price }
    total_applicable_items = sorted_items.map(&:quantity).reduce(0, :+)
    discounted_items_to_find = (total_applicable_items / (@paid_item_count + @discounted_item_count)) * @discounted_item_count
    discounted_items = []

    sorted_items.each do |line_item|
      break if discounted_items_to_find <= 0
      take = [line_item.quantity, discounted_items_to_find].min
      discounted_items.push(line_item.split(take: take))
      discounted_items_to_find -= take
    end

    discounted_items
  end
end

CAMPAIGNS = [
  BogoCampaign.new(
    ProductTagSelector.new("bogo"),
    PercentageDiscount.new(100, "Buy 2 get 1 free"),
    LowToHighPartitioner.new(2, 1)
  ),
]

CAMPAIGNS.each do |campaign|
  campaign.run(Input.cart)
end

Output.cart = Input.cart
Was daraus wird

Erkannt als Buy X, get Y und neu aufgebaut als Angebot vom Typ bxgy. Das sind die echten Konfigurationsschlüssel, mit denen das Angebot gespeichert wird, sodass Sie Ihren eigenen Nachbau Feld für Feld damit abgleichen können.

Jede Einstellung im Detail
EinstellungWertKonfigurationsschlüssel
Offer typebxgytype
Countingper_groupcounting
Recurrencerepeatrecurrence
Tier 1min qty 2 -> free itemtiers[0]
Buy quantity2bxgy.buyQty
Get quantity1bxgy.getQty
Get selectioncheapest_eligiblebxgy.getSelection
Reward on the get units100% offbxgy.getDiscountPct
Free units are additionaltruebxgy.freeUnitsAreAdditional
Target scopetagstarget.scope
Target includesbogotarget.includeIds
MethodautomaticdiscountMethod
Allocationstandardstacking.allocation
Combines with other discountsnostacking
Sie werden um Bestätigung gebeten
  • Your Script limited this to a tag, vendor, or product type. We carried that filter over, so confirm it selects the products you expect.
Der Warenkorb, der es belegt

Aufgebaut in unserem öffentlichen Demo-Shop Meridian Goods, damit sich jeder Preis hier nachrechnen lässt und nicht geglaubt werden muss. Der Rabatt unten ist das, was dieselbe Engine, die im Checkout läuft, für genau diesen Warenkorb berechnet.

  • No Meridian Goods product carries the tag bogo. Set it on Aria Wireless Earbuds and Impact Phone Case in Shopify before you build the cart, and on nothing else.
Der Warenkorb, der dieses Angebot auslöst, und was es kostet
ArtikelMengeEinzelpreis
Impact Phone Case2$24.00
Aria Wireless Earbuds1$79.00
Zwischensumme$127.00
Rabatt-$24.00
Summe$103.00

Nicht angemeldet oder als Kunde ohne Tags angemeldet.

Die Zahl, an der das Tool Sie misst

Vor dem Veröffentlichen fragt das Tool, was Ihr altes Script mit einem Warenkorb gemacht hat, den Sie bereits haben. Stellen Sie ihn auf 3 von Impact Phone Case zu $24.00 ein, dann steht die Antwort fest.

Der Rabatt beträgt $24.00. Der Betrag, den der Käufer gezahlt hat, ist $48.00.

Der Vergleich ist exakt, bis auf die kleinste Einheit Ihrer Währung. Ein Cent daneben und das Veröffentlichen bleibt gesperrt, genau darum geht es bei diesem Schritt.

Der Warenkorb, der nichts auslösen darf
  • drop to 1 of the same product, under what the rule needs
Der Warenkorb, der dieses Angebot nicht auslösen darf
ArtikelMengeEinzelpreis
Impact Phone Case1$24.00
Zwischensumme$24.00
Summe$24.00

Nicht angemeldet oder als Kunde ohne Tags angemeldet.

Zwei Dateien, die gleich aussehen

Jedes Paar unten ist dieselbe Script-Form in zwei Schreibweisen. Sie unterscheiden sich in ein, zwei Zeilen und tun Unterschiedliches. Lesen Sie beide, bevor Sie entscheiden, welche Sie haben.

Gefährliches Paar D17

Bogo cross line interleaved (D17)

Nachgebaut

Wird als bxgy-Angebot nachgebaut.

Rabatt im eigenen Warenkorb: $79.00

Zeilen, die abweichen
class InterleavedPartitioner
    sorted_items = applicable_line_items.sort_by { |line_item| line_item.variant.price }.reverse
    paid_items_seen = 0
    discounted_items_seen = 0
      line_item.quantity.times do
        if paid_items_seen < @paid_item_count

Und 11 weitere abweichende Zeilen, auf der eigenen Seite.

BOGO across the cart lesen

Bogo cross line low to high (D17)

Nachgebaut

Wird als bxgy-Angebot nachgebaut.

Rabatt im eigenen Warenkorb: $24.00

Zeilen, die abweichen
class LowToHighPartitioner
    sorted_items = applicable_line_items.sort_by { |line_item| line_item.variant.price }
    total_applicable_items = sorted_items.map(&:quantity).reduce(0, :+)
    discounted_items_to_find = (total_applicable_items / (@paid_item_count + @discounted_item_count)) * @discounted_item_count
      break if discounted_items_to_find <= 0
      take = [line_item.quantity, discounted_items_to_find].min

Und 3 weitere abweichende Zeilen, auf der eigenen Seite.

BOGO across the cart lesen

Häufige Fragen

Will Stackable rebuild this script?
Yes. Every spelling on this page is rebuilt today as a bxgy offer, and the cart above is the one that proves it.
What cart proves it works?
3 x Aria Wireless Earbuds at $79.00. The engine takes $79.00 off, and checkout charges $158.00.
What will I have to check before publishing?
Your Script limited this to a tag, vendor, or product type. We carried that filter over, so confirm it selects the products you expect. Your Script used Shopify's own item ordering to choose what to discount. We use the campaign's allocation order, which can pick a different item in a mixed cart.

Verwandte Script-Formen

Buy one get one free

A set of paid units earns an extra unit at no charge.

Buy X get Y, inclusive

The same buy-and-get offer, counted so the reward sits inside each set rather than beside it.

Limit the discounted units

The discount applied to the first few units only, with the rest at full price.

Fügen Sie Ihr Script ein und sehen Sie den Nachbau

Der Nachbau wird mit dem Betrag abgeglichen, den Ihr altes Script berechnet hat, bevor Sie ihn veröffentlichen können.

Wir verwenden essenzielle Cookies für den Betrieb dieser Website und, nur mit Ihrer Erlaubnis, Analyse-Cookies, um den Traffic zu verstehen. Lesen Sie unsere Cookie-Richtlinie.