Skip to main content
This guide is for SDK v3 which features modern builder patterns, improved type safety, and enhanced performance. If you’re looking for SDK v2 documentation, switch versions using the dropdown above.

What’s New in SDK v3

Builder Pattern API

Modern builder patterns for type-safe configuration and requests

Better Performance

Optimized SDK initialization and reduced memory footprint

Enhanced Type Safety

Stronger compile-time validation and null safety support

Improved Error Handling

Better error messages and callback-based async operations

What you’ll learn

Each platform guide covers the essential integration steps:
  • Getting Started - Install SDK and set up dependencies
  • Initialize SDK - Configure SDK with builder pattern
  • Initialize Customer Profile - Register customers and show profile widget
  • Track Customer Events - Send customer actions and behaviors to Gameball
  • Track Orders & Cashback - Monitor orders and provide cashback rewards
  • Integrate Redemption - Enable customers to redeem their earned points
  • Track Referrals - Implement referral tracking with Firebase Dynamic Links
  • Go-Live Checklist - Ensure everything is ready for production
  • Migration Notes - Migrate from v2 to v3

Prerequisites

Before starting your integration, make sure you have:
  • A Gameball account with API credentials
  • Your application’s development environment set up
  • Basic understanding of your chosen platform’s development workflow
SDK v3 is available for Web, Android, Flutter, and React Native. For iOS, please use SDK v2 until v3 is available.

Migration from v2

If you’re currently using SDK v2 and want to upgrade: