Properties
Last updated
Last updated
Properties are additional meta data and information that can be attached to users and their actions. Using properties allows you to segment reports and provide deep dice into your data.
Properties are passed as key-value pairs.
For example for the provided above Event examples this could be some properties that can be used.
All events also pass a property of "_t" which stands for timestamp. This way that all the events a have specific timestamp that can be used in reporting and deep-dives. You may decide to override this timestamp if you are importing historical data of your game.
User Signed Up
Session UUID
Can be assigned in the start of the game session and reused until the game is closed. Ex: 3ea50ebf-0f4c-4238-b2a7-d6683e37e7c9
Operating System
Can be assigned based on the platform the game is open on. Ex: PC, PS4, PS5, Windows, MacOS
In-App Purchase
Session UUID
Can be assigned in the start of the game session and reused until the game is closed. Ex: 3ea50ebf-0f4c-4238-b2a7-d6683e37e7c9
Item Category
Assigned based on Item Category Ex: Equipment
Item Name
Assigned based on the Item purchased. Ex: Cyber Punk Sword
Item Price
Assigned based on the purchase price of the item. Ex: 5.99
Level Started
Session UUID
Can be assigned in the start of the game session and reused until the game is closed. Ex: 3ea50ebf-0f4c-4238-b2a7-d6683e37e7c9
Level Name
Can be assigned based on the level the user started. Ex: Level 1
Level Completed
Session UUID
Can be assigned in the start of the game session and reused until the game is closed. Ex: 3ea50ebf-0f4c-4238-b2a7-d6683e37e7c9
Level Name
Can be assigned based on the level the user completed. Ex: Level 1
Visited Area
Session UUID
Can be assigned in the start of the game session and reused until the game is closed. Ex: 3ea50ebf-0f4c-4238-b2a7-d6683e37e7c9
Area Name
Can be assigned based on the level the user visited in a level area. Ex: Forest Area
Quest Started
Session UUID
Can be assigned in the start of the game session and reused until the game is closed. Ex: 3ea50ebf-0f4c-4238-b2a7-d6683e37e7c9
Quest Name
Can be assigned based on the Quest Started. Ex: Find the Farmer
Quest Completed
Session UUID
Can be assigned in the start of the game session and reused until the game is closed. Ex: 3ea50ebf-0f4c-4238-b2a7-d6683e37e7c9
Quest Name
Can be assigned based on the Quest Completed. Ex: Find the Farmer
Earned XP
Session UUID
Can be assigned in the start of the game session and reused until the game is closed. Ex: 3ea50ebf-0f4c-4238-b2a7-d6683e37e7c9
XP Amount
Can be assigned based on the total amount of XP Amount earned. Ex: 500
If you are using JavaScript to track on a webapp or game, you will automatically track some properties:
Customer ID
The users' unique identifier
abc123=
Campaign Source/Medium/Name
When a link directing to your site is using
Referrer
The URL that the visitor came from
referrerdomain.com/blog/post-1
Landing Page
The first page a user visited at the start of a session
mygamesite.com
Returning
Whether the user is new or returning
Returning
Device Type
This is the device being used by the user
Computer vs Smartphone vs Tablet
Device Category
The type of device the user is operating
Computer vs Mobile
Screen Resolution
The size of the user's screen
1280x800
Operating System
Operating system of the above device
Mac OS X
Operating System Version
The version of the above operating system
Mac OS X 10.11.6
Brower
This is the browser that is being used by the user
Safari
Browser Version
The browser and version the user is running
Safari 8.1
City
The city from where the user is visiting your site
San Francisco
Region
The state or region from where the user is visit your site
California
Country
The country from where the user is visiting your site
United State
Continent
This is the Continent from where the user is visiting your site
North America
Now that you understand these concepts separately, let's show you how they all work together.
Steve is a first-time users on your game. He originally arrived to your game site from a post he saw about how great your game is. While he was on the site he downloaded the game and signed up. He Immediately fell in love with the game and purchased the Battle Pass the game had offered. He later on start the game and completed the first level of the game.
Steve
Visited Sited
Returning: No Referrer: https://gameblog.com
User Signed Up
Session UUID: 3ea50ebf-0f4c-4238-b2a7-d6683e37e7c9 Operation System: iOS
In-App Purchase
Item Category: Battle Passes Item Name: Season - 1 Gold Pass Item Price: 5.99
Level Started
Session UUID: 3ea50ebf-0f4c-4238-b2a7-d6683e37e7c9 Level Name: Level 1
Level Completed
Session UUID: 3ea50ebf-0f4c-4238-b2a7-d6683e37e7c9 Level Name: Level 1
So, to wrap up this section. You can trigger any number of events for a specific user and assign any number of properties. All events and properties assigned to that user or users can later be used to segment users based on their behaviors and actions.