Business Events
Business events capture real-money, in-app purchases (IAP) made by users, including receipt validation on GameAnalytics’ servers.
info
These events must be manually implemented. Refer to the SDK Documentation for code examples specific to your platform.
| Field | Description | Type | Possible Values | Required |
|---|---|---|---|---|
| category | Event category | string | business | Yes |
| cart_type | The location in the game where the purchase was made | string | E.g. shop, end_of_level, tutorial_pop_up | No |
| item_type | The type/category of the item | String | Max 64 characters | Yes |
| item_id | The specific item bought | string | Max 64 characters | Yes |
| amount | The amount of the urchase, in cents | Integer | E.g. 99 (for $0.99) | Yes |
| currency | The currency (real money) used to make the purchase | string | Currency code in ISO 4217 format, e.g. USD, EUR | Yes |
| receipt | The app store receipt | string | See IAP Purchase Validation and specific SDK documentation for more information. | No |
| signature | The purchase validation signature | string | See IAP Purchase Validation and specific SDK documentation for more information. | No |
Business Event Examples​
| Field | Example A: A user purchases a pack of coins in the shop | Example B: A user purchases extra lives from a prompt at the end of a level | Example C: A user purchases a starter pack during the FTUE |
|---|---|---|---|
| category | business | business | business |
| cart_type | shop | end_of_level | tutorial_prompt |
| item_type | coin_pack | lives | starter_pack |
| item_id | coint_pack_2 | life_pack_3 | starter_pack_7 |
| amount | 99 | 99 | 299 |
| currency | USD | USD | EUR |
info
If a player purchase coins with real-money, send both a Business event and a Resource event (source) to track the economy flow.