> ## 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 Integrate Segment with Gameball?

> Save yourself the hassle of having to go through a technical integration with the help of developers with Segment integration.

## Why Integrate Segment with Gameball?

This integration allows you to target and segment your customers based on how loyal they are to your app. With this integration, you can:

* **Segment your contact lists** based on Gameball customer attributes.
* **Trigger automations** based on Gameball customer attributes.
* **Send personalized emails** by including Gameball customer information in email templates, such as the customer's current tier.

***

## How to Configure Segment on Gameball

<Steps>
  <Step title="Add Events to Track">
    Add the events you want to track in the **Gameball Admin Dashboard**. For more info on how to do that, [check out this article](/product-documentation/admin-settings/create-and-send-events).

    <Frame>
      <img src="https://mintcdn.com/gameball/tEm0zYZGDqbMoeMn/images/product-docs/apps-integrations/apps-integrations-89.png?fit=max&auto=format&n=tEm0zYZGDqbMoeMn&q=85&s=f0f60e32045d36863e6fa31a16aa2051" width="2534" height="956" data-path="images/product-docs/apps-integrations/apps-integrations-89.png" />
    </Frame>
  </Step>

  <Step title="Add Gameball as a Destination">
    Add the Gameball app as a destination from the Segment catalog. Then add your Gameball API Key in the destination settings on Segment. Learn [where to find your Gameball API key](/product-documentation/admin-settings/get-api-keys).

    <Frame>
      <img src="https://mintcdn.com/gameball/tEm0zYZGDqbMoeMn/images/product-docs/apps-integrations/apps-integrations-90.png?fit=max&auto=format&n=tEm0zYZGDqbMoeMn&q=85&s=e61f942c525ea3c8ba0ca002de2b5584" width="2184" height="864" data-path="images/product-docs/apps-integrations/apps-integrations-90.png" />
    </Frame>
  </Step>

  <Step title="Test with Event Builder">
    Ensure that the events you track reach Gameball through the Event Tester on Segment with the Event Builder.

    <Frame>
      <img src="https://mintcdn.com/gameball/tEm0zYZGDqbMoeMn/images/product-docs/apps-integrations/apps-integrations-91.png?fit=max&auto=format&n=tEm0zYZGDqbMoeMn&q=85&s=9a468f2898900a219747d35bc4b25372" width="2534" height="1000" data-path="images/product-docs/apps-integrations/apps-integrations-91.png" />
    </Frame>

    In this example, the Event name is "Buy product" and the type is "shoes".

    <Note>
      The **Event Name** in Event Tester on Segment must match the Event Name in the **Gameball Admin Dashboard**, and you must include the `userId`.
    </Note>
  </Step>

  <Step title="Test with JSON Builder">
    You can also verify events through the Event Tester in Segment using the JSON Builder.

    <Frame>
      <img src="https://mintcdn.com/gameball/tEm0zYZGDqbMoeMn/images/product-docs/apps-integrations/apps-integrations-92.png?fit=max&auto=format&n=tEm0zYZGDqbMoeMn&q=85&s=1cbad5543f991351f83a74bf4407b84c" width="1308" height="1164" data-path="images/product-docs/apps-integrations/apps-integrations-92.png" />
    </Frame>

    <Info>
      The only properties supported for updating through events at the moment are: ID, Join Date, Level Name, Type ID, Points, Score Balance, Level ID, and Completed Challenges.
    </Info>
  </Step>
</Steps>