Difference between revisions of "LoyaltyUserGuide"

Revision as of 09:05, 12 July 2017

Loyalty – Administration and Configuration

Configuration of the functionality of work with the application

Go to «Opportunity Page Layout». To the "Opportunity Detail" section, add the "Loyalty Program" field and the "Refresh Data" button.

Go to the "Products Related Lists" settings.

Add the following fields to the displayed ones:
«Discount» - amount of discount;
«Point Type» - the type of points selected for payment of the product;
«Total Point Price» - the total price of points of the selected type required for the purchase of the product;
«Total Point Pay» - the total amount of money funds required for the purchase of the product;
«Member`s Point» - the number of points of the selected type available with the customer;
«Pay by Points» - the flag of payment for the product using the selected type of points.

Add the "Select Point Type" button displaying and save the settings for "Products Related Lists" with the "OK" button.

Save the "Opportunity Page Layout" settings with the "Save" button.

If the "Discount" field is not displayed in "Products Related Lists", it is necessary to configure access to this field for the profiles whose users will be working with the application. Go to the "Opportunity Product Fields" screen and click the hyperlink in the "Discount" field.

On the "Discount" field properties screen click the "Set Field-Level Security" button.

Set the "Visible" and "Read-Only" attributes for the profiles required by the users and save changes with the "Save" button.

Configuration of the functionality of work with the order

Go to «Order Page Layout». To the "Order Detail" section, add the "Loyalty Program" field and the "Refresh Data" button.

Go to the «Products Related Lists» settings.

Add the following fields to the displayed ones:
«Discount» - amount of discount;
«Point Type» - the type of points selected for payment of the product;
«Total Point Price» - the total price of points of the selected type required for the purchase of the product;
«Total Point Pay» - the total amount of money funds required for the purchase of the product;
«Member`s Point» - the number of points of the selected type available with the customer;
«Pay by Points» - the flag of payment for the product using the selected type of points;
«Total Price With Discount» - the total amount of money funds required for the purchase of the product, taking into consideration the discount accrued.

Add the "Select Point Type" button displaying and save the settings for "Products Related Lists" with the "OK" button.

Save the «Order Page Layout» settings with the «Save» button.

A loyalty program creation

Go to the "Loy Programs" tab and click the "New" button.

Specify the name of the loyalty program being created and save the entry with the “Save” button.

Follow the hyperlink in the field with the name of the loyalty program created.

To create a new loyalty program rule, click the “New Loy Rule” button in the “Loy Rules” section.

In the “Rule” section, fill in the following attributes for the rule being created:
«Rule Name» - the name of the rule;
«Criteria Logic» - the type of logic being used for the combination of the rule criteria;
«Criteria Custom Logic» - not used (for further development of the functional);
«Active» - the flag of activity of the rule (the rule is used provided that this flag is set);
«Start Date» - the rule start date;
«End Date» - the rule end date;
«Description» - rule description.
The attributes "Start Date" and "End Date" determine the validity period of the active rule (i.e. the rule with the "Active" flag set).

In the "Criteria" section, with the "Add Criteria" button, create the required criteria for application of the rule and fill in the following attributes:
«Object» - the object whose fields will be used in the criterion;
«Object Field» - the object field name given by the "Object" attribute;
«Condition» - the type of relation between the attributes being compared;
«Match Object» - the object for comparison whose fields will be used in the criterion;
«Match Object Field» - the name of the object field for the comparison given by the "Match Object" attribute;
«Operator» - the operator being used to complete operations on the "Match Object Field" and "Value" attributes;
«Value» - the numeric value which is used as an operand in the operation with the "Match Object Field" attribute (if this attribute is not given, this value is used to be compared with the "Object Field" attribute).
The screenshot example shows that the given criterion works as follows: if the value in the "Amount" field (purchase amount) of the "Loy Transaction" object (transaction) is greater than "0", then apply the actions specified in the rule.

In the "Actions" section, with the "Add Action" button create the required actions (which should be performed if the set of rule criteria is satisfied) and fill in the following attributes:
«Type» - the type of action (possible values: “Update Attribute”, “Upgrade Tier”);
The “Upgrade Tier” value is not used (further development of the functional).
«Action» - action (possible values: "Assign" - appoint, "Increment" - increase);
«Target Object» - the target object whose fields will be used;
«Target Field» - the object field name given by the "Target Object" attribute;
«Source Object» - the source object whose fields will be used;
«Source Field» - the object field name given by the "Source Object" attribute;
«Operator» - the operator being used to complete operations on the "Source Field" and "Value" attributes;
«Value» - the numeric value which is used as an operand in the operation with the "Source Field" attribute (if this attribute is not given, this value is used in the operation (given by the "Action" attribute) with the "Target Field" attribute).
The screenshot example shows that the given actions work as follows:
- increase the value in the "Accrued Points 1" field (the number of points of the 1st type) of the "Loy Transaction" object (transaction) by the amount equal to the result of division of the value in the " Amount " (purchase sum) field (purchase amount) of the "Loy Transaction" object (transaction) to "100";
- increase the value in the "Accrued Points 2" field (the number of points of the 2nd type) of the "Loy Transaction" object (transaction) by the amount equal to the result of division of the value in the " Amount " field (purchase sum) of the "Loy Transaction" object (transaction) by "10";
- increase the value in the "Accrued Points 3" field (the number of points of the 3rd type) of the "Loy Transaction" object (transaction) by the amount equal to the result of division of the value in the " Amount " field (purchase sum) of the "Loy Transaction" object (transaction) by "200";
- increase the value in the "Accrued Points 4" field (the number of points of the 4rth type) of the "Loy Transaction" object (transaction) by the amount equal to the result of division of the value in the " Amount " field (purchase sum) of the "Loy Transaction" object (transaction) by "20";

Description of the types of points and their determination for the loyalty program will be specified in this document below.
To save the created rule click the "Save" button.

The loyalty program members creation

Go to the “Loy Member” tab and click the “New” button.

Specify the loyalty program, account and the date of joining for the new member. If necessary, it is possible to specify the starting number of each type of the points. Then save the entry with the "Save" button.

The loyalty program points types creation

Click the "Loy Points" tab and click the "New" button.

Fill in the following attributes:
«Name» - points type name;
«Program» - the loyalty program for which this type of points is being created;
«Description» - points type description;
«Qualifying Flag» - the flag that this type of points is "qualified" (i.e. is taken into consideration when determining the level of the user in the loyalty program);
«Active» - the flag of activity of the type of points (the application uses in its work only the active types of points);
«Field to Use» - an identifier determining the field on the object of the member (Loy Member) and transaction (Loy Transaction) being used to store the number of accrued points of this type. For example, if the value "1" is specified, the "Points 1" field of the object of the member and the "Accrued Points 1" field of the transaction object will be used to store this type of points. It is impossible to use the same identifier for the different types of points (the restriction is controlled by the application). The application supports up to 4 different types of scores;
«Expire Points» - the flag of availability of the validity period of this type of points (if the points expire, they will be dissolved). This flag is applied only to the non-qualified types of points. For the qualified points, a similar flag, placed on the member level object is used (Loy Tier) and will be described below;
«Points Expire Period» - the validity period of the type of points;
«Points Expire UoM» - a measuring unit for determination of the validity period of the type of points specified in the "Points Expire Period" attribute (possible values: "Months", "Years").
Save the created entry with the "Save" button.

The screenshot example below shows where the maximum number of (4-re) different types of points is created. Two of them ("Point 1" and "Point 3") are qualified, and two more ("Point 2" and "Point 4") are non-qualified and have a validity period (6 months and 1 year respectively). The non-qualified types of points are not involved into the formation of the user level in the loyalty program, but can be used by the member to purchase promotional products (this will be described below). The qualified types of points are used exclusively for the formation of the member level and cannot be used to purchase promotional products.

Creation of the loyalty program member levels

Go to the "Loy Tiers" tab and click the "New" button.

Fill in the following attributes:
«Name» - member level name;
«Program» - the loyalty program for which this type of points is being created;
«Description» - member level description;
«Expire Points» - the flag of availability of the validity period of the qualified points accrued to the member at this level (if the points expire, they will be dissolved);
«Points Expire Period» - «Months», «Years»); the validity period of the qualified types of points accrued to the member at this level;
«Points Expire UoM» - a measuring unit for determination of the validity period of the type of points specified in the "Points Expire Period" attribute (possible values: "Months", "Years");
«Lower End Of The Range» - the lower limit of the level range (the value is included in the range);
«Upper Limit Of The Range» - the upper limit of the level range (the value is excluded from the range);
The ranges of different levels within the single loyalty program should not overlap (this condition is controlled by the application).
«Discount» - the amount of discount provided for the member at this level.
Save the created entry of the member level with the "Save" button.

The screenshot below shows one of the possible examples of organization of the levels structure of the loyalty program member.

To provide correct operation of the functional, there should be no gaps between the levels within the single loyalty program.

Loyalty program promotional offers setting