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.