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

> Leverage customer engagement data from Gameball to power your marketing campaigns in Insider.

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

## Why Integrate Insider with Gameball?

By integrating Insider 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.

***

## Data Import Scenarios

The integration between Gameball and Insider ensures that your customer data is always up-to-date. Gameball's customer attributes will be imported into Insider whenever a customer is created or performs any action.

<AccordionGroup>
  <Accordion title="Customer Attributes Sync" icon="users">
    **Trigger:** Upon customer creation or after any new action (e.g., achievement, transaction, points expiry).

    Gameball's customer attributes will be imported and updated in Insider automatically. The following data is synced:

    | Category      | Attributes                                                                                                                                                                         |
    | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **Profile**   | ID, Email, Join Date, Mobile Number, Birthday, Gender                                                                                                                              |
    | **Points**    | Points Balance, Pending Points, Earned Points, Redeemed Points, Expired Points                                                                                                     |
    | **Tiers**     | Current Level Name, Current Level Order, Next Level, Next Level Threshold, Level Progress, Progress to Achieve Next Level                                                          |
    | **Orders**    | Last Order Awarded Points, Average Basket, Number of Transactions, Transactions Amount (Last Rolling Year), Total Net Amount, Unit per Transaction, Date of First/Last Transaction |
    | **Referrals** | Referral Code, Referral Link                                                                                                                                                       |
    | **Coupons**   | Latest Created Coupon, Latest Used Coupon                                                                                                                                          |
    | **Segments**  | Tags, Segments, RFM Segments                                                                                                                                                       |
    | **Other**     | Count of Rewarded Campaigns, Starting Store, Connecting Store, Store of First Transaction                                                                                          |
  </Accordion>

  <Accordion title="Order Placed Event" icon="cart-shopping">
    **Trigger:** Order placed by customer and received by Gameball.

    Once an order is placed, the following order data is sent to Insider:

    | Attribute               | Description                       |
    | ----------------------- | --------------------------------- |
    | Order ID                | Unique order identifier           |
    | Order Date              | Date the order was placed         |
    | Total Paid              | Amount paid by the customer       |
    | Total Price             | Full order price                  |
    | Total Shipping          | Shipping cost                     |
    | Total Tax               | Tax amount                        |
    | Total Discount          | Discount applied                  |
    | Discount Codes          | Codes used                        |
    | Redeemed Amount         | Points redeemed as currency       |
    | Rewarded Points         | Points earned from order          |
    | Equivalent Points Value | Monetary value of rewarded points |
  </Accordion>

  <Accordion title="Coupon Created Event" icon="ticket">
    **Trigger:** Coupon created for the customer.

    The following coupon details will be available on Insider:

    * Coupon Code
    * Type
    * Value
    * Coupon Name
  </Accordion>

  <Accordion title="Coupon Used Event" icon="receipt">
    **Trigger:** Customer used a coupon while placing an order.

    The following details will be available on Insider:

    * Coupon Code, Type, Value, Coupon Name
    * Order ID, Order Quantity
    * Channel (POS, Online, etc.)
  </Accordion>

  <Accordion title="Reward Campaign Achieved Event" icon="trophy">
    **Trigger:** Customer achieved a reward campaign.

    The following details will be available on Insider:

    * Internal Name, Name
    * Reward (Points, Points & Score, Coupon Values)
    * Coupon Type (if the reward was a coupon)
    * Equivalent Value of Rewarded Points
    * Achievement Date
  </Accordion>

  <Accordion title="Points Redeemed Event" icon="coins">
    **Trigger:** Customer redeemed their saved points.

    Each `points_redeemed` event includes:

    * Redeemed Points
    * Redemption Amount
    * Redemption Transaction ID (if available)
  </Accordion>

  <Accordion title="Purchase Line Item Event" icon="box">
    **Trigger:** Order received by Gameball.

    A "Purchase" event is sent to Insider for each line item with the following attributes:

    * Order ID, Product Title, Unit Price, Vendor Name
    * Product ID, Weight, Quantity, SKU
    * Collections Array, Tags Array, Taxonomy Array
    * Any extra attributes added to the object
  </Accordion>

  <Accordion title="Customer Deletion Sync" icon="user-minus">
    **Trigger:** Customer removed from Gameball.

    Once a customer is deleted from Gameball, the customer gets deleted from Insider after **24 hours**.

    <Note>
      You have the option to disable the deletion feature from Insider.
    </Note>
  </Accordion>
</AccordionGroup>

***

## How to Configure Insider 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** menu. Scroll down to **Insider** and click **Connect**.

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

  <Step title="Copy and Paste Partner Name">
    1. In your **Insider** account, go to **Settings > "App Name" Settings > Account Settings**.
    2. Copy the **Partner Name**.

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

    3. Go back to your Gameball dashboard and paste the name.

    <Frame>
      <img src="https://mintcdn.com/gameball/rAvMcwJweaNUX1m4/images/product-docs/apps-integrations/apps-integrations-49.png?fit=max&auto=format&n=rAvMcwJweaNUX1m4&q=85&s=61fd62c12342f1c5dbc0004f68826aec" width="1796" height="1202" data-path="images/product-docs/apps-integrations/apps-integrations-49.png" />
    </Frame>
  </Step>

  <Step title="Create an API Key in Insider">
    1. In your **Insider** account, go to **Settings > "App Name" Settings > Integration Settings**.

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

    2. Scroll down and click **Generate API key**.

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

    3. Choose **Unified Customer Database** and click **Next**.

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

    <Warning>
      Choosing a different type for the API Key may prevent the integration from functioning properly.
    </Warning>
  </Step>

  <Step title="Copy and Paste the API Key">
    1. Once you've generated the API key in Insider, copy it.
    2. Go back to your Gameball dashboard, paste the key, and click **Next**.

    <Frame>
      <img src="https://mintcdn.com/gameball/rAvMcwJweaNUX1m4/images/product-docs/apps-integrations/apps-integrations-53.png?fit=max&auto=format&n=rAvMcwJweaNUX1m4&q=85&s=50da64ed247db0af46dacb16b8e4ee2e" width="1796" height="1202" data-path="images/product-docs/apps-integrations/apps-integrations-53.png" />
    </Frame>
  </Step>

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

    1. In the Gameball Dashboard, go to **Integrations**.
    2. Select **Insider** from the list of available integrations.
    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 Insider receives real-time updates about customer actions.

    1. In the Gameball Dashboard, navigate to **Integrations > Insider**.
    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 the **User Profiles** section, you will find a table with all automatically synced Gameball customers.

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

    You will also see real-time Gameball events such as Coupon Created, Coupon Used, Reward Campaign Achieved, Order Placed, and Purchase.

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

    Each event is synced in real-time, allowing you to send highly targeted campaigns and flows in Insider.
  </Step>
</Steps>

***

<CardGroup cols={2}>
  <Card title="Gameball on Zapier" icon="bolt" href="/product-documentation/apps-integrations/zapier-integration">
    Connect Gameball with thousands of apps via Zapier.
  </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>
