> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gameball.co/llms.txt
> Use this file to discover all available pages before exploring further.

# How Do I Launch Referral Program?

> Boost your customer engagement, and increase your base with Gameball's Referral Program

| Platform             | Plan                |
| -------------------- | ------------------- |
| Shopify              | Starter, Pro & Guru |
| Salla                | Starter, Pro & Guru |
| Non-platform Clients | Growth & Enterprise |

Gameball's referral program allows you to reward both existing customers and their referred friends based on customizable conditions and actions. This article explains how to activate and configure your referral program through the Gameball dashboard.

***

## Activating Gameball's Referral Program

<Steps>
  <Step title="Log in to the Gameball Dashboard">
    Log in to the **Gameball dashboard**.
  </Step>

  <Step title="Navigate to Referrals">
    From the left-side menu under **Programs**, click **Referrals**.
  </Step>

  <Step title="Enable the Referral Program">
    On the Referrals setup page, toggle the **activation switch** to enable the referral program on your platform.

    <Frame>
      <img src="https://mintcdn.com/gameball/qjUH61X3ISD5sEmZ/images/product-docs/programs/referral-program/activate-referral.png?fit=max&auto=format&n=qjUH61X3ISD5sEmZ&q=85&s=b7cf4dd97e3e5d428ef0930845798cde" alt="Activate Referral Program" width="1792" height="1492" data-path="images/product-docs/programs/referral-program/activate-referral.png" />
    </Frame>

    Now that the referral program is active, follow the steps below to configure it.
  </Step>
</Steps>

***

## Referral Program Configuration

### 1. Referral Reward

Gameball allows you to decide who gets rewarded in your referral program. You can choose to reward:

* **Both the customer and their friend**
* **Only the customer**

<Frame>
  <img src="https://mintcdn.com/gameball/qjUH61X3ISD5sEmZ/images/product-docs/programs/referral-program/referral-reward-options.png?fit=max&auto=format&n=qjUH61X3ISD5sEmZ&q=85&s=dd505a83758b1a8402089c50d111168e" alt="Referral Reward Options" width="1274" height="576" data-path="images/product-docs/programs/referral-program/referral-reward-options.png" />
</Frame>

To configure the referral reward:

<Steps>
  <Step title="Click Edit in the Referral Reward Section">
    Click **Edit** in the **Referral Reward** section.
  </Step>

  <Step title="Choose the Friend's Action">
    Under **Friend's Action**, choose what qualifies a referral as successful:

    * The friend completes their first purchase (account creation not required).
    * The friend creates an account and completes a specific action, such as:
      * Completing their first purchase
      * Triggering a custom event that you have configured

    <Frame>
      <img src="https://mintcdn.com/gameball/qjUH61X3ISD5sEmZ/images/product-docs/programs/referral-program/friends-action-config.png?fit=max&auto=format&n=qjUH61X3ISD5sEmZ&q=85&s=736ee81105918a122cd9d0a0faac7188" alt="Friend's Action Configuration" width="1274" height="636" data-path="images/product-docs/programs/referral-program/friends-action-config.png" />
    </Frame>
  </Step>
</Steps>

#### Set Up the Rewards

<AccordionGroup>
  <Accordion title="Customer Reward" icon="user">
    1. Click **Change** under **Customer Reward**.

    2. Choose the type of reward from the **Rewards** section. [Learn more about Rewards Types](/product-documentation/rewards-campaigns/faqs/understanding-rewards-types).

    3. \[Optional] Add an **extra reward** for every X successful referrals. For example, reward the customer with 100 extra points for every 5 successful referrals.

    <Frame>
      <img src="https://mintcdn.com/gameball/qjUH61X3ISD5sEmZ/images/product-docs/programs/referral-program/customer-reward-setup.png?fit=max&auto=format&n=qjUH61X3ISD5sEmZ&q=85&s=c1e7656b96b15ed13978f9b8719c5170" alt="Customer Reward Setup" width="1838" height="1396" data-path="images/product-docs/programs/referral-program/customer-reward-setup.png" />
    </Frame>
  </Accordion>

  <Accordion title="Friend Reward" icon="user-plus">
    1. Click **Change** under **Friend Reward**.

    2. Choose the type of reward from the **Rewards** section.

    3. Select the **notification style** you want to use.

    <Frame>
      <img src="https://mintcdn.com/gameball/qjUH61X3ISD5sEmZ/images/product-docs/programs/referral-program/friend-reward-setup.png?fit=max&auto=format&n=qjUH61X3ISD5sEmZ&q=85&s=12a54985f624db53533850afa7a6f08e" alt="Friend Reward Setup" width="1838" height="1396" data-path="images/product-docs/programs/referral-program/friend-reward-setup.png" />
    </Frame>
  </Accordion>
</AccordionGroup>

***

### 2. Settings

<AccordionGroup>
  <Accordion title="Referral Landing Page" icon="link">
    Choose the page you want referred friends to be directed to:

    1. Enter your desired **URL** (by default, it redirects to your homepage).

    2. Press **Save**.

    <Frame>
      <img src="https://mintcdn.com/gameball/qjUH61X3ISD5sEmZ/images/product-docs/programs/referral-program/referral-landing-page.png?fit=max&auto=format&n=qjUH61X3ISD5sEmZ&q=85&s=5fbb619451ebedf50a6b021b2c45eee1" alt="Referral Landing Page" width="1274" height="414" data-path="images/product-docs/programs/referral-program/referral-landing-page.png" />
    </Frame>
  </Accordion>

  <Accordion title="Referral Content" icon="pen-to-square">
    To customize the content of the referral module displayed on the widget:

    * Click the **redirection link** in the **Referral Content** section

    <Frame>
      <img src="https://mintcdn.com/gameball/qjUH61X3ISD5sEmZ/images/product-docs/programs/referral-program/referral-content-link.png?fit=max&auto=format&n=qjUH61X3ISD5sEmZ&q=85&s=44713c630591624ca0ea3df76b3a564e" alt="Referral Content Link" width="1274" height="166" data-path="images/product-docs/programs/referral-program/referral-content-link.png" />
    </Frame>

    **Or**

    * From the left-side menu, go to **Widget Display > Content**, then select the **Referral** tab

    <Frame>
      <img src="https://mintcdn.com/gameball/qjUH61X3ISD5sEmZ/images/product-docs/programs/referral-program/referral-content-tab.png?fit=max&auto=format&n=qjUH61X3ISD5sEmZ&q=85&s=299ac8d7b6ac70b7439b2fc91e6abbce" alt="Referral Content Tab" width="2862" height="1358" data-path="images/product-docs/programs/referral-program/referral-content-tab.png" />
    </Frame>
  </Accordion>
</AccordionGroup>

***

## Multi-Step Rewards \[Add-on]

Multi-step rewards allow you to incentivize both your customers and their friends at different stages of the referral journey.

For example, you can reward a customer when their friend:

* Creates an account
* Completes an order

<Frame>
  <img src="https://mintcdn.com/gameball/qjUH61X3ISD5sEmZ/images/product-docs/programs/referral-program/multi-step-referrals.png?fit=max&auto=format&n=qjUH61X3ISD5sEmZ&q=85&s=6b303ef48c1ac43526f7a6087634a620" alt="Multi-Step Referrals" width="1192" height="1367" data-path="images/product-docs/programs/referral-program/multi-step-referrals.png" />
</Frame>

To configure multi-step rewards:

<Steps>
  <Step title="Add a New Step">
    Click **Add New Step**.
  </Step>

  <Step title="Set the Friend's Action">
    Set the **friend's action** for this step.
  </Step>

  <Step title="Choose Rewards">
    Choose the **rewards** for both the customer and the friend.

    <Frame>
      <img src="https://mintcdn.com/gameball/qjUH61X3ISD5sEmZ/images/product-docs/programs/referral-program/multi-step-config.png?fit=max&auto=format&n=qjUH61X3ISD5sEmZ&q=85&s=8f83c8579842f1f8d777471f5f9558d7" alt="Multi-Step Configuration" width="1440" height="1226" data-path="images/product-docs/programs/referral-program/multi-step-config.png" />
    </Frame>
  </Step>
</Steps>

<Note>
  You can now configure multi-step referral flows to mark an event as **"Happens One Time"**, without needing to define additional metadata or complex custom rules.
</Note>

***

## Common Questions

<AccordionGroup>
  <Accordion title="How do I generate and track referral deep links?" icon="link">
    You can use Branch.io and Adjust to generate and track referral links for your customers.

    **Branch.io** and **Adjust** are tools used to create dynamic referral links, **primarily for clients with mobile apps** who want to redirect users to their app. Both platforms offer free plans, but these come with limits based on the number of Monthly Active Users (MAUs) or attributions.

    * [Read about how to integrate **Branch.io** with Gameball](https://developer.gameball.co/branch.io-integration)
    * [Read about how to integrate **Adjust** with Gameball](https://developer.gameball.co/adjust-integration)

    For web-only clients (those without a mobile app), there is no need to use Branch or Adjust.
  </Accordion>

  <Accordion title="Can I create referral links without using deep link generators like Branch.io and Adjust?" icon="code">
    The referral process can be completed without using a deep link generator like Branch or Adjust. In such cases, you will need to provide your own referral link. Gameball will simply append the referral code to it.

    Deep link generators are only responsible for generating the link that appears in the referral widget. If you're not using one, the referral link will follow this format:

    * `{referralLink}?GbReferral={referralCode}`

    You will then need to handle the referral logic manually, including capturing the referral code and passing it in the *create customer* request.
  </Accordion>

  <Accordion title="Can I show referral codes rather than links?" icon="hashtag">
    You can choose to display a customer's **referral code** instead of the full referral link, making it easier for customers to copy, share, and use referrals during sign-up especially in offline or manual flows.

    From the dashboard, navigate to **Widget > General > Visibility > Referral Page**.
    You can choose whether referral experiences display the full referral link or only the customer's unique referral code.

    <Frame>
      <img src="https://mintcdn.com/gameball/qjUH61X3ISD5sEmZ/images/product-docs/programs/referral-program/referral-code-display.png?fit=max&auto=format&n=qjUH61X3ISD5sEmZ&q=85&s=1cb9c700e1cc623d53a7b855d3bf1e07" alt="Referral Code Display" width="1084" height="496" data-path="images/product-docs/programs/referral-program/referral-code-display.png" />
    </Frame>

    This is supported across both web and mobile, ensuring a unified experience wherever customers engage.
  </Accordion>
</AccordionGroup>

***

## Related Articles

<CardGroup cols={2}>
  <Card title="Referrals on Gameball Widget" icon="mobile-screen" href="/product-documentation/programs/referral-program/referrals-on-gameball-widget">
    See how customers experience referrals on the Gameball widget.
  </Card>

  <Card title="Integrate Gameball with Branch.io" icon="code-branch" href="/product-documentation/apps-integrations/branch-io-integration">
    Generate and track deep referral links with Branch.io.
  </Card>

  <Card title="Integrate Gameball with Adjust" icon="sliders" href="/product-documentation/apps-integrations/adjust-integration">
    Generate and track deep referral links with Adjust.
  </Card>
</CardGroup>
