Promotions (formerly known as Offers)

Antavo’s Promotions module delivers pre-purchase incentives to customers both online and offline. You can create cart or item discounts in the Management UI so that Antavo can provide the necessary promotion information for your customers to choose at the checkout. The Offers API endpoint and Display API serve you with the list of applicable promotions on a cart. However, you need to implement the solution in your checkout process to reduce the actual basket value based on the settings of the promotion.

To access the configuration page, open the Modules menu and search for Offers. The page will display a list of promotions that are already set up, providing the following information:

Setting up a new promotion

• Click the Create new offer button in the sidebar of the Promotions module page

• Add the name of the promotion
  This will be the name of the promotion on the Antavo Management UI, and you can also use the Offers API to request this information.

• Set the type of the promotion to create:

  • Cart offer: Applies a discount on the basket value of the purchase, based on specific products or predefined minimum and maximum values.

  • Item offer: Applies a discount on an item or items in the cart, optionally restricted to a minimum and maximum basket value.

  • Combined offer: Applies a discount on an item or items if the cart contains specific products and/or meets the predefined minimum and maximum values.

Common settings of all promotion types

• Add priority
  Enter the priority of the promotion in the Weight field. A lower number indicates higher priority, determining the displayed order of the promotions.

• Select a coupon pool
  If you want Antavo to assign coupons to promotions based on pools you have already created in the Coupons module. Once the coupon pool has been selected, the help text displays information on the source, type, and amount settings of the pool, as well as the number of coupon combinations available.

Restrictions

Antavo filters the list of applicable promotions provided through the Offers API based on the restrictions set below, excluding the Exclusive checkbox.

• Check the Recurring box if you want to make the promotion recurring

  • Set recurring options

    • weekly: Select the recurring day(s) from Monday to Sunday for your promotion, and specify the start and end time of the day.

    • monthly: Select the recurring calendar day(s) for your promotion, and specify the start and end time of the day.

    • yearly: Select the recurring month(s), day(s), and the start and end time of the day

  • Enable Nighly recurring to include the following day in the end time. Example: if you select Monday and set an end time of 1:30 AM, the end time will be on Tuesday at 1:30 AM.

    This also applies if the end time is earlier in the day than the start time. Example: if it's set for Monday and the start time is 12:30 AM, while the end time is 1:30 AM, then it won't run until Tuesday at 1:30 AM.

• Define the redemption start and end date
  These settings are only applicable if the Recurring checkbox is turned off. Use them to set the timeframe in which customers can redeem this promotion. Please note that promotions cannot be redeemed before the issuance start date, (find instructions below), even if the redemption start date is earlier.

• Set the number of applications and the customer’s redemption frequency

  • Number of applications
    Set the number of times the promotion can be redeemed per customer. Leave empty for no limit.

  • Redemption frequency
    Set the number of times the promotion can be redeemed per customer within a week, a month, or a year.

• Define segments and/or lists
  Specify the segments or lists that can use this promotion. Adding multiple segments makes the promotion available for customers who are members of any of the segments added.

• Select stores
  Choose the stores where customers can use this promotion. Leave it empty for no restriction. Store restriction is only available if you added your stores in the Stores module.

• Turn on the Exclusive option
  Promotions can be added as exclusive, meaning they cannot be used together with any other promotion in the same checkout.

Cart

• Use the Min total and Max total fields to restrict the availability of promotions to specific cart totals

Discount

• Select the discount type for the promotion:

  • Fixed price

  • Fixed discount

  • Percentage discount

• Set the value
  Define the discount to be applied to the cart total or on specific item(s) in the cart.

Promotion card

To ensure the promotion is displayed on the membership site, complete the following fields. This will enable Antavo to provide all necessary information via the Display API.

• Enable the promotion on the membership site
  Check this option to display the promotion on the membership site. If not enabled, the promotion will not be included in the API response when querying available promotions for a specific customer.

• Add the title of the promotion

• Write a description

• Upload an image
  The image is provided by API endpoints in 3 sizes (small, medium, and large).

• Issuance start date and end date
  The promotion will be included in the list of available promotions between these dates, and assigned to customers within this timeframe. Note that promotions cannot be redeemed before the issuance start date, even if the redemption start date is an earlier date.

• Display ‘coming soon’ before the start date
  If enabled, the promotion will be added to the API response even before the issuance start date.

• Display the promotion only for the selected segments
  If this option is not disabled, the promotion will be added to the API response even if the customer is not eligible based on segment restriction.

• Set the inventory size
  The number of promotions available to be assigned per customer or globally. For example, if you want to assign the promotion to one specific customer only once a day, set the issuance frequency to 1 per day.

• Set the issuance frequency
  Specify how often the promotion can be assigned to a specific customer per day, per week, per month, or per year. For example, if you want to assign the promotion to one specific customer only once a day, set the Issuance frequency to 1 per day.

Specific settings of promotion types

Required items

Applicable to Cart and Combined types of promotions only.

Match any or all option defines if all or at least one of the required items should be added to the cart. Specify the required product(s) by selecting from the Product catalog, or entering a list of product IDs.

Eligible items

Applicable to Item and Combined types of promotions only.

Match any or all option defines if all or at least one of the eligible items should be added to the cart. Specify the required product(s) by selecting from the Product catalog, or entering a list of product IDs.

Discount

Applicable to Item and Combined types of promotions only. Add a Target and a Maximum quantity to the item and combined items where discounts can be applied on item(s) in the cart.

• Target: Grant the discount on all eligible items in the cart, or only on the cheapest/most expensive item.

• Max quantity: Set the quantity of eligible item(s) that the promotion can be applied to.

Saving and activating a promotion

After completing all the necessary configuration for the promotion, save your settings by clicking Save button at the bottom of the setup page. Initially, the promotion will be saved as inactive, meaning it won’t be accessible to customers and will only appear in the list of promotions in the Management UI. Once saved, you can activate the promotion by clicking the Set active button on the upper right-hand side of the promotion setup page. Confirm the activation in the dialog that subsequently appears, and the promotion will become active for customers to use.

Managing promotions

Edit a promotion

• Navigate to the Offers tab

• Click the Edit button next to the promotion you wish to modify

• Make your desired changes to the promotion

• Click Save

Deactivate a promotion

• Navigate to the Offers tab

• Click the Edit button of the promotion you want to deactivate

• Click the Set inactive button on the upper right-hand side of the page

• Confirm your choice in the dialog that appears

Archive a promotion

You can delete inactive promotions by archiving them.

• Navigate to the Offers tab

• Click the Edit button of the promotion you want to archive

• Click the Archive button on the upper right-hand side of the page

• Confirm your choice in the dialog that appears

Archivation is irreversible. Once a promotion is archived, it cannot be restored.

Search for a promotion

Use the search bar on the Offers page to find a specific promotion by its name.

Filter promotions

Filter your promotions on the Antavo Management UI by clicking the Filters button at the top of the module configuration page. You have three options: filter promotions by type, status, or both. Click Apply to view the filtered list, or Reset to select a new filtering method.

Sorting of promotions

You can arrange the order of promotions on the membership site by accessing the Sorting option in the sidebar. The list of promotions provided by the Display API will adhere to this sorting. Drag and drop the promotions to adjust the order, and the changes will be automatically implemented.