Implement Mobile Referrals

Gameball referrals for React Native apps rely on deep links generated by a provider such as Branch or Adjust. These links help identify the referring customer when a new user installs and opens the app.

Firebase Dynamic Links are no longer supported.
Use Branch or Adjust instead.

Setup

Choose a Deep Link Provider

Use Branch or Adjust to generate referral links and handle deep/deferred linking in your React Native app.

Install the Provider SDK

Install Branch or Adjust using their official React Native packages:

# Example for Branch
npm install react-native-branch

# Example for Adjust
npm install @adjust/react-native-adjust

Follow their official documentation for linking and permissions.

Configure Deep Linking

Set up universal links or custom URL schemes depending on your chosen provider.
Refer to Branch or Adjust setup guides for iOS and Android.

Connect Provider in Gameball Dashboard

Go to your Gameball dashboard: Settings → Admin Settings → Integration → Mobile Configuration → Dynamic Link ProviderSelect and configure Branch or Adjust.

Gameball appends a referral code (e.g., ?referrerCode=SARAH123) to each referral link automatically.

Handle Deep Links

After the app is opened via a referral link, your deep linking provider’s SDK will pass the parameters. You need to:

Extract the referrerCode
Store it (e.g., AsyncStorage)
Pass it when calling initializeCustomer

Example with Branch

import branch from 'react-native-branch';
import AsyncStorage from '@react-native-async-storage/async-storage';

useEffect(() => {
  const unsubscribe = branch.subscribe(({ params }) => {
    if (params?.referrerCode) {
      AsyncStorage.setItem('referrerCode', params.referrerCode);
      console.log('Stored referrer code:', params.referrerCode);
    }
  });

  return () => unsubscribe();
}, []);

Example with Adjust

import { Adjust, AdjustConfig } from '@adjust/react-native-adjust';
import { Linking } from 'react-native';

useEffect(() => {
  const config = new AdjustConfig('YOUR_APP_TOKEN', AdjustConfig.ENVIRONMENT_SANDBOX);
  Adjust.create(config);

  Linking.addEventListener('url', (event) => {
    const url = new URL(event.url);
    const referrerCode = url.searchParams.get('referrerCode');
    if (referrerCode) {
      AsyncStorage.setItem('referrerCode', referrerCode);
      console.log('Stored referrer code:', referrerCode);
    }
  });

  return () => Linking.removeAllListeners('url');
}, []);

Register Customer with Referral

When registering a new customer, include the stored referral code if it exists:

import AsyncStorage from '@react-native-async-storage/async-storage';
import { GameballApp, InitializeCustomerRequest } from 'gameball-react-native';

async function registerCustomer() {
  const referrerCode = await AsyncStorage.getItem('referrerCode');

  const request: InitializeCustomerRequest = {
    customerId: 'new-customer-456',
    email: 'newuser@example.com',
    mobile: '+1234567890',
    referralCode: referrerCode ?? undefined,
    customerAttributes: {
      displayName: 'Jane Smith',
    },
  };

  try {
    const response = await GameballApp.getInstance().initializeCustomer(request);
    console.log('Customer registered with referral');
    await AsyncStorage.removeItem('referrerCode');
  } catch (error) {
    console.error('Registration error:', error);
  }
}

Clear the stored referral code after successful registration to avoid applying it again unintentionally.

Customers can view and share their referral link using the built-in Gameball widget. This includes both the code and sharable link. If you’re using a custom UI, contact Gameball support to retrieve referral details via API.

Set up your referral rewards and eligibility criteria inside the Gameball dashboard.

Referral Flow Summary

Referrer Gets a Link

The existing customer retrieves their referral link via the widget or API.

Referrer Shares Link

They share the link through messages, social platforms, or email.

New User Opens Link

The deep link provider opens the app and passes the referral parameters.

App Captures Referrer Code

Your app extracts and stores the referrerCode from the link.

New User Registers

The registration request includes the stored referral code.

Rewards Are Granted

Gameball evaluates your referral conditions and rewards the referrer and the referred user.

Overview

Web & POS Integration

Mobile Integration

How Do I Track Referrals with the React Native SDK (v3)?

Implement Mobile Referrals

Setup

Handle Deep Links

Example with Branch

Example with Adjust

Register Customer with Referral

Display Referral Link (via Widget)

Referral Flow Summary

Next Steps

​Implement Mobile Referrals

​Setup

​Handle Deep Links

​Example with Branch

​Example with Adjust

​Register Customer with Referral

​Display Referral Link (via Widget)

​Referral Flow Summary

​Next Steps

Implement Mobile Referrals

Setup

Handle Deep Links

Example with Branch

Example with Adjust

Register Customer with Referral

Display Referral Link (via Widget)

Referral Flow Summary

Next Steps