Skip to main content

​
Adjust Integration

​
Overview

Gameball supports Adjust as a dynamic link provider for referral programs. This integration enables you to generate dynamic links that track referrals and enhance your user acquisition strategy.

​
Integration Steps

Follow these steps to integrate Adjust with Gameball:

​
1. Navigate to Admin Settings

  1. Log in to your Gameball Dashboard.
  2. Go to Settings > Integrations > Mobile Integrations.
Gameball Admin Settings
  1. In the Gameball Dashboard, locate the Referral Link field.
Referral Link
  1. Enter your application’s desktop URL (this will be used as the fallback when the referral link is opened on a desktop).
  2. Click Update Configurations to apply the changes.
  1. Locate the Dynamic Link Provider section.
  2. Select Adjust by clicking the radio button.
Adjust Dynamic Link Provider

​
4. Retrieve Your Adjust Credentials

To complete the integration, you need two values from your Adjust account:
  • Adjust User Token
  • Adjust Link Token (related to your referral campaign)

​
🔐 How to Find Your Adjust User Token

  1. Log in to your Adjust Dashboard.
  2. Go to Account Settings.
  3. Navigate to the User Profile tab.
  4. Locate your User Token under the API token title.
  5. Copy your User Token.
Adjust User Token
  1. In the Adjust dashboard, go to Campaign Lab then select Custom Links.
Adjust Custom Links
  1. Create or open an existing custom link that you’ll use for referrals.
  2. You will find the Link Token at the end of the page, typically a short string like 1ng4vfot.
Adjust Link Token
  1. Copy this token for use in Gameball.

​
5. Enter Your Credentials in Gameball

  • Go back to your Gameball Dashboard.
  • Enter the Adjust User Token in the User Token field and click Update Adjust.
Enter User Token
  • Enter the Adjust Link Token in the Link Token field and click Update Adjust.
Enter Link Token

​
Notes

Before proceeding with the integration, ensure that your custom link, deep link, and universal linking are fully configured in your Adjust account with the appropriate redirection links.
To verify that your Adjust account is correctly set up to generate dynamic links, you can test it using the Adjust API. If the response returns a dynamic link, then your configuration on Adjust’s side is working as expected.Here’s a sample curl command you can use for testing:
curl --location 'https://automate.adjust.com/engage/deep-links' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer adjustApiToken' \
--data '{
  "link_token": "1c52mluz",
  "redirect": "https://example.com/redirect",
  "fallback": "https://example.com/fallback",
  "deep_link_path": "/custom-path",
  "shorten_url": true
}'
Replace adjustApiToken with your actual API token.
If the call is successful and returns a short dynamic link, you’re all set!
These settings ensure referral links redirect users correctly based on their device and platform.
If you are using the Gameball SDK to capture referrals, you must pass the Gameball referral code (captured from the link) as the GBReferral parameter in the registerPlayer method.This is essential to ensure the referral is tracked and attributed correctly.
Now your referral program is powered by Adjust dynamic links! 🚀