Skip to main content
All CollectionsLoyalty Points: Earn
Understanding Loyalty Points Calculations and Rules in Gameball
Understanding Loyalty Points Calculations and Rules in Gameball

A guide to how Loyalty Points is calculated based on different rules and conditions within the Gameball system.

Ganna Adnan avatar
Written by Ganna Adnan
Updated over 2 months ago

At Gameball, we offer several types of Loyalty Points configurations to reward customers for their purchases. Each type of Loyalty Points operates under specific rules, ensuring that the correct number of points is awarded depending on the scenario.

Loyalty Points Rules Overview:

  1. Default Loyalty Points Earning

  2. Loyalty Points Earning per Level

  3. Custom Loyalty Points Earning Per Collection/Merchant

  4. Custom Loyalty Points Earning per Level per Collection/Merchant

  5. Points Multiplier Campaign (Whole order or Specific Collection/SKU/Branch/Merchant)

!Note: Custom Loyalty points per merchant cannot be used in combination with custom loyalty points per collection.

Rule #1: Default Loyalty Points Earning

This is the basic Loyalty points earning rule that applies if no other rule has been set up. If no specific configurations are in place for collections, merchants, or levels, the system will apply the default Loyalty Points earning rate. Learn More

Example:

Loyalty Points Earning Type

Default Loyalty Points Earning

Value

1 pts

Points Earned

1 pts per $1

Rule #2: Loyalty Points Earning per Level

This rule overrides the Default Loyalty Points earning (Rule #1).

  • If a user qualifies for a Loyalty Points earning per level, we will apply the Loyalty Points per level instead of the default rate. Learn More

  • If the default Loyalty Points earning is higher than the level-based Loyalty Points earning, the system will still apply the level-based Loyalty Points.

  • Note: This rule is not applied if a custom Loyalty Points earning per collection or merchant is configured for the item

Example:

Loyalty Points Earning Type

Points Value

Default Loyalty Points Earning

3 pts

Loyalty Points Earning per Level

2 pts

Points Earned

2 pts per $1

For this case, the customer earns 2 points per $1 due to the level-specific rule.

Rule #3: Custom Loyalty Points Earning Per Collection/Merchant

This rule supersedes both Default Loyalty Points Earning (Rule #1) and Default Loyalty Points Earning per Level (Rule #2).

  • The highest value between the configured points for each collection or merchant will be applied.

  • If an item falls under multiple collections, the system will compare the rules for each collection and apply the higher value.

Example:

Collection Name

Custom Loyalty Points Earning Per Collection/Merchant

Collection Breakfast

4 pts

Collection Cheese

2 pts

Points Earned

4 pts

If a customer purchases an item from Collection Cheese, which falls under both collections, they will earn 4 points, as it is the higher value.

Rule #4: Custom Loyalty Points Earning per Level per Collection/Merchant

This rule takes precedence over other rules when both level-based and custom loyalty points configurations exist for a collection or merchant. The system compares these values and rewards the customer with the higher points value.

Example 1:

Collection

Custom Loyalty Points

Loyalty Points per Level 2

Collection Breakfast

4 pts

6 pts

Collection Cheese

3 pts

2 pts

Points Earned

6 pts from Breakfast & 3 pts from Cheese

In this case, the customer earns 6 points for items in Collection Breakfast and 3 points for items in Collection Cheese, as these are the higher values.

Example 2:

Collection

Custom Loyalty Points

Loyalty Points per Level 2

Collection Breakfast

4 pts

5 pts

Collection Cheese

2 pts

6 pts

Points Earned

6 pts

Here, the customer earns 6 points for items in Collection Cheese, as it offers the highest value among all rules.

Rule #5: Multiplier Campaign

Multiplier campaigns are applied to each item individually after all other rules have been considered. This rule allows you to multiply the earned points by a predefined campaign reward multiplier (e.g., 2x, 3x, 5x). Learn more

For each item under a multiplier campaign, the points are calculated and then floored before being summed with other items.

Example:

Item

Points Before Multiplier

Multiplier

Earned Points

Item 1

2.3 pts

2x

4 pts

Item 2

3.1 pts

3x

9 pts

Points Earned

4 pts (Item 1) + 9 pts (Item 2) = 13 pts

Note: If two multiplier campaigns are applied to the same item, the system will compare the values and apply the higher multiplier.

Example:

Campaign Type

Multiplier

Whole order

3x

Campaign on Collection

5x (on cheese)

Points Earned

Earned points from the first four rules x5

If the customer buys cheese, the earned points will be the value from the first four rules multiplied by 5x (the higher value).

Refund Rules

  1. Partial Refunds:
    For a partial refund, we deduct the points proportionate to the refunded item.

    Example:
    If a user refunds an item worth $12.50, we deduct 12 points.

  2. Full Refunds:
    If an entire order is refunded, the system will deduct all points earned from that order, including any multiplier campaign rewards.

    Important: For refunds, users must send the Product ID and Quantity for each item to properly refund both points and any campaign rewards applied. If this information is missing, only the base points value will be refunded, and no custom points or multiplier campaign values will be considered.

General Notes

  • Orders with custom loyalty points values must use the Order API.

  • Line items, including points/discount values, should be provided for each order.

  • Price, taxes, and discounts must be included per item, or provided as "0" if not applicable.

  • Shipping rewards are based on the general, campaign, or level-based rules. Refunds for shipping points are not supported.

  • If an item is the last one in an order and is returned, the system will deduct all points except shipping points.

Did this answer your question?