Rules

Rules define what your members can do to get points, instant rewards and/or badges. When a member performs an incentivized action, the rule criteria are evaluated and, if met, the points or rewards you specify are given.

Creating Rules

After creating a promotion, you can start creating rules. From Incentives find and click on the promotion you want to create a rule for. Click New on the right side of the screen.

Basic Info

Define name and description
First, you must choose a name for your rule as well as a description that best fits the rule. Members will be reading this so make sure it will be easy for them to understand.

When do you want this Rule to apply?
You will need to define when the rule will be triggered. By default, Always will be selected. You will have two options to choose from:

Always - The Single Action Engine evaluates all Rules, no matter their type as long as they meet their Criteria. As a result, you can choose to give Points, Instant Rewards and/or Instant Badges for each Rule.

🚧

Point Types in Rules

Only rules whose type is Always can grant different point types in the same rule.

Only when it awards the most points - The Single Action Engine evaluates all rules whose type is Only when it awards the most points and which share the same point type as well as action. As a result, points are given only for the rule that represents the best choice for the member, that is, the rule that grants the larger number of points.

📘

Only when it awards the most points & Points Capping

When applying points caps to Only when it awards the most points rules, any limits related to capping will be calculated before evaluating which rule offers the best option to a member. In other words, caps are taken into account when determining which rule gives the most points. See Points Capping for details.

Now that you have created the basic information, you can click Next to define the criteria.

Criteria

Criteria governs rules as they are the conditions that evaluate the incentivized action, that is, the behavior you have chosen to drive in your members. Criteria are based on fields of the selected action or some other records related to the action (e.g. If your action is Transaction, you can set a rule that evaluates the complete transaction or a specific record related of transaction such as Transaction> Points).
When these conditions are met, your members obtain the outcome that you want, which can be points (if Rule Type is Only when it awards the most points), or points, instant rewards and/or badges (if Rule Type is Always).

🚧

Actions must be already created and available before creating rules.

What action do you want to incentivize?
It shows the specific source for the Action, which can be the same object or any other object that has a lookup relationship with it. For example, if the Action object is Transaction, you can choose Transaction or any other related object - in this case, Points - as your Target Object.

Set conditions based on object fields
Rules also allow extra filters, which are fields from target object that refine rules conditions. Those fields can be compared to a specific value or even to another field by using relational operators such as "Equals", "Greater than", "Less than", etc.

Let's walk through how to apply this:

• Under Field Name, select the object or lookup relevant to your criterion. If you choose a lookup, select the field from that object that relates to your criterion.
• Under Operator, choose the operator that will compare the field with your criterion value.
• If you want to compare the value of the field in Field Name with the value of another field, tick Field. Otherwise, leave unticked .
• Under Value, enter the number or text value you want to compare with the field in Field Name or, if Field is , choose the field whose value you want to compare with the field in Field Name.

To add another criterion, click Add condition and follow the same process to define it. You can remove a criterion by clicking .

Process when
In addition, you can set several criteria filters and combine them using logical expressions to create more complex conditions.

• All means that a member needs to accomplish all rules to qualify for the award.
• Any means that a member can qualify for the outcome by accomplishing any one of the rules.
• Custom allows you to specify more complex criteria prioritization. If selected, you must enter a formula with logical operators and your criterion numbers. For example, if you enter (1 AND (2 OR 3)), a member activity that meets your first criterion and your second or your third criterion (or both) will count toward the rule.

Once you have determined your criteria, if any, you can click Next.

Reward Types

Decide how you’ll reward members for performing the incentivized action. You can choose one or any combination of points (standard and custom), a badge, an instant reward or a custom rewarding class.

📘

Rules that reward Only when it awards the most points can only give points and/or custom point types.

Choose Points

Points are a fast, simple way to award members and incentivize your members behavior. Once you've defined your Rule Type and Criteria, you can choose in which way rules will grant points and any point type (if applicable).

❗️

Rules cannot deduct points. Avoid inputting negative values.

Point Conversion: Mode and Value
You can decide how points are converted into different modes depending on how you want to manage points and award your members. There are three ways to award points:

1. None is only available when having more than a point type, i.e. you are giving Miles but not points, or when your rule type is No Competition - in which case you must select either an Instant Reward or Instant Badge.
2. Fixed Value awards Members with a fixed number of Points. In the Point Conversation Value field, enter the number of Points winning Members will earn. E.g. If Point Conversion Value is 100 it means that every time Members meet the Rule Criteria they will obtain 100 Points.
3. Factor gives members a set of points by dividing the target object of a rule by the fixed number you enter in the Point Conversation Value field. E.g. If your target object is Transaction> Points, you can divide any numerical field from Points by 2.
4. Multiplier awards points to members by multiplying the target object of a rule by the fixed number you enter in the Point Conversation Value field. E.g. If your target object is Transaction> Points, you can multiply any numerical field from points - balance - by 2.

Optionally, you may also specify a Point Expiration Mode, which determines when points awarded will expire from a winning member's profile:

• Use Never when you don't want points to expire
• Use Days to specify a fixed number of days that points will be valid.
• Use Months to specify a fixed number of months that points will be valid.
• Use Specific Date to specify a particular expiration date for all points awarded through this rule.
• Use Recurrent Date to specify the month and day all points awarded through this rule will expire every year.

Choose an Instant Reward

When your rule type is Always, you can award your members granting them an instant reward and/or an badge. These instant rewards and badges are the rewards and badges that you've set up for rewarding. You can give your members an instant reward and/or an badge together with points or without them as well.

Instant rewards are a great way to give your members immediate gratification when they meet a rule. You can set rules to give your members Instant Rewards in two different ways:

1. Fixed Value mode awards a specific instant reward from all available rewards which are as instant rewards.
2. Specified by Field mode lets you grant instant rewards based on a dynamic field.

Optionally, you can set Stock Control , which determines not to process the transaction if reward is out of stock.

📘

Instant rewards will only be visible when you are using Always to apply the rule.

Choose a Badge

Badges are perfect for members to boast about their performance or accomplishment. They're a great reputation builder for any partner or employee community!

1. Fixed value mode awards a specific number of instant badges chosen from the available badges.
2. Specified by field mode lets you grant instant badges based on a dynamic field.

Optionally, you can specify a Badge Expiration Mode, which determines when the badge will expire from a winning member's profile:

• Use Never when you don't want the badge to expire
• Use Days to specify a fixed number of days that a winning member will hold the badge.
• Use Months to specify a fixed number of months that a winning member will hold the badge.
• Use Specific Date to specify a particular expiration date for all badges rewarded through this rule.
• Use Recurrent Date to specify the month and day all badges rewarded through this rule will expire every year.

Specify Additional Rewarding (Only 'No Competition' Rules)

For further rewarding flexibility, you can implement an Apex Class with custom functionality.

First, you'll need to add your custom functionality to the CustomRewardingClass class below:

//The class implements FieloPLT.RuleRewarding interface.

public with sharing class CustomRewardingClass implements 
FieloPLT.RuleRewarding{
    
   public void reflectionRewarding(List<FieloPLT__Transaction__c> transactions){ 
    }
    public void revertRewarding(List<FieloPLT__Transaction__c> transactions){
    }
}

With that ready, go to Setup and search for Apex Classes in the Quick Find box. Click New, add your class and click Save.

Then, from Object Manager, navigate to the Challenge Reward object. From Fields & Relationships, choose the Reward Delivery Class field.

Under Values**, click _New. Enter the name of the Apex class you've created (e.g. CustomRewardingClass) and click _Save*. Your class will now be available to assign as additional rewarding.

Rule Management Tools

You can edit or delete each rule no matter its status.

Edit

After creating the number of rules you want your promotion to have, you can edit any section within the rule.
To edit a rule, click in the row corresponding to the rule and select Edit.

📘

You can always edit rules in an Active promotion without affecting what has been processed so far.

Delete

To delete a rule, click in the row corresponding to the rule and select Delete.