Properties

What are Properties?

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.

Event Name	Property Field	Description
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:

Property Name	Description
Customer ID	The users' unique identifier	abc123=
Campaign Source/Medium/Name	When a link directing to your site is using	Google
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

Example Usage

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.

Person	Events	Properties
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.