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.Documentation Index
Fetch the complete documentation index at: https://docs.gameball.co/llms.txt
Use this file to discover all available pages before exploring further.
How to Configure Eligible Orders
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.Choose an Operator and Value
Select the appropriate operator and enter your target value (e.g.,
total_price greater than 50).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
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:Available Operators
| Operator | Description |
|---|---|
| Equals | Exact match |
| Not Equals | Excludes exact match |
| Contains | Value includes the specified string |
| Does Not Contain | Value excludes the specified string |
| Starts With | Value begins with the specified string |
| Ends With | Value ends with the specified string |
| Is Empty | Field has no value |
| Is Not Empty | Field has a value |
| Greater Than | Numeric value above threshold |
| Greater Than or Equal To | Numeric value at or above threshold |
| Less Than | Numeric value below threshold |
| Less Than or Equal To | Numeric value at or below threshold |
| Exists | Field is present in the order data |
| Does Not Exist | Field is absent from the order data |
| Between | Numeric 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.
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
| Goal | Rule |
|---|---|
| Reward orders above a minimum value | total_price greater than 50 |
| Reward only online orders, not POS | channel_type equals online |
| Exclude a specific collection | Use exclusion mode, collection_id equals [collection] |
| Reward a specific payment method | payment_method equals paypal |
| Target a product category | product_category equals electronics |
| Target specific products by SKU | sku equals one or more SKU values (upload via CSV for bulk) |
| Exclude discounted items | Use exclusion mode, product_id, sku, or product_category equals the discounted product identifier |
| Exclude gift card purchases (Shopify) | Use exclusion mode, product_id or sku equals the gift card’s product ID — works when gift cards are listed as products in Shopify |
Related Articles
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.