Skip to main content

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.

Rewarding customers is a key strategy to gamify their experience and foster loyalty. Gameball offers a variety of reward types that enable you to incentivize your customers effectively, whether they complete a specific campaign or redeem rewards for points they’ve collected.
Reward types overview

​
Types of Rewards Offered by Gameball

Gameball provides several reward types across various platforms, each designed to enhance the customer experience.
Reward TypeSubcategoriesPlatform
Online Only RewardsPoints, Free Product, Free Shipping, Fixed Amount-based Discount (Available in Dynamic mode), Percentage-based Discount, Custom Rewards (Third-party), External Reward, Coupon Engine Rewards (Third-party redemption, External Reward API call, Percentage-based cashback coupon, Fixed Amount-based cashback coupon, Percentage-based fee discount)All platforms
POS RewardsPOS Fixed Amount-based Discount, POS Percentage-based DiscountShopify
Shopify-Specific RewardsStore Credit, Recharge Fixed Amount-based Discount, Recharge Percentage-based DiscountShopify
Recharge RewardsFixed Amount-based Discount, Percentage-based DiscountShopify - Recharge Subscription Users

​
Setting Up Each Reward Type

This reward is available as a campaign reward only.
PlatformPlan
AllAll
  • Add Points: Specify the number of points to award customers.
  • Tiering Up Method: If you are using Gameball’s score feature for tiering, you can reward customers with scores in addition to points. Learn more about Score.
  • Points Expiry Options:
    • Default Expiry: Uses the platform’s default points expiration setting. Learn how to configure your default expiry settings
    • Custom Expiry: Override the default by setting a specific expiration for that particular reward.
      • Duration Type: Choose from Days, Months, or Years.
      • Duration: Define the duration based on the selected type.
Points reward configuration
This reward is available as a campaign reward as well as a redemption option.
PlatformPlan
AllAll except for free plans
Reward Campaign:
  • Reward Image: Select the product’s image.
    Free product image selection
  • Advanced Options:
    • Prefix: Add Coupon Prefix.
    • Reward expires after a specific amount of time: Set the expiry for the reward.
    • Minimum purchase amount: The amount required for usage. (Default: 1)
    • Reward combined with other coupons: Compatibility with other coupons or to be won alongside other coupons.
    • Show “How to redeem” instructions.
Free product advanced options
Custom Redemption Rule:
  • Follow the same steps as the Reward Campaign setup.
  • Add the points needed to redeem this reward in the Redemption Value section.
Free product redemption rule
How free product coupons work at checkout: Gameball does not automatically add the free product to the customer’s cart. The customer must manually add the product to their cart first, then apply the coupon code. The coupon applies a 100% discount on that product, making it free.
This reward is available as a campaign reward as well as a redemption option.
PlatformPlan
AllAll except for free plans
Reward Campaign:
  • Reward Name: Choose a name for the reward.
  • Reward Image: Choose to have the default or upload an image for display.
  • Advanced Options:
    • Prefix: Add Coupon Prefix.
    • Reward expires after a specific amount of time: Set the expiry for the reward.
    • Minimum purchase amount: The amount required for usage. (Default: 1)
    • Reward combined with other coupons: Compatibility with other coupons, or to be won alongside other coupons.
    • Show “How to redeem” instructions.
Free shipping reward configuration
Custom Redemption Rule:
  • Follow the same steps as the Reward Campaign setup.
  • Add the points needed to redeem this reward in the Redemption Value section.
Free shipping redemption rule
This reward is available as a campaign reward as well as a redemption option.
PlatformPlan
AllAll
Reward Campaign:
  • Reward Image: Choose an image.
  • Reward Value: Set the value (e.g., $100).
  • Applicability: Specify if it applies to all purchases or specific Collections and/or specific Merchants.
  • Advanced Options:
    • Prefix: Add Coupon Prefix.
    • Reward expires after a specific amount of time: Set the expiry for the reward.
    • Minimum purchase amount: The amount required for usage. (Default: 1)
    • Reward combined with other coupons: Compatibility with other coupons, or to be won alongside other coupons.
    • Show “How to redeem” instructions.
Amount-based discount configuration
Custom Redemption Rule:
  • Follow the same steps as the Reward Campaign setup.
  • Add the points needed to redeem this reward in the Redemption Value section.
Amount-based discount redemption rule
This reward is available as a campaign reward as well as a redemption option.
PlatformPlan
AllAll
Reward Campaign:
  • Reward Image: Choose an image.
  • Discount Value: Set the discount (e.g., 20% off).
  • Applicability: Specify if it applies to all purchases or specific Collections and/or specific Merchants.
  • Advanced Options:
    • Prefix: Add Coupon Prefix.
    • Reward expires after a specific amount of time: Set the expiry for the reward.
    • Minimum purchase amount: The amount required for usage. (Default: 1)
    • Reward combined with other coupons: Compatibility with other coupons, or to be won alongside other coupons.
    • Show “How to redeem” instructions.
Percentage-based discount configuration
Custom Redemption Rule:
  • Follow the same steps as the Reward Campaign setup.
  • Add the points needed to redeem this reward in the Redemption Value section.
Percentage-based discount redemption rule
This reward is available as a campaign reward only.
PlatformPlan
Shopify onlyStarter, Pro and Guru (Newly enrolled)
Reward Campaign:
  • Credit Value: Set the Credit value (e.g., $100).
  • Bonus Expiry: Set a specific expiry for this reward, overriding the default expiry.
Store credit configuration
To reward your customers with store credit, you need to complete the following steps:
1

Enable Shopify store credit feature

Enable the Shopify store credit feature and Shopify new accounts from Shopify’s Customer Accounts Settings.
Shopify store credit settings
2

Grant Gameball permission

Grant Gameball permission to use Shopify’s store credit APIs.

​
Dynamic Value for “Fixed Coupon Rewards”

Fixed Coupon Rewards has a Dynamic Value option. Instead of being limited to a static reward (e.g., 10off),youcannowconfigurefixedcouponstodynamicallycalculatetheirvaluebasedonapercentageofachosenvariable(e.g.,∗∗1510 off), you can now configure fixed coupons to dynamically calculate their value based on a percentage of a chosen variable (e.g., **15% of Value X**). In short, instead of always giving 10 off, a merchant can now set the coupon to equal 15% of the customer’s cart total or a specific metadata value, making offers more personalized and impactful.
Dynamic value configuration

Static Fixed Value

Configure a fixed coupon with a specific value (e.g., $10 off) that never changes.

Dynamic Value

Set the coupon to calculate dynamically as a percentage of a chosen metric, such as the cart total or an order value.
No changes are required in your workflow when switching to dynamic mode — just configure the value type when setting up your fixed coupon rewards. Offers adapt to cart totals, order values, or metadata-driven actions automatically.

​
Extra Reward Types

In addition to the online rewards, Gameball supports special rewards for Shopify POS systems and Recharge-enabled subscriptions.
This reward is available as a redemption option only.
Read about how to Enable Customers to Spend Their Gameball Points on Shopify POS.
PlatformPlan
ShopifyAll
SallaStarter, Pro, Guru
Non-platformContact Support
  • POS Amount-based Discount: Reward customers with a fixed discount (e.g., $10 off) when they purchase in-store.
  • POS Percentage-based Discount: Offer a percentage discount (e.g., 10% off) for in-store purchases.
POS rewards configuration
Setting up these rewards follows the same steps as the online rewards, ensuring you have integrated your POS system with Gameball.
  • Recharge Amount-based Discount: Provide customers with a fixed discount on their Recharge subscription orders.
  • Recharge Percentage-based Discount: Offer a percentage discount on recurring Recharge subscription orders.
Recharge rewards configuration
Both Recharge rewards work similarly to the online discount rewards but require your store to be integrated with Recharge for subscriptions.

​
Customizing Your Reward Campaign

Learn how to set up a customized reward campaign. For all rewards, you can adjust the following advanced options to suit your business needs:
  • Prefix: Add Coupon Prefix.
  • Reward expires after a specific amount of time: Set the expiry for the reward.
  • Minimum purchase amount: The amount required for usage. (Default: 1)
  • Reward combined with other coupons: Compatibility with other coupons or to be won alongside other coupons.
  • Show “How to redeem” instructions.
Ensure your coupon configuration is compatible with the reward type and platform.
  • A “Check Coupons Details” button will be displayed on the success screen of any game only if the reward type is a coupon.
  • The button will not appear for any other reward types (e.g., points, badges, items).
  • When the player clicks “Check Coupons Details”, they will be redirected to the Coupon Details Page inside the widget.

Create an Action-Based Reward Campaign

Build a reward campaign triggered by specific customer actions from scratch.

Create a Time-Based Reward Campaign

Set up a reward campaign that fires on a scheduled date or instantly.

Setting Custom Ways to Redeem Points

Configure custom redemption rules so customers can exchange points for specific rewards.