Dev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunitySubmit a ticketLog In
GitHubNuGetDev CommunitySubmit a ticket

Set, create, and manage promotions

Describes how to set up, create, and manage promotions in Optimizely Configured Commerce.

Working with promotions includes creating a new promotions, adding rules, adding results, and assigning a promotion to a website.

📘

Note

If a Sales Representative provides a price quote on a product, any available promotions are disallowed. Additionally, any promotions applied to an order prior to submitting a quote request will be removed.

Details

The Promotion Details finger tab (Admin Console > Marketing > Promotions > edit or create a new promotion) contains fields that manage the high level description and general operation of the promotion. Promotions details are as follows:

  • Name – This required text field reflects the name of the promotion.

  • Description – This text field reflects a description and explanation of the promotion.

  • Promo Code – This text field reflects the promotional code that is used by the end user. This field is not mandatory, as some promotions do not require a promo code.

  • Rank – This numerical field ranks promotions from the lowest to highest number. The promotion with the lowest rank is executed first, and stops subsequent promotions from being applied. If multiple promotions are allowed on a single transaction, this field does not apply, unless using multiple Orderline level promotions.

    • If a Promo Code is applied to a cart after a ranked promotion is applied, the Promo Code promotion overrides the ranked promotion.
    • If using ranked promotions, do not assign the same rank to multiple promotions. This can cause inconsistencies in promotion calculation.
  • Activate On – This date field reflects the date and time the promotion is active.

  • Deactivate On – This date field reflects the date and time the promotion is deactivated.

  • Is Live – This field is an On/Off toggle that determines if the promotion is live and available on the website

Create a new promotion

  1. Go to Admin Console > Marketing > Promotions.

  2. Click Add Promotion.

  3. Enter the Promotion Details:

    1. Enter the Promotion's name in the Name field.

    2. Optionally, add a description. Descriptions can be helpful when there are multiple promotion authors, when promotion names are similar to existing promotions, or to describe the trigger and results of the promotion.

    3. Optionally, enter a code in the Promo Code field.

      When using the Promo Code field, there is no need to create additional Rules unless additional complexity is desired, such as qualifying that a customer needs to be from a certain company for the code to be accepted.

    4. Enter the Promotion's rank in the Rank field. This numerical field ranks promotions from the lowest to highest number. The promotion with the lowest rank is executed first, and stops subsequent promotions from being applied. If multiple promotions are allowed on a single transaction, this field does not apply, unless using multiple Orderline level promotions.

      • If a Promo Code is applied to a cart after a ranked promotion is applied, the Promo Code promotion overrides the ranked promotion.
      • If using ranked promotions, do not assign the same rank to multiple promotions. This can cause inconsistencies in promotion calculation.
    5. Enter the date/time at which the promotion will activate using the date/time buttons.

    6. Enter the date/time when the promotion will deactivate using the date/time buttons.

      The Deactivate On field may be left blank to keep the promotion active for an undetermined period of time.

  4. Toggle the Is Live toggle to ON to activate the promotion.

  5. When finished, click Save or Save and Add New.

Add promotion rules to a promotion

Because rules are highly customizable, this section describes the fields and general process of adding promotion rules but does not go into detail about each rule type. See also documentation on Rule Types.

  1. Go to Admin Console > Marketing > Promotions.

  2. Find the desired promotion and click Edit.

  3. Click the Rules finger tab.

  4. If creating multiple rules in a singular Rule Group, use the drop-down to determine if Any or All of the rules within the Rule Group need to match.

  5. Select the desired rule from the Rule Type drop-down menu.

  6. Select the desired Rule variables.

    The Rule variables dynamically change based on the selected Rule Type. The chosen Rule Type also determines if it is possible to add an additional Rule to the same Rule Group.

  7. Add additional Rules to the current Rule Group by clicking Add Rule.

    📘

    Note

    If more than one Rule Group exists, the execution order is determined by the order that the Rule Groups are positioned on the page. To change the order, drag and drop the Rule Group to the correct position.

  8. Use the Condition Option drop-down to select the desired condition:

    1. If an additional Rule must be met, select "AND".
    2. If an alternate Rule may be met, select "OR".
    3. If no further Rules exist or will be added, select "AND".
  9. When finished, click Save .

Add promotion results to a promotion

After the Rules have been created, establish the Results.

  1. Go to Admin Console > Marketing > Promotions.

  2. Find the desired promotion and click Edit.

  3. Click the Results finger tab.

  4. Within the dialog box, select the desired Result Type from the drop-down menu.

  5. Update the Result Type variables as necessary for the selected result.

    📘

    Note

    The fields displayed below the Result Type drop-down menu dynamically change based on the selected Result Type.

  6. When finished, click Save.

Assign a promotion to a website

For a promotion to be applied to a user's cart, it must first be assigned to the appropriate website.

  1. Go to Admin Console > Marketing > Promotions.
  2. Find the desired promotion and click Edit.
  3. Select the Websites finger tab.
  4. Click Assign Websites.
  5. Select one or more websites from the list. Click Assign.
  6. Click Done to save.

Alternately, assign a promotion to a website from within a website record.

  1. Go to Admin Console > Websites.
  2. Find the desired website and click Edit.
  3. Click the Promotion fingertab.
  4. Find the desired promotion and click Edit.
  5. Select the Websites fingertab.
  6. Select Assign Websites.
  7. Select the desired websites and click Assign.
  8. Click Done .

Your promotions are now ready to be used.