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

> Enhance Your Customer Engagement with Gameball Integration with MoEngage

[MoEngage](https://www.moengage.com/) is an Intelligent Customer Engagement Platform that allows brands to personalize every customer interaction, driving better engagement, retention, loyalty, and lifetime value. The MoEngage and Gameball integration enables you to harness the full potential of both platforms to enhance your customer engagement strategies.

***

## Data Import Scenarios

The integration between Gameball and MoEngage ensures that your customer data is always up-to-date. Gameball's customer attributes will be imported into MoEngage 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 MoEngage automatically. The following data is synced:

    | Category      | Attributes                                                                                                                                                                         |
    | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **Profile**   | ID, Email, Join Date, Mobile Number, Birthday, Gender, Country, Currency                                                                                                           |
    | **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 MoEngage:

    | 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 MoEngage:

    * 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 MoEngage:

    * 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 MoEngage:

    * 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.

    An "Item Purchased" event is sent to MoEngage for each line item with the following attributes:

    * Order ID, Product Title, Product Price, Vendor Name
    * Product ID, Weight, Quantity, SKU
    * Collections Array, Tags Array, Categories 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 MoEngage after **24 hours**.

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

  <Accordion title="Workspace Information" icon="building">
    Workspace context is included in both customer events and attributes, giving you greater flexibility in segmentation and personalization.

    * **`gameball_workspace`**: a string containing the workspace name or ID.
    * **Gameball Workspace**: a string attribute storing the associated workspace.
  </Accordion>
</AccordionGroup>

***

## How to Set Up the Integration

<Steps>
  <Step title="Navigate to MoEngage in App Store">
    Go to the **App Store** on Gameball's dashboard and select **MoEngage** from the list of available app integrations.

    <Frame>
      <img src="https://mintcdn.com/gameball/061svGa8TDKAo95o/images/product-docs/apps-integrations/apps-integrations-27.png?fit=max&auto=format&n=061svGa8TDKAo95o&q=85&s=ffdb57e6040dc55a8966feaab15dc64f" width="3018" height="1424" data-path="images/product-docs/apps-integrations/apps-integrations-27.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/gameball/061svGa8TDKAo95o/images/product-docs/apps-integrations/apps-integrations-28.png?fit=max&auto=format&n=061svGa8TDKAo95o&q=85&s=e8af698fac55f8557d9f84baa5682f66" width="1746" height="1560" data-path="images/product-docs/apps-integrations/apps-integrations-28.png" />
    </Frame>
  </Step>

  <Step title="Enter API Credentials">
    Enter the **App ID** and **Data API Key** from MoEngage's settings page.

    <Frame>
      <img src="https://mintcdn.com/gameball/061svGa8TDKAo95o/images/product-docs/apps-integrations/apps-integrations-29.png?fit=max&auto=format&n=061svGa8TDKAo95o&q=85&s=089a80b385a4ce20889ea56eeaf86f12" width="2880" height="1442" data-path="images/product-docs/apps-integrations/apps-integrations-29.png" />
    </Frame>
  </Step>

  <Step title="Select Your Data Center">
    Select your **Data Center**.

    <Frame>
      <img src="https://mintcdn.com/gameball/061svGa8TDKAo95o/images/product-docs/apps-integrations/apps-integrations-30.png?fit=max&auto=format&n=061svGa8TDKAo95o&q=85&s=5d174893beae4a9837062cfe8800dcad" width="1660" height="1320" data-path="images/product-docs/apps-integrations/apps-integrations-30.png" />
    </Frame>

    <Info>
      If you're unsure which data center you're on, you can find your code in your dashboard's URL.
    </Info>

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

  <Step title="Complete the Setup">
    Complete the setup and start leveraging the powerful combination of Gameball and MoEngage.

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

    <Frame>
      <img src="https://mintcdn.com/gameball/061svGa8TDKAo95o/images/product-docs/apps-integrations/apps-integrations-26.png?fit=max&auto=format&n=061svGa8TDKAo95o&q=85&s=89e4b09eba158c75bed275178035e946" width="713" height="171" data-path="images/product-docs/apps-integrations/apps-integrations-26.png" />
    </Frame>
  </Step>
</Steps>

***

## How to Use the Data on MoEngage

Once the data from Gameball is imported into MoEngage, you can leverage it to create more personalized and effective customer engagement strategies:

1. **Personalized Campaigns** - Use customer attributes such as name, email, birthday, and purchase history to create highly personalized marketing campaigns.
2. **Segmentation** - Utilize synced segments and tags to group customers based on their behavior, preferences, and activity.
3. **Event-Triggered Campaigns** - Set up automated campaigns triggered by specific events such as order placement, coupon creation, or coupon usage.
4. **Customer Journey Mapping** - Track and analyze the customer journey using imported data to identify key touchpoints.
5. **Retention Strategies** - Monitor points balance, tier progress, and achievements to identify loyal customers and those at risk of churning.

***

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