Referrals Module on React Native

Configure the referral module on your React native app using Firebase. This module allow users or players to refer others with a referral link and gain points.

Configure Gameball With Your Firebase

Before you start, you must configure your Firebase on your Gameball account. Follow the steps in Configure your Firebase account on Gameball for mobile friends referral links article in our Help Center to configure your Firebase account on Gameball.

Integration Details

For dynamic links you can use react-native firebase package and follow the steps of dynamic links initialization. To get the initial link that is used to start the app, use:

 let initialLink = await firebase.links().getInitialLink();

If there is a link, call the getReferralCode function and pass the URL as a parameter:

let referralCode = GameballSdk.getReferralCode(initialLink);

After this, call addReferral function:

GameballSdk.addReferral({
      "playerCode": referralCode,
      "playerUniqueId": playerId,
      "deviceToken": await AsyncStorage.getItem('push_token'),
      "osType": Platform.OS === 'ios' ? 'ios' : 'android',
      "playerAttributes": {
        "displayName": displayName,
        "email": email,
        "gender": gender,
        "mobileNumber": mobileNumber,
        "dateOfBirth": dateOfBirth,
        "joinDate": new Date(),
      }
    })).then(response => console.log(response))  // on success
    .catch(error => console.log(error)) // on error

Parameter	Required	Description	Type
playerCode	Required	referralCode extracted from the link	String
playerUniqueId	Required	player ID is a unique ID for you user. (eg. user email, UUID,.. etc.). The playerId is to be provided by the client and must be unique for each user.	String
playerTypeId	Optional	Each player type has an ID	Integer
playerAttributes	Optional	PlayerAttributes is a builder class which is used to add or update your player info to Gameball. Player object is described in Object Reference section.	Object
deviceToken	Optional	Mobile device token used for push notifications	String
osType	Optional	Operating system of the device running the application	String

Now, referral links will be generated successfully for your players!