Purchase Actions

Written By Devin O'Neill ()

Updated at April 4th, 2025

Summary

  • Marketers can define Purchase Actions according to the Loyalty program.
  • Purchase Actions offer flexibility to adjust Points, Maximum Point Limits, Hold Points, and other settings based on the requirements of a Loyalty Program.

Configuration

Configure a Standard Action

Several predefined and commonly used actions are available for use by configuring a Standard Action.

  • Standard Actions are starting points for commonly used Actions.
  • Some Standard Actions are a basic functionality that only needs to be activated for the Loyalty program. However, many Actions offer the flexibility to adjust points, limitations, UI, and other additional settings based on the Loyalty program.

Perform the following steps to configure a Standard Action:

  1. Click Add New Action from the Action Rules page.
  2. Select Choose from Standard Action.
  3. Click Proceed.
  4. Select Purchase Action from Standard Actions drop-down list.

5. Click Proceed.

Configuration Fields and Explanations:

Field Explanation

General Information

Name The Name of the Action. This field is read-only.
Action Activity Display Name If applicable, enter a Name for the Action to be used on the Dashboard. This field is optional.
Advance Points Allocation Rules

You can set different Points or Ratio values based on the amount spent brackets. When this option is enabled, the following field presents.

 

Ratio Enter the point ratio that will be applied for Bonus points a user will earn for completing this action. For example, enter 2 to award double points for this action.
Action Enabled Enable (ON) or disable (OFF) the Action.
Action ID A unique identifier for the Standard Action is automatically assigned by the system. This field is read-only.
Purchase Point Type

We have added the field in the purchase action (Action ID = 109) to override the purchase points type that we set up in the Product Catalog.

There are three options in the Purchase Points type:

  1. Both Type
  2. Only Ratio
  3. Only Flat/Bonus

Note: Based on the client requirements we can enable and disable this option.
Flag Location: Manage Site → Loyalty Site Admin Tab Settings.

 

When the product is configured in the PCM with points ratio and flat points, for those products “Only Flat/Only Bonus” points will be considered. If any product is not configured in the PCM then the purchase ratio set in the purchase action id will be considered.

 

  1. Both: If a user selects the Both options, then the points are awarded for the products concerning Ratio and Bonus selected in the Product/Category Points Type in Product Catalog Management (PCM).
    • The formula to calculate the ratio and bonus is [(Unit price of product x Quantity x Product Ratio x Purchase Ratio)+(Quantity x Flat/Bonus points)].
  2. Only Ratio: If a user selects the Only Ratio option, the points are awarded for the products concerning Ratio selected in the Product/Category Points Type option in the Product Catalog Management (PCM).
    • In this case, if Both (Ratio and Bonus) are selected in Product/Category Points Type, only the ratio is calculated.
    • The formula to calculate the Only Ratio is (Unit price of product x Quantity x Product Ratio x Purchase Ratio).
  3. Only Bonus: If a user selects the Only Bonus option, the points are awarded for the products concerning Bonus selected in the Product/Category Points Type option in the Product Catalog Management (PCM).
    • In this case, if Both (Ratio and Bonus) are selected in the Product/Category Points Type, only the bonus is calculated.
    • The formula to calculate the Only Bonus points is (Quantity x Bonus points).

Use Cases

  • If there are three types of Products added to the PCM:
    Product P1 the Product Ratio is defined as 2.
    Product P2 the Product Flat/Bonus Points are defined as 100.
    Product P3 the Product Ratio is 2 and Product Flat/Bonus Points are defined as 50.
    Let's assume that the:
    • Unit Price = 10
    • Quantity = 2
    • Product Ratio = 2
    • Purchase Ratio =1

Use Case 1: 
If the Purchase Points Type is selected as Both in the Purchase action.

  • The points calculation is applied to each product as per the given formula
    Product P1 The points calculation is:
    (Unit price of product x Quantity x Product Ratio x Purchase Ratio)
    (10x2x2x1) = 40.
    Product P2 The points calculation is:
    (Quantity x Flat/Bonus points)
    (2x100) = 200.
    Product P3 The points calculation is:
    [(Unit price of product x Quantity x Product Ratio x Purchase Ratio) +(Quantity x Flat/Bonus points)] [(10x2x2x1) +(2x50)] = 140.
    Total points awarded against the Order (40+200+140) = 380.

Use Case 2: 
If the Purchase Points Type is selected as Only Bonus in the Purchase action.

  • The points calculation is applied to each product as per the given formula
    Product P1: No Points are rewarded.
    Product P2 The points calculation is:
    (Quantity x Flat/Bonus points)
    (2x100) = 200.
    Product P3 The points calculation is:
    [(Unit price of product x Quantity x Product Ratio x Purchase Ratio) + (Quantity x Flat/Bonus points)]
    [(0) + (2x50)] = 100.
    Total points awarded against the Order (200+100) =300.

Use Case 3:

If the Purchase Points Type is selected as Only Ratio in the Purchase action.

  • The points calculation is applied to each product as per the given formula
    Product P1 The points calculation is:
    (Unit price of product x Quantity x Product Ratio x Purchase Ratio)
    (10x2x2x1) = 40.
    Product P2: No Points are rewarded.
    Product P3 The points calculation is:
    [(Unit price of product x Quantity x Product Ratio x Purchase Ratio) +(Quantity x Flat/Bonus points)] [(10x2x2x1) +(0)] = 40.
    Total points awarded against the Order (40+40) =80.

Note:

  1. If the Tier Ratio and Campaign Ratio also need to be calculated, the formula is:

{Unit price of product x Quantity x Product Ratio x Tier Ratio x max(Purchase Ratio, Campaign Ratio)}.

  1. Purchase Ratio/Campaign Ratio: The highest ratio among the purchase and campaign ratios is applied for calculation.
Limit max order type

Select maximum order type as Percentage or Points. Select points or percentage to limit maximum order type.

 

If the users are spending more than expected, then the user can limit the points to be awarded for that specific order.

Navigation: Products > Loyalty > Action Settings > Purchase Actions

 

Note: 

  1. In the old admin site EDIT and add the configuration settings.
  2. In the New ADR site click on Create Action and add configuration settings.

This use case can be achieved by using the custom points validation in the purchase action and the Limit max order type field added.

  • Points from the drop-down menu and add max order value you want to allocate for this order.
  • Percentage from the drop-down menu, add the max order value you want to allocate for this order.

Click Next and enable or disable the Advanced Purchase Ratio.

Advanced Purchase Ratio

Administrator must be able to set various points ratios for purchase actions. This can be done by activating the "Advanced Points Ratio" setting, which allows the user to assign different points ratios for different "Transaction Types" as per their requirement.

This includes Advanced Purchase Ratio toggle helps admins to ON or OFF option to apply purchase ratio.

Advanced Transaction Types allows the administrator to Add New Advanced Transaction Types, as well as define Transaction Type, Ratio, and Action. Based on the ratio, the transaction points are calculated.

Once all the fields are configured, click Create New Action. A popup screen offers additional customization options. Customize the Action further by clicking Let’s Customize More. Otherwise, click I’m Done to save progress. If an administrator chooses not to customize the Action rule further at this time, they can edit the Action in the future by using the Edit functionality within the Action Rules table.

Points Limitation

The detailed points limitation explained below.

Maximum Point Limit The Maximum Number of Points which can be earned by the member against the Purchase Action.
Maximum Point Limit Duration

Select Rolling or Calendar from the drop-down.

If the user selects Rolling, enter the number of Days for a Rolling Threshold to enforce the Maximum Point Limit.

If the user selects Calendar, enter the number of Calendar Days to enforce the Maximum Point Limit.

Action Interval Limit Enter an Interval in Days or Hours to encourage the customer to perform the Action and earn Points.
Points Expiration

Select Rolling or Calendar from the drop-down.

  • If the user selects Rolling, enter the number of Days for a Rolling Threshold for Points earned by performing the Action to expire.
  • If the user selects Calendar, enter the number of Calendar (Weeks, Months, or Years) for Points earned by performing the Action to expire.
    1. Calendar > Week (Mon-Sun) >1: If user selected Week,
      For example, if a member earns points on a Wednesday, those points expire on the following Sunday of the same week.
    2. Calendar > Month > 2: If user selects Month,
      For example, if a member earns points in August, those points expire on September 30.
    3. Calendar > Year > 1 Year: if user selects 1 Year,
      For example, if a member earns points on May 2, 2023, those points expire on December 31, 2023.
  • There is now the option to select an expiration date up to 10 years in the future.

Note: Points Expiration options are available in Action Rules, Action Series, Tiers, and Campaigns.

Hold Points

The Number of Days for which the Points earned through this Action can be on hold.

Admin can put the purchase points on hold for a certain number of days.

  • We use hold points only for Purchase Actions.
  • Hold points will be displayed in the Hold Points Report.

We have three options to put the purchase points on hold.

  1. Order Placed Date: The points will be held X number of days from the date the order was placed. These points get released when the order is shipped or the released date that we configured in the site admin.
  2. Order Item Ship Date: The points will be held X number of days from the date the order is shipped. These points will get released after the day(s) configured in the site admin.
  3. All Items from Order Ship Date: Selecting this option you can set the Hold Points from when the last item of the order shipped.

Note: We have a separate Hold Points Report for this. To see the hold points report we have enabled it from the Super Admin.

Please refer Hold Points Report for more details.

Include Tier Limit If this is ON, then it turns ON a flag in Actions - Point Limitation called ‘Include Tier Limit’. Now for those actions which have ‘Include Tier Limit’ turned ON will only be considered

Once all the fields are configured, click Create New Action. A popup screen offers additional customization options. Customize the Action further by clicking Let’s Customize More. Otherwise, click I’m Done to save progress. If an administrator chooses not to customize the Action rule further at this time, they can edit the Action in the future by using the Edit functionality within the Action Rules table.