Skip to main content

Loyalty Program Grade System

General Information​

In the Sailplay platform, you can configure a multi-level system of loyalty program grades (levels), which allow for building long-term client motivation and managing their behavior not only through one-off promotions but also through a clear progress system. The task of integration in this case consists only of transmitting all the data necessary for progress calculation (mainly purchases).

All configured preference promotions (discount or increased cashback) on the Sailplay side for each status will work automatically (if other conditions are met) based on the client's status tag (promotions are configured at the stage of dashboard preparation and setting up all necessary mechanics).

Statuses with Discounts​

In this type of loyalty program, the client status provides a direct benefit in the form of a discount on products or product categories. The discount size and conditions for its application are configured in promotional mechanics and can depend on the status level, department, product category, or other parameters. This approach is well-suited for simple and understandable motivation mechanics where the client immediately sees a reduced price and feels the benefit at the time of purchase.

Statuses with Increased Cashback​

In this variant, the client status affects the bonus points accrual coefficient, increasing the cashback percentage from purchases. The higher the status, the more bonuses the client receives for the same purchase. Accrual occurs according to a standard coefficient multiplied by the status multiplier, and the final benefit manifests in the accumulation of points that the client can use later to pay for purchases or receive gifts.

Retrieving Client Status​

The client status (loyalty program grade) for ease of integration is stored in the client profile and calculated automatically on the Sailplay side. Depending on the chosen architecture, the status may also be recorded in a client attribute or a client tag.

Retrieving Status via Client Attribute​

The most universal and recommended way is storing the status in a client attribute (e.g., grade).

To retrieve the attribute value, use the method:

/api/v2/users/attributes/get-values-by-user/

Mandatory Request Parameters​

  • store_department_id — department identifier obtained from the Sailplay manager
  • token — token obtained during authorization
  • user_phone (or other client identifier) — client identifier
  • attributes — names of attributes to be retrieved

Example: retrieving client status via the grade attribute.

Retrieving Status via Tags​

An alternative way is using status tags. This option is more often used for displaying status in the user interface or when working with segmentation.

To retrieve client tags, use the method for getting a list of tags, passing a set of possible statuses (grade names are given as an example):

&tags=["Silver","Gold","Platinum","VIP"]

In the response, the presence of a specific tag for the client indicates their current status.