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 NameProperty FieldDescription

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 NameDescription

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.

PersonEventsProperties

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.

Last updated