Platform | Plan |
Shopify | Pro & Guru |
Salla | Pro & Guru |
Non-platform clients | Enterprise |
Gameball allows you to choose which orders customers will earn points on through custom data sent with your orders.
Instructions to Set Which Orders your Earning Rule Applies to:
Follow the steps below:
From your Gameball Dashboard, go to Programs > Earn Points > Settings > Earn Points Applies On.
Rule > Selected Attributes
For example, to reward only customers who pay more than 50, set:
Attribute: Total Price
Operator: Greater than
Value: 50
Click Save to activate your earning rule.
Customers who place an order matching your condition will now automatically earn rewards based on the rule you configured.
You Can Also Select 'Extra Attributes'
Standard order data includes information like total amount, product names, SKUs, and categories. Extra Attributes are additional custom fields attached to an order or a line item, giving you the flexibility to control earning rules around any data your business sends.
Here are some common examples:
Payment method (credit card, cash, gift card) — Award bonus points when customers pay with a specific card.
Store region or zone — Run region-specific reward campaigns.
Subscription tier (Gold, Silver) — Give extra rewards to premium subscribers.
Custom product classification — Target specific product sub-classes for rewards.
This means you can allow customers to only earn points based on business-specific detail such as payment method, membership tier, store region, or custom product classifications, going beyond the standard order fields.
Follow the steps above
In the Where dropdown, select Extra.
Fill in the following three fields:
Path — The dot-notation path to the attribute inside the extra object.
Operator — How to compare the value (e.g., Contains, Equals, Greater Than).
Value — The expected value to match.
Note: You can add multiple conditions to a single earning rule to create more targeted campaigns. For example, combine a channel condition with a payment method condition to reward only web orders paid by credit card.
Understanding the Path Field
The Path tells Gameball where to find the value inside the extra data. It uses dot-notation to navigate through nested fields — think of it like a folder structure.
For example, if your order data includes:
extra
└── payment_methods
└── creadit_card
└── card_type → "Platinum Card"
The path would be: payment_methods.creadit_card.card_type
If the extra attribute is on a line item (not the order level), the path starts directly from the line item's extra field. For example, a line item with "extra": { "subClass": "SUBCLASS123" } would simply use the path: subClass
Tip: To check for multiple values in a single condition, separate them with a comma. For example, entering Platinum Card, Visa as the value will match orders containing either of those card types.
Available Operators
When setting up your condition, you can choose from the following operators:
Equals — Matches an exact value. Example: Channel equals
web.Not Equals — Matches anything except the specified value. Example: Channel not equals
pos.Contains — Checks if the value exists within the field. Example: Card type contains
Platinum Card.Not Contains — Checks that the value is not present. Example: Card type not contains
Gift Card.Greater Than — Value is above the specified number. Example: Amount greater than
100.Greater Than or Equal — Value is at or above the specified number. Example: Amount greater than or equal
200.Less Than — Value is below the specified number. Example: Discount less than
50.Less Than or Equal — Value is at or below the specified number. Example: Discount less than or equal
30.Exists — Checks that the field exists and has any value. Example: Credit card payment exists.
Not Exists — Checks that the field does not exist. Example: Gift card payment not exists.
Between — Checks if a number falls within a range. Example: Total paid between
100, 500.
Common Examples
Reward orders paid with a gift card
Set up a condition to trigger whenever a gift card was used for any amount:
Path:
payment_methods.gift_card.amountOperator: Greater Than
Value:
0
Reward orders with a specific product sub-class
Target a custom product classification at the line-item level:
Path:
subClassOperator: Equals
Value:
SUBCLASS123
Reward web orders paid by credit card
Combine two conditions on the same rule:
Condition 1: Channel — Equals —
webCondition 2: Extra path
payment_methods.creadit_card— Exists
This rewards customers who order through the web channel and pay with a credit card.
Common Questions
How do I know what extra attributes are available?
Your development team defines and sends extra attributes with each order. Ask them for the full list of available attributes and their paths so you can use them when configuring your earning rules.
Can I combine multiple extra attribute conditions?
Yes. You can add multiple conditions to a single earning rule using AND/OR logic. This lets you create highly targeted campaigns, for example, rewarding only customers in a specific region who pay with a particular card type.
Selecting All Orders to be Eligible Except Certain Ones
If you're looking to give points to all orders except specific ones, you can do the following:
Go to Programs > Earn Points > Settings > Earn Points Applies On.
Rule > All except some attributes
For example, you can choose that all orders allow customers to earn points except for orders from a specific collection. If a customer purchases from collection x, they don't earn points on that purchase.
