Initialize Gameball Player Profile

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 players load into Gameball programs can be done via a simple CSV upload from the Gameball dashboard.

User profiles can be synced using the Create Player API. 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 player, which includes the customer's information as parameters in the request body.

The below sample body creates a player 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": "[phone]",
  "email":"[e-mail]",
}

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":"[e-mail]"
      "playerAttributes":{
      "firstName": "Jon",
      "lastName": "Snow",
      "mobile": "[phone]",
      "email":"[e-mail]",
    }
}

//request from system 2
{
  //id from system 2
  "playerUniqueId":"xyz",
  //email is merge field
  "email":"[e-mail]"
      "playerAttributes":{
      "firstName": "Jon",
      "lastName": "Snow",
      "displayName": "King of the North",
      "email":"[e-mail]",
    }
}

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	[e-mail]