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.Customer Attributes Sync
Customer Attributes Sync
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 |
Order Placed Event
Order Placed Event
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 |
Coupon Created Event
Coupon Created Event
Trigger: Coupon created for the customer.The following coupon details will be available on Insider:
- Coupon Code
- Type
- Value
- Coupon Name
Coupon Used Event
Coupon Used Event
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.)
Reward Campaign Achieved Event
Reward Campaign Achieved Event
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
Points Redeemed Event
Points Redeemed Event
Trigger: Customer redeemed their saved points.Each
points_redeemed event includes:- Redeemed Points
- Redemption Amount
- Redemption Transaction ID (if available)
Purchase Line Item Event
Purchase Line Item Event
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
Customer Deletion Sync
Customer Deletion Sync
Trigger: Customer removed from Gameball.Once a customer is deleted from Gameball, the customer gets deleted from Insider after 24 hours.
You have the option to disable the deletion feature from Insider.
How to Configure Insider on Gameball
Ensure Your Widget is Published
Not publishing the widget could impact the integration process, so ensure it’s live before proceeding.
Access the Integrations Page
Navigate to Integrations in your Gameball Admin Dashboard menu. Scroll down to Insider and click Connect.
Copy and Paste Partner Name
- In your Insider account, go to Settings > “App Name” Settings > Account Settings.
- Copy the Partner Name.
- Go back to your Gameball dashboard and paste the name.
Create an API Key in Insider
- In your Insider account, go to Settings > “App Name” Settings > Integration Settings.
- Scroll down and click Generate API key.
- Choose Unified Customer Database and click Next.
Copy and Paste the API Key
- Once you’ve generated the API key in Insider, copy it.
- Go back to your Gameball dashboard, paste the key, and click Next.
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.
- In the Gameball Dashboard, go to Integrations.
- Select Insider from the list of available integrations.
- Map the following events:
- Coupon Created
- Coupon Redeemed
- Reward Campaign Achieved
- Order Placed
- Confirm the event mappings and save.
Sync Customer Data
Syncing customer data ensures Insider receives real-time updates about customer actions.
- In the Gameball Dashboard, navigate to Integrations > Insider.
- Enable the Customer Sync toggle.
- 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).
- Save your settings.
Verify Synced Customers
In the User Profiles section, you will find a table with all automatically synced Gameball customers.
