Skip to main content

Understanding Loyalty Points Calculations and Rules in Gameball

Learn how Gameball prioritizes and applies different types of loyalty points configurations to reward your customers.

Ganna Adnan avatar
Written by Ganna Adnan
Updated over a week ago

Platform

Plan

Shopify

Free, Starter, Pro, & Guru

Salla

Starter, Pro, & Guru

Non-platform clients

Growth & Enterprise


Gameball provides several loyalty points earning configurations, each with specific conditions and priority rules. This ensures customers earn the correct amount of points based on their level, the collection or merchant they are purchasing from, and any active campaigns.

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


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


Loyalty Points Earning per Level

This rule overrides the default earning rate. When a customer qualifies for a level-based earning configuration, points will be granted according to their level rate.

Note: If an item has custom loyalty points for a collection or merchant, this rule is ignored.

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

In this case, the customer earns 2 points per $1 based on their level.


Custom Loyalty Points Earning per Collection or Merchant

This rule takes precedence over both the default rate and level-based earning.

If an item belongs to multiple collections, the system compares all configured values and applies the highest.

Example:

Collection Name

Custom Loyalty Points Earning Per Collection/Merchant

Collection Breakfast

4 pts

Collection Cheese

2 pts

Points Earned

4 pts

If an item belongs to both collections, the customer receives the highest value (4 pts).


Custom Loyalty Points per Level per Collection or Merchant

This rule overrides all previous configurations. Gameball compares the loyalty points set at the collection or merchant level with the customer level, and the higher value is applied.

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

In this case, 6 points are awarded based on the highest applicable rule.


Multiplier Campaign

Multiplier campaigns are applied after all earning rules. Learn more.

The system calculates points per item and then applies the multiplier, rounding down the result per item before summing..

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 an item is affected by two multiplier campaigns, Gameball will apply the one with 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 purchases an item from the Cheese collection, the 5x multiplier will be applied.


Refund Rules

Partial Refunds:

Gameball deducts points proportionally based on the refunded item's value.

Example:
If an item worth $12.50 is refunded, 12 points will be deducted.

Full Refunds:


​All points earned from the order will be removed, including points from campaigns.

Important:
To correctly deduct both base and campaign points, the product ID and quantity must be submitted during the refund process. If this data is not provided, Gameball will only deduct the base points value.


General Notes

  • Orders with custom loyalty points must be submitted using the Order API.

  • Include all line items with details like price, taxes, discounts, and points values.

  • If not applicable, these values must be set to β€œ0”.

  • Shipping rewards follow the same rules as general, campaign, or level-based rewards. However, shipping refunds are not supported.

  • If the returned item is the last item in the order, all points (except shipping) will be deducted.


Related Articles:

Did this answer your question?