Skip to main content
Gameball lets you define exactly which orders qualify for points earning. Rather than rewarding all orders equally, you can build rules based on any order attribute — such as price, payment method, product category, or custom metadata.

How to Configure Eligible Orders

1

Navigate to Earn Points

Go to Programs > Earn Points in your Gameball dashboard.
2

Open Settings

Click Settings, then find the Earn Points Applies On section.
3

Add a Rule

Click Add Rule and choose the order attribute you want to filter by (e.g., total_price, payment_method, product_category).
4

Choose an Operator and Value

Select the appropriate operator and enter your target value (e.g., total_price greater than 50).
5

Save

Click Save to apply the rule.

Extra Attributes

Beyond standard fields like product names and SKUs, you can use custom order data for more advanced targeting:
  • Payment methods (e.g., reward only credit card orders)
  • Regional zones or store locations
  • Subscription tier or membership level
  • Product classifications or custom tags
These can be passed via the Order API inside the order metadata.

Understanding the Path Field

For nested attributes, use dot notation to navigate to the value you need. Example: To target a specific card type within a payment method:
payment_methods.credit_card.card_type
For line-item attributes, the path starts directly from the extra field without additional nesting.

Available Operators

OperatorDescription
EqualsExact match
Not EqualsExcludes exact match
ContainsValue includes the specified string
Does Not ContainValue excludes the specified string
Starts WithValue begins with the specified string
Ends WithValue ends with the specified string
Is EmptyField has no value
Is Not EmptyField has a value
Greater ThanNumeric value above threshold
Greater Than or Equal ToNumeric value at or above threshold
Less ThanNumeric value below threshold
Less Than or Equal ToNumeric value at or below threshold
ExistsField is present in the order data
Does Not ExistField is absent from the order data
BetweenNumeric value falls within a defined range

Combining Multiple Conditions

You can combine multiple attribute rules using AND or OR logic:
  • AND: All conditions must be true for the order to qualify.
  • OR: Any one condition being true makes the order eligible.
Example: Reward only orders where total_price > 50 AND payment_method = credit_card.

Rewarding All Orders Except Certain Ones

To reward all orders except those matching specific conditions, choose the “All except some attributes” option. This inverts your rule — all orders qualify unless they match the defined exclusion criteria.

Common Examples

GoalRule
Reward orders above a minimum valuetotal_price greater than 50
Reward only online orders, not POSchannel_type equals online
Exclude a specific collectionUse exclusion mode, collection_id equals [collection]
Reward a specific payment methodpayment_method equals paypal
Target a product categoryproduct_category equals electronics