Adjust Integration

Integrating Adjust with Gameball

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.

2. Add Your Application Desktop URL as the Referral Link

1. In the Gameball Dashboard, locate the Referral Link field.

   
2. Enter your application's desktop URL (this will be used as the fallback when the referral link is opened on a desktop).

3. Click Update Configurations to apply the changes.

3. Select Adjust as Your Dynamic Link Provider

1. Locate the Dynamic Link Provider section.

2. Select Adjust by clicking the radio button.

   

---

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.

---

🔗 How to Find Your Adjust Link Token

1. In the Adjust dashboard, go to Campaign Lab then select Custom Links .

   
2. Create or open an existing custom link that you’ll use for referrals.

3. You will find the Link Token at the end of the page typically a short string like 1ng4vfot.

   
4. 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 the Adjust Link Token in the Link Token field and click Update Adjust.

  

---

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! 🚀