Track Referrals
Reward your players for referrals and grow your business

Overview

Gameball creates a unique referral code for each player created. This helps you build and track referrals program.
The unique code is concatenated with your website URL configured on Gameball dashboard (Click here to learn more) to form the Player Referral Link.
For example if you have configured your website URL to be http://www.myAwesomeWebsite.com the referral link for Player "John Snow" with referral code code123 would be
http://www.myAwesomeWebsite.com?ReferralCode=code123
Your players can then exchange their referral link with their referrals so that they can get rewarded for their referrals if they signed up and fulfill the requirement as configured on your referral program. Every player will be able to find the unique referral link on the referral tab inside Gameball player profile widget
Check this article to learn how the referral module will appear in your players' profile on Gameball widget.

Tracking Referral Signups

When a referral lands on your website with a referral link
http://www.myAwesomeWebsite.com?ReferralCode=code123
You can detect that by checking URL query strings for ReferralCode. If detected, you can then store the ReferralCode value on the user's session or leverage the browser local storage, session storage, or cookies.
Once the guest referral sign-ups, you can then send the ReferralCode along with the sign-up data of the new player via the Create Player API.
Below is a sample API call to create a new player "Aria Stark" that is being referred by Player "John Snow" with referral code code123
1
curl -X POST -H 'apiKey: {{Your_API_Key}}' -d '{
2
"playerUniqueId":"new_player_id",
3
"playerAttributes":{
4
"displayName":"Arya Stark",
5
"firstName": "Arya",
6
"lastName": "Stark",
7
8
},
9
"referrerCode": "code123",
10
}' -v -i 'https://api.gameball.co/api/v3.0/integrations/player'
Copied!

Tracking Referral Using Widget

If you have embedded The Gameball Profile Widget into your web page, you can relay on it to handle referral for you. The widget will internally
    1.
    Check for ReferralCode query parameter in the URL
    2.
    Store it in session storage
    3.
    Send it along its parameters when a new profile is created.
Last modified 1mo ago