Gameball Developers Guide
v3.0
v3.0
  • Introduction
  • What's New in V3.0
  • Installing Gameball
    • Web
      • Show Gameball Customer Widget
      • Track Customer Events
      • Track Orders & Cashback Reward
      • Integrate Redemption
      • Track Referrals
      • Go-Live Checklist
    • iOS
      • Getting Started
      • Initialize Gameball Customer Profile
      • Track Customer Events
      • Track Orders & Cashback Reward
      • Integrate Redemption
      • Track Referrals
      • Push Notifications
      • Go-Live Checklist
    • Android
      • Getting Started
      • Initialize Gameball SDK
      • Initialize Gameball Customer Profile
      • Track Customer Events
      • Track Referrals
      • Push Notifications
      • Go-Live Checklist
    • React Native
      • Getting Started
      • Initialize Gameball Customer Profile
      • Track Customer Events
      • Track Orders & Cashback Reward
      • Integrate Redemption
      • Track Referrals
      • Push Notifications
      • Go-Live Checklist
      • Migration from v1 to v2
    • Flutter
      • Getting Started
      • Initialize Gameball SDK
      • Initialize Gameball Customer Profile
      • Track Customer Events
      • Track Referrals
      • Go-Live Checklist
    • Generic Mobile App
      • Initialize Gameball Customer Profile
      • Track Customer Events
      • Track Orders & Cashback Reward
      • Integrate Redemption
      • Track Referrals
      • Push Notifications
    • Retail & Modern POS
      • Initialize Gameball Customer Profile
      • Track Orders & Cashback Reward
      • Track Refunds
      • Enable Redemption
        • Prepare POS for Redemption
        • Using Virtual ID
          • Using Virtual Card
  • REST API
    • Overview
      • Server-Side SDKs
    • Authentication
    • API Reference
      • Customer
      • Event
      • Transactions
      • Order
      • Coupons
      • Leaderboard 👑
      • Notifications 👑
      • Configurations 👑
      • Batches 👑
        • Batch Operations Data
      • OTP
      • Partner 🤝
        • Client 🤝
        • Redemption Rule 🤝
        • Cashback Rule 🤝
    • Webhooks
      • Notifications Webhook
      • Customer Profile Webhook
    • Errors
    • Object Reference
  • Tutorials
    • Build Custom UI Elements 👑
      • Display Reward Campaign Progress
      • Show VIP Tiers
      • Show Customer Points Balance
      • Build Leaderboards
      • Show Notifications Inbox
      • Adapt UI to Configurations
      • Advanced UI Techniques
        • Increase Sales with Cashback UI Elements
        • Derive Engagement with Rewards Campaigns UI Elements
    • Tracking Customer Events
    • Build your Own Notification System
    • Checkout Integration Example
    • Redemption Integration Options
      • Redeem with coupon system
        • Integrate your coupon system
          • Example using e-commerce platform(WooCommerce)
          • Example using a custom coupon system
        • Build couponing experience
          • Using Gameball widget
          • Build custom experience
            • Showing customers available points
            • Allowing customers to create coupons
            • Apply the discount code to your cart
        • Coupon integration reference
      • Redeem with direct debt
        • Get customers points balance
        • Redeem customer points
  • Third Party Integrations
    • Segment Integration
Powered by GitBook
On this page
  1. Installing Gameball
  2. Retail & Modern POS

Initialize Gameball Customer Profile

PreviousRetail & Modern POSNextTrack Orders & Cashback Reward

Last updated 1 year ago

By creating a customer in Gameball when they are created in the POS system, businesses can provide a seamless and personalized experience for the customer. This allows businesses to leverage customer data to offer targeted promotions and rewards, and to track customer behavior and preferences across all touchpoints. Additionally, by having a centralized customer database, businesses can provide consistent and personalized service to the customer, regardless of which touchpoint they are using to interact with the business.

Bulk Initial customers load into Gameball programs can be done via a simple CSV upload from the Gameball dashboard.

User profiles can be synced using the . The as the below sequence

  1. When a customer is created in the POS system, their information is collected, such as their name, email address, phone number, and any other relevant details.

  2. The POS system sends a POST request to the Gameball API endpoint for creating a customer, which includes the customer's information as parameters in the request body.

The below sample body creates a customer at Gameball with first name John, last name Snow along with his mobile and email address.

The main identifier that will be used to uniquely identify the customer and track his behavior is the playerUniqueId parameter which can be the id of the customer in the POS system.

{
  "playerUniqueId":"id123",
  "playerAttributes":{
  "firstName": "Jon",
  "lastName": "Snow",
  "mobile": "+111333444",
  "email":"jon.snow@example.com",
}

The above example works fine if your brand has only in-store experience and unified customer’s database. However, you might need to expand your offering and guarantee a seamless omni-channel experience for your customers or seamless experience through multiple POS vendors for different stores. This can be easily achieved if you have enabled the account merge feature.

The account merge functionality is particularly useful when a customer has multiple accounts with the same email or mobile number. This can happen, for example, when a customer creates a new account online without realizing that they already have an account in the business's in-store system. With Gameball's account merge functionality, businesses can match the customer's email or mobile number across different systems and merge their accounts, creating a single profile that reflects all their activity with the business.

To use the account merge functionality, businesses need to set up their different systems to send customer data to Gameball. Gameball will then match the customer data based on their email or mobile number and merge the accounts if there is a match. Once the accounts are merged, businesses can access a comprehensive view of the customer's activity across all touchpoints, including purchases, rewards earned, and referrals.

Account merge feature can be configured to work either with email or mobile number. After enabling the feature through Gameball’s dashboard.Selected merge attribute email or phone should be sent in the top level of the request body after the playerUniqueId. The below code snippets merge the account of Jon Snow coming from system 1 and system 2 into a single profile

//request from system 1
{
  //id from system 1 
  "playerUniqueId":"id123",
  //email is merge field
  "email":"jon.snow@example.com"
      "playerAttributes":{
      "firstName": "Jon",
      "lastName": "Snow",
      "mobile": "+111333444",
      "email":"jon.snow@example.com",
    }
}

//request from system 2
{
  //id from system 2
  "playerUniqueId":"xyz",
  //email is merge field
  "email":"jon.snow@example.com"
      "playerAttributes":{
      "firstName": "Jon",
      "lastName": "Snow",
      "displayName": "King of the North",
      "email":"jon.snow@example.com",
    }
}

Hence the the complete profile of Jon Snow at Gameball will have all of the attributes merged

As below

Attribute
Value

First Name

Jon

Last Name

Snow

Display Name

King of the North

Email

jon.snow@example.com

Create Customer API