| Platform | Plan |
|---|---|
| Shopify | Free, Starter, Pro & Guru |
| Salla | Starter, Pro & Guru |
| Non-platform Clients | Growth & Enterprise |
Step-by-Step Instructions
Activate the Earn Pointing System
- Log in to the Gameball dashboard.
- From the left-side menu, click Loyalty Points.
- Choose Earn, and you will be directed to the Earn Pointing System configuration page.
- Locate the activation toggle at the upper right section of the page and switch it to Active.
Configure the Earn Rule
Click Edit in the Earn Rule section, then set the number of points customers will earn based on a specific amount of spending.
If you use score as your tiering-up method, you will see an additional field to assign the score customers will earn per amount spent. Learn more about Score.
Merchant Rules
Set custom earning and redemption rules per merchant or brand, based on your business needs.
Collection Rules
Customize how customers earn points based on product collections. For example, you can assign different earning rates for specific categories or exclude others entirely.
Settings
Include or Exclude Shipping Fee
Decide whether to include the shipping fee in the points calculation. For example, if a customer places an order worth USD 100 with a USD 15 shipping fee, they can either receive points on just the USD 100 or on the full USD 115.
Points Expiry
Define when earned points will expire:- Choose the expiry duration.
- Select the duration type (days, months, or years).
How does Points Expiry Work?
How does Points Expiry Work?
When setting a customer duration for point expiry to 3 days for example, from a Reward Campaign, the points will expire exactly 72 hours after the earning time. Gameball does not round up or down to the nearest day; instead, it calculates the exact time based on the specified duration.
Eligible Collections
Select which products or collections qualify for earning points. Choose from:- All Products
- Selected Collection
- All Products except some collections
Return Window Duration
Specify a time gap between when an order is placed and when points are issued. This helps manage potential product returns and ensures proper point issuance.
Cashback Return Window API
You can now control when cashback points become active using thereturnWindow attribute.
Available in:
- Order API: under
cashbackConfigurations - Cashback API: under
configurations
returnWindowaccepts values from 0 to 7300 days.- Points remain pending for the set duration, then activate automatically.
- If not provided, the default duration from your Gameball settings applies.
Insights and Analytics
Access in-depth analytics on how your Earn Points System is performing: Total Earned Rewards- Track the overall value of rewards customers have earned.
- Monitor how reward trends evolve over time.
- View the total number of points issued across transactions.
- Analyze how points are distributed and identify areas for optimization.
Common Questions
What happens if a customer returns a product after earning points?
What happens if a customer returns a product after earning points?
Use the Return Window Duration setting to delay point issuance, helping avoid rewarding points for refunded purchases.
Can I create different earn rules for different products?
Can I create different earn rules for different products?
Yes, use the Collection Rules feature to customize earning by product categories.
Can I have an order-level return window?
Can I have an order-level return window?
Yes, you can set a return window at the order level.To do this, include the
returnWindow attribute inside the cashbackConfigurations object when creating the order using the Order API. This allows you to specify a custom return window per order — for example, 7 days for Order A and 10 days for Order B.If returnWindow is not set in the API request, the default duration from your Gameball settings will apply.