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

> Keep your customers in sync across Gameball and Klaviyo, and target them effectively based on their loyalty data and events.

| Platform   | Plan |
| ---------- | ---- |
| Shopify    | All  |
| Self-serve | All  |

Gameball and Klaviyo integration allows you to leverage customer engagement data from Gameball to power your email marketing campaigns in Klaviyo. Follow this guide to seamlessly connect the two platforms and maximize the impact of your loyalty and marketing efforts.

## Why Integrate Klaviyo with Gameball?

By integrating Klaviyo with Gameball, you unlock the ability to target and segment customers based on their loyalty to your app. This powerful integration allows you to:

* **Segment contact lists** based on Gameball customer attributes (e.g., points balance, tier) and events created.
* **Send personalized emails** by including loyalty-related data, such as customer tier and reward points, in your email templates.
* **Track and trigger campaigns** based on specific customer events, such as coupons created, orders placed, and reward achievements.

***

## How to Configure Klaviyo on Gameball

<Steps>
  <Step title="Ensure Your Widget is Published">
    <Info>
      Not publishing the widget could impact the integration process, so ensure it's live before proceeding.
    </Info>
  </Step>

  <Step title="Access the Integrations Page">
    Navigate to **Integrations** in your **Gameball Admin Dashboard** left menu.

    <Frame>
      <img src="https://mintcdn.com/gameball/rAvMcwJweaNUX1m4/images/product-docs/apps-integrations/apps-integrations-65.png?fit=max&auto=format&n=rAvMcwJweaNUX1m4&q=85&s=58e55a92ea5c0b5f77baab335ad9ac19" width="2704" height="1374" data-path="images/product-docs/apps-integrations/apps-integrations-65.png" />
    </Frame>
  </Step>

  <Step title="Connect Klaviyo">
    Click **Connect** under **Klaviyo**. If you are on Shopify, make sure Klaviyo is installed through the Shopify App Store.
  </Step>

  <Step title="Create an API Key in Klaviyo">
    1. In your Klaviyo account, go to **Account Settings > Settings > API Keys**.
    2. Create a new API key and ensure **full access** for each API scope.

    <Warning>
      Failing to grant full access may prevent the integration from functioning properly.
    </Warning>
  </Step>

  <Step title="Copy and Paste the API Key">
    1. Copy the generated API key from Klaviyo.
    2. Go back to your Gameball dashboard, paste the key, and click **Next**.
  </Step>

  <Step title="Set Up a Webhook in Klaviyo">
    Webhooks allow Gameball to send real-time data to Klaviyo.

    1. Log in to your **Klaviyo Dashboard**.
    2. Go to **Account Settings > Webhooks**.
    3. Click **Create Webhook**.
       * Provide a name (e.g., "Gameball Integration").
       * Enter the **Webhook URL** provided by Gameball in the integration section.
    4. Save the webhook.
  </Step>

  <Step title="Map Gameball Events to Klaviyo">
    Gameball tracks various customer events (e.g., points earned, redeemed, tiers achieved). Map these events to Klaviyo to use them in your campaigns.

    1. In the Gameball Dashboard, go to **Integrations**.
    2. Select **Klaviyo** from the list.
    3. Map the following events:
       * Coupon Created
       * Coupon Redeemed
       * Reward Campaign Achieved
       * Order Placed
    4. Confirm the event mappings and save.
  </Step>

  <Step title="Sync Customer Data">
    Syncing customer data ensures Klaviyo receives real-time updates about customer actions.

    1. In the Gameball Dashboard, navigate to **Integrations > Klaviyo**.
    2. Enable the **Customer Sync** toggle.
    3. Choose the customer attributes to sync (Customer ID, Date of Birth, Join Date, Tier Name, Wallet Points, Pending Points, Tier Progress, Tier ID, Completed Reward Campaigns, Referral Code, Referral Link, Tags and Segments).
    4. Save your settings.
  </Step>

  <Step title="Verify Synced Customers">
    In Klaviyo's profile section, you will find all automatically synced Gameball customers.

    <Frame>
      <img src="https://mintcdn.com/gameball/rAvMcwJweaNUX1m4/images/product-docs/apps-integrations/apps-integrations-66.png?fit=max&auto=format&n=rAvMcwJweaNUX1m4&q=85&s=644753012f64bc8624bc79cf593cd709" width="2878" height="1428" data-path="images/product-docs/apps-integrations/apps-integrations-66.png" />
    </Frame>
  </Step>
</Steps>

***

## Using Gameball Data in Klaviyo

### View Custom Properties

In Klaviyo, view Gameball customer attributes under **Profile > Information > Custom Properties** of a specific customer.

### Use Attributes in Campaigns

When creating a campaign in Klaviyo, insert Gameball attributes by selecting **Insert Property**.

<Frame>
  <img src="https://mintcdn.com/gameball/rAvMcwJweaNUX1m4/images/product-docs/apps-integrations/apps-integrations-67.png?fit=max&auto=format&n=rAvMcwJweaNUX1m4&q=85&s=c283619d10f7fb9c23c1c7bb3180890e" width="2880" height="1432" data-path="images/product-docs/apps-integrations/apps-integrations-67.png" />
</Frame>

### Trigger Flows Based on Events

You can trigger automated flows in Klaviyo based on real-time Gameball events such as Coupon Created, Coupon Redeemed, Reward Campaign Achieved, Order Placed, and Points Redeemed.

<Frame>
  <img src="https://mintcdn.com/gameball/rAvMcwJweaNUX1m4/images/product-docs/apps-integrations/apps-integrations-68.png?fit=max&auto=format&n=rAvMcwJweaNUX1m4&q=85&s=7127eb09ca459d642e2d466bb3bbe615" width="2880" height="1432" data-path="images/product-docs/apps-integrations/apps-integrations-68.png" />
</Frame>

Each event is synced in real-time, allowing you to send highly targeted campaigns and flows in Klaviyo.

***

<CardGroup cols={2}>
  <Card title="Gameball on MoEngage" icon="bell" href="/product-documentation/apps-integrations/moengage-integration">
    Integrate Gameball with MoEngage for engagement campaigns.
  </Card>

  <Card title="Apps & Integrations Overview" icon="grid-2" href="/product-documentation/apps-integrations/introduction-to-apps-integrations">
    Explore all available Gameball integrations.
  </Card>
</CardGroup>
