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, sku).When SKU is selected as the condition field, an Upload CSV option appears alongside the text input. Upload a CSV file to populate multiple SKUs at once instead of typing them individually. SKUs are automatically added to the field after upload and remain editable. CSV uploads support up to 100 SKUs per file.
CSV upload option for SKU conditions
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:
For line-item attributes, the path starts directly from the extra field without additional nesting.

​
Available Operators

​
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. Shopify merchants can use this to exclude specific types of purchases:
  • Discounted items: If discounted products are identifiable by a product ID, SKU, or product category, use exclusion mode with the corresponding attribute to prevent points from being awarded on those purchases.
  • Gift card purchases: If gift cards are listed as products in your Shopify store, you can exclude them by targeting their product ID or SKU in exclusion mode.
Gameball does not automatically detect discounts or gift cards — exclusions work by matching order attributes you define. Make sure the products you want to exclude are identifiable by a consistent attribute (e.g., a specific SKU, product ID, or category).

​
Common Examples

Launch and Configure Your Earn Pointing System

Set up your base earn rule and pointing system configuration.

Understanding Loyalty Points Calculations

Learn how Gameball prioritizes and calculates points across different rules.