Object Reference
This section provides a list of the objects dealt with using the available API endpoints.
Cashback Object
The cashback object is returned in the Configurations API response body. It describes the cashback program configurations.
Parameter | Type | Description |
| number | In case you have different merchants (brands) on your platform, The Example: If you give 5% cashback (when the customer pays 100 USD, they will get 5 USD cashback). The |
| integer | Defines the amount of unit currencies needed to reward the player as per cashback rules.
Example: For every 10 USD spent the player gets rewarded by 5 points, implies that the |
| integer | Determines the points rewarded for each unit currency your player spends. Example: 2 points for every 1 USD spent, implies that the |
| integer | In case your level up method is score, this factor determines the score rewarded for each unit currency your player spends. Example: 2 Score for every 1 USD spent, implies that the |
Challenge Object
Represents the challenge object that describes a configured challenge and tracks the relative player's progress.
Parameter | Type | Description |
| integer | Unique identifier for the challenge. |
| string | Challenge Name |
| string | Challenge Description |
| integer | Awarded rank upon challenge completion |
| integer | Awarded points upon challenge completion |
| boolean | A flag that indicates whether the challenge is repeatable or not. |
| integer | An integer that defines how many times a player can achieve that challenge. |
| string | The type of the challenge. Possible values are as follows:
|
| string | Defines the visibility of the challenge. Possible values are:
|
| string | The icon's URL of the challenge. |
| object |
An object that describes challenge availability to players.
|
Event Object
The Event object is how you record any actions your users perform, along with any metadata that describe the action. For further elaboration on events check Understand your players' events.
Event and Metadata example:
Event Name | Key | Value |
buy | product_id | a123456 |
| price | 30 |
| product_category | fashion |
| product_tags | men & new_collection |
The following example shows a collection of events
Leaderboard object
Defines the player rank and progress in the leaderboard based on the specified query parameters.
Parameter | Type | Description |
| string | Player's display name. |
| string | Unique identifier for a player at Gameball. |
| integer | Player's progress (based on the specified query parameters). |
| integer | Player's Rank (based on the specified query parameters). |
| string | Level Name. Example: |
| string | Level's icon URL. |
Level Object
Contains information about the player's current level.
Parameters Description
Parameter | Type | Description |
| integer | The required score to reach the level. |
| integer | Level Order |
| string | icon URL of the level. |
| string | Level Name |
| object |
The benefits object is defined as follows:
|
LineItems Object
Represent a Product in your system with its relative information, this object is used in the Orders API.
Attribute | Type | Description |
| string | The ID of the product that the line item belongs to |
| string | The item's SKU (stock keeping unit). |
| string | The title of the product. |
| array | Product category (fashion, electronics.. etc). It can be one category or multiple categories. Example: |
| array | Collection ID(s) to which the product belongs. It can be one collection or multiple collections. This will be also based on the available collections in your store. Example: |
| array | Tag(s) attached to the item in the order. Example: |
| number | Item weight. Must be positive. |
| string | The name of the item's supplier. Example: |
Merchant Object
Holds information of merchant and its branch
Parameters Description
Parameter | Type | Description |
| string | Merchant unique id or code |
| string | Merchant name |
| string | Optional branch information |
| string | Branch unique id or code |
| string | Branch name |
Notification Object
Represents a notification that your player receives.
Attribute | Type | Description |
| string | Unique Identifier for a notification |
| string | Notification Title |
| string | Notification Body |
| boolean | Indicates whether the notification is read or not. |
| string | Notification's creation date, as an ISO8601 timestamp. Example: |
| string | The language in which the notification is displayed. In case the Note: The language provided should be as per configured languages in your account. Example: |
| string | Notification's icon URL. |
Score Object
Contains info about the player's score.
Parameters Description
Parameter | Type | Description |
| string | Player Score |
| string | The naming of the score points that appears to the player. |
PlayerAttributes Object
Contains all of the attributes describing your player.
Parameters Description
Parameter | Type | Description |
| string | Player's display name |
| string | Player's first name |
| string | Player's last name |
| string | Player's gender. Example: M or F, Male or Female. |
| string | Player's email |
| string | Player's mobile |
| string | Player's date of birth Example: |
| string | Player join date at your system. Example: |
| string | Comma separated string of tags to be attached to the player. Example: |
| string | Describe which community a player belongs to. |
| object | Key value pairs of any extra player attributes. {"class" : "E2022", "weight" : 78} |
Points Object
Contains information about the player's points.
Parameters Description
Parameter | Type | Description |
| number | Player Points |
| number | The actual value equivalent to player points. |
| string | Store Currency |
| string | The naming of the rewarding points that appears to the player. |
Referral Object
The referral object is returned in the configurations API response body. It describes the referral program configurations.
Parameter | Type | Description |
| string | Defines how the referral program rewards your players, Possible values:
|
| string | The name of the event which is linked to the referral action |
| string | The event metadata which value should be monitored and checked for completing the referral. |
| object |
An object that defines the referring player's reward. The
|
| object | Defines the referred player reward configurations in case the The object is the same as the |
Transaction object
Describes any transaction made in your system.
Attribute | Type | Description |
| string | Unique transaction ID which identifies the underlying transaction in your system, e.g. order number, invoice number. It will be used for reversing any reward or redemption transaction on Gameball. |
| integer | Transaction ID on Gameball system. |
| string | Transaction type string. Can be one of the following:
|
| string | Either "+" or "-" indicating transaction was an addition or deduction |
| string | Player unique identifier used to uniquely identify the player on Gameball. |
| integer | Number of points involved in the transaction |
| number | Monetary amount involved in the transaction |
| string | Time of transaction in your system in UTC, e.g. order datetime, invoice datetime. Note: Example: |
| string | Merchant name for transaction |
| string | Branch Name for transaction |
Last updated