docs
  1. SCAYLE Resource Center
  2. User Guide
  3. Shops
  4. Promotions
  5. Managing promotions

Managing promotions

General

The SCAYLE Panel offers different views on managing promotions. You can create the following promotion templates in just a few clicks:

Every promotion template type offers its own overview page, listing all promotions created for this template in a table, sorted by the creation time.

Automatic discount

The customer receives a discount on specific items in the basket or order. The discount can be relative, such as 10%, or absolute such as 10€. You can narrow down the discount conditions to a specific audience or items.

When creating a promotion that gives an absolute automatic_discount, but is available in different shop countries that have different currencies (e.g. available in both Germany and Poland) the set discount value will be the same in both currencies. For example, setting a discount of 10 will mean 10€ for Germany and 10Zloty for Poland. In this situation, we recommend you create a separate promotion for Poland.

Required fields for Automatic discount

To create an automatic discount following fields are at least required:

  • Name
  • Priority
  • Schedule Date
  • Discount value

Creating a new Automatic discount promotion

In order to create a new promotion, follow the steps described below:

  1. Select the Shop where you want to create your promotion and navigate to Promotions > Automatic Discount.
  2. Click the + New Automatic Discount button.
  3. In Name, type a name for the promotion.
  4. Priority: enter the priority of the promotion compared to others
  5. Start date: enter the date and time when the promotion starts running.
  6. End date: enter the date and time when the promotion becomes inactive.
  7. Select the Automatic Discount type. Add a specific amount or a percentage value.
  8. The automatic discount will be applied to any products by default. If needed you can change the applies to selected products, categories or Attribute Groups.
  9. Click Create.

Buy X get Y

To create and run a Buy X get Y promotion, consult your account manager to activate the config sellable_for_free. This config is deactivated by default for safety reasons, in order to avoid selling items for free by mistake.

The customer receives a free item when buying another item. The discount is added automatically to the item in the basket during the specified timeframe. You can define the exact conditions, for example, if a customer buys a number of specified items, certain items are received free of charge.

Required fields for Buy X get Y promotions

  • Name
  • Priority
  • Schedule Date
  • Customer buys
  • Customer gets

Create a new Buy X get Y promotion

To create a new promotion, follow the steps described below:

  1. Select the Shop where you want to create your promotion and go to Promotions > Buy X get Y.
  2. Click the + NEW BUY X GET Y button.
  3. In the Name field, type a name for the promotion.
  4. Priority: enter the priority of the promotion compared to others.
  5. Start date: enter the date and time when the promotion starts running.
  6. End date: enter the date and time when the promotion becomes inactive.
  7. Select the Customer Buy condition. If not the default value Any Product will be selected automatically.
  8. Set what Product the customer should get: If you select the Product while searching for an ID, single Attribute Group variants can be selected or added by Product ID: enter several product IDs separated with Comma and add them all at once. By default, all Attribute Groups are automatically selected. Note that variants set to be free under certain conditions must have the Attribute GroupisSellableForFree of the type simple set to true.
  9. Click Create Promotion.

Buy X get Y

Item Discount

The customer receives a discount on any items they buy. The discount can be relative, such as 10%, or absolute such as 10€. You can narrow down the discount conditions to a specific audience or items.

Required fields for item discount

To create an item discount promotion, the following fields are required:

  • Name
  • Priority
  • Schedule Date
  • Discount value

Creating a new item discount promotion

In order to create a new item discount promotion, follow the steps described below:

  1. Select the Shop where you want to create your promotion and navigate to Promotions > Item Discount.
  2. Click the + New Item Discount button.
  3. In Name, type a name for the promotion.
  4. Priority: enter the priority of the promotion compared to others
  5. Start date: enter the date and time when the promotion starts running.
  6. End date: enter the date and time when the promotion becomes inactive.
  7. Select the Item Discount type. Add a specific amount or a percentage value.
  8. The item discount will be applied to the specified item types. If needed, you can change the applies to selected products, categories or Attribute Groups.
  9. Click Create.

Create item discount

Advanced View

For advanced & complex cases, you can use the advanced promotions view.

  1. Enter a promotion Name.
  2. Select a Type: Automatic Discount or Buy X and Get Y.
  3. Select a Start date and End date.
  4. Enter a number for Priority. This determines the priority of the promotion in the case that there are multiple promotions active at the same time.
  5. Select whether the promotion should be combinable with other promotions.
    • If selected, enter Combinable promotion IDs in the Allowlist or Blocklist.
  6. In Countries, select in which countries of the current shop the promotion should be valid.
  7. In Audiences, select for which customer audience the promotion should be valid.
  8. (Optional) In Combinable, select which promotions are allowed or blocked for combination.
  9. Enter further criteria based on the discount type.
    • For type Buy X get Y, enter a list of variant IDs the customer can redeem.
    • For type Automatic Discount, enter Discount type and Discount amount.
  10. Add at least one condition to the promotion. See conditions below.
  11. Click Save.

Flash Sale

Flash Sale is the quickest and easiest way to add discounts on certain products. A percentage value is added automatically to the item in the basket during the specified timeframe.

Required fields for Flash Sale

  • Name
  • Priority
  • Schedule Date
  • Flash Sale Discount (%)
  • At least one Product

Creating a new Flash Sale

To create a new promotion, follow the steps described below:

  1. Select the Shop where you want to create your promotion and go to Promotions > Flash Sale.
  2. Click the + New Flash Sale button.
  3. In the Name field, enter a name for the promotion.
  4. Priority: enter the priority of the promotion compared to others.
  5. Start date: enter the date and time when the promotion starts running.
  6. End date: enter the date and time when the promotion becomes inactive.
  7. Enter the Flash Sale Discount.
  8. Select a Product: If you select the Product while searching for an ID, single Attribute Groups variants can be selected.
  9. Click Create.

Create Flash Sale

Add products via Product ID

You can also add products via Product ID: enter several product IDs separated by a comma and add them all at once. By default, all Attribute Group are automatically selected.

Add products via Product ID

Price Campaigns

The SCAYLE Panel allows you to set up price campaigns to discount products for a limited amount of time within a campaign.

The overview page lists information for each price campaign, such as ID, name, type, start and end date, shops included, and status.

The price campaign status indicates whether a campaign is Active or Inactive. Expired or not yet started price campaigns are automatically assigned the status Inactive.

You can set custom data for price campaigns.

Create price campaigns

  1. Go to Shops > Shop > Promotions > Price Campaigns.
  2. Click +NEW PRICE CAMPAIGN.
  3. Fill in:
    • Name
    • Price Campaign Key Uunique identifier)
    • Countries
    • Timeframe (Europe/Berlin)
  4. Click CREATE CAMPAIGN.

Create Price Campaigns

Variant price campaign

Variant price campaign is a reduction within a campaign for a certain product variant.
You can use ADMIN API to overwrite generic price campaign with variant specific values.

Price Campaigns custom data

Manage custom data in the SCAYLE Panel Settings area:

  1. Go to Settings > General > Custom Data.
  2. Select Price Campaigns, then ADD CRITERIA.
  3. Select the criteria type:
    • String
    • Number
    • Boolean (True/False)
    • JSON
  4. Optionally: click the configuration icon to make the field mandatory.
  5. Click SAVE.

Price Campaigns custom mandatory field

Custom data properties types & rules

TypeAllowed ValuesSupported RulesLimits
number
  • integer
  • float
  • double
  • string : casting applied
  • required: determine whether the property is required or not.(mandatory)
(-109, 109)
string
  • string
  • object : only in case the property isLocalized.
  • number : casting applied
  • minLength : specifies the minimum length of the property.(optional)
  • maxLength : specifies the maximum length of the property.(optional)
  • required : determine whether the property is required or not.(mandatory)
  • requiredLocales : represents the translations in case the property isLocalized = true. (optional)
  • The maximum length is 7,000 characters .
  • The maximum length of the value for a specific locale is also 7,000 characters.
boolean
  • true or false
  • 1 or 0
  • 'true' or 'false'
  • required : determine whether the property is required or not.(mandatory)
json
  • object
  • array
  • required : determine whether the property is required or not.(mandatory)
  • requiredLocales : represents the translations in case the property isLocalized = true. (optional)
  • jsonSchema : for the json type it is allowed to have any kind of jsonSchema. (optional)
  • Reference:
    JSON Schema
  • Maximum depth of a JSON object is 4 levels.
  • Although null is valid JSON, it is not allowed to set on the root level.
  • The entire JSON object (per locale) can not contain more than 7,000 characters.

Tiered Discounts

Tiered discounts allow adding Minimum Order Value (MOV) discounts to encourage customers to increase their basket value: “spend more to save more”.

Tiered discounts:

  • grant higher reductions than regular coupons
  • can only be unlocked by going above a minimum order value
  • Once unlocked, tiered discount levels push the customer to increase their order value
  • Tiered discount levels will be reevaluated on return. Lower reductions levels reduce the refund value.

MOV tiers are compared to the value of the entire basket, before any Coupon discounts (both regular coupons & MOV coupons) are applied.

Examples

  • Get 10% off on Jeans from 50€ basket value, 15% from 100€ and 20% from 150€
  • Get up to 30% discount on jackets and coats when spending over 200€ EUR
  • Spend 20€ to get 5% discount on glitter, 50€ to get 10% and 100€ to get 15% off

Create tiered discounts

  1. Go to Shops > Shop > Promotions > Tiered Discount.
  2. Click + NEW TIERED DISCOUNT.
  3. Fill in Details
  4. Set the Schedule
  5. Select Countries
  6. Select Audiences
  7. Combine Promotions
  8. In the Tiered Discounts section:
    1. Discount Type:
      Percentage or Amount
    2. Discount Tiers:
      Min Order Value > Enter discount Amount or Percentage
  9. Click CREATE.

Create tiered discount

Vouchers

Vouchers grant a relative or absolute discount on orders or order items and have to be submitted in the checkout flow. Only one voucher per order is allowed. The voucher is limited to the shop country it was created in.

The usage of vouchers can be limited by certain parameters and conditions (for example, max. applicable count, only applicable to certain brands, etc.).

Note that when you create a voucher in a particular shop country, one default criterion of the shopCountryId type is applied under the hood. This criterion limits the voucher to the given shop country.

Examples

  • Welcome voucher for registration
  • Sorry voucher for delayed delivery

Create a voucher

  1. Go to Shops > Shop > Promotions > Vouchers.
  2. Click CREATE NEW VOUCHER.
  3. In the General Information section, fill in:
    • Name
    • Clientele
    • Start date
    • End date
  4. In the Reduction & Order Amount section**,** fill in:
    • Reduction Type
  5. In the Codes section**,** fill in:
    • Code Generation
    • Usage limit
  6. Click SAVE.

Create a voucher

Voucher criteria

In SCAYLE, you can add additional restrictions on a voucher. You can allow vouchers to be applied to products of a particular category or a brand. You can also create a reverse criterion to allow vouchers for any brand except the given one.

Add voucher criteria

  1. Go to Shops > Shop > Promotions > Vouchers.
  2. Click CREATE NEW VOUCHER.
  3. In the Criteria section, select + Add criterion and choose one of the following:
    • Master category
    • Shop Category
    • Customer
    • Country
    • Brand
    • Product
    • Merchant
    • Payment Type
    • Customer Group
    • Membership Card Type

Conditions

The conditions are defined using the Google Common Expression Language.

To find out more about conditions, check the Promotion conditions section in the Developer Guide.

Managing Promotions

You can manage Promotion in the SCAYLE Panel in Shops > Promotions.

Edit a promotion

  1. Select the promotion from the overview list.
    If the system contains numerous promotions, use the search function to find the correct promotion.
  2. Click the EDIT button on the detail page.
    The same options apply as when creating promotion.

You can’t change the promotion type for existing promotions. In case you want a different type you have to create a new promotion.

Deactivate a promotion

  1. Select the promotion from the overview list.
  2. On the details page, click the three dots (to the right of the Edit button).
  3. Select Deactivate from the dropdown menu.

Deactivate promotion

Activate a promotion

  1. Select the promotion from the overview list.
  2. On the details page, click the three dots (to the right of the Edit button).
  3. Select Activate from the dropdown menu.

Delete a promotion

  1. Select the promotion from the overview list.
  2. On the details page, click the three dots (to the right of the Edit button).
  3. Select Delete from the dropdown menu.

Delete a promotions

Next Steps

Check out these tutorials:

Further education - SCAYLE Academy