Tracking analytics data

Ease Live Analytics enables you to capture data on how users interact with your interactive broadcast overlays.

You can specify any measure name to track a button, UI section - whatever you'd like.

User ID

Ease Live only sets one cookie by default, and that is an auto generated UUID (Example: a30808bb-cb01-417e-a2f0-35e71ba82b65) that helps us identify the same user across sessions, to be able to count concurrency per game, unique users per game etc.

Built-in measure names

Measure name	Description	Example
ping	Sent every minute	-
sessionStart	Sent once per session when user joins	-
sessionActive	Sent once per session when the user interacts with something	-
sessionInfo	Sent once per session when user joins	Example
deviceInfo	Sent once per session when user joins	Example

Example sessionInfo

{
  "session_info_project_name": "Script Reference",
  "session_info_webapp_url": "http://tutorials.studio.easelive.tv/live/index.html?accountId=tutorials&projectId=6c92994c-6b17-4905-8481-e09cd779a72c&foo=foo1&bar=bar2&baz=baz3&programId=e6c5b13a-2fd8-40e3-9d65-4d1062da075f&timecodeSupport=false",
  "session_info_hostname": "tutorials.cloud.easelive.tv",
  "session_info_program_name": "Sample Program",
  "session_info_program_start_time": "2022-09-05T22:00:00.000Z",
  "session_info_program_end_time": "2022-09-05T23:00:00.000Z",
  "measure_name": "sessionInfo",
  "measure_value": 1
}

Example deviceInfo

{
    "device_info_type": "desktop",
    "device_info_os": "macos",
    "device_info_browser": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/116.0.0.0 Safari/537.36",
    "device_info_width": "1465",
    "device_info_height": "435",
    "device_info_resolution": "2560x1415",
    "device_info_language": "en-US",
    "device_info_orientation": "landscape",
    "measure_name": "deviceInfo",
    "measure_value": 1
}

Dimensions

All measure names and values will be accompanied by the following dimensions:

Column	Description	Example	Type
response_id	String to be able to recognise response for specific question selected by user during live broadcast.	UUID	Dimension
program_id	String to be able recognise one game (for example "New York Islanders (NYI) at Carolina Hurricanes (CAR)")	UUID	Dimension
session_id	String to be able recognise one session.	UUID	Dimension
device_type	String to be able recognise device type (for example phone, desktop).	phone, desktop, tablet, tv, unknown	Dimension
device_os	String to be able recognise device os (for example mac or windows).	mac, window, linux, roku, appletv, unknown	Dimension
version	Internal version of the graphics project used in our Studio tool.	1 (any incremental number) or draft	Dimension
account_id	String to be able recognise account. Should always be ballysports.	<account_id>	Dimension
project_id	String to be able recognise project (for example NBA, NHL).	UUID	Dimension
stream_id	String to be able recognise different streams (for example two different videos).	Default value is main	Dimension
user_id	String to be able recognise specific user.	UUID or customer supplied user id	Dimension
context_id	String to be able to identify one data event from another (for example two different Polls)	UUID	Dimension
created_time	UTC realtime when we insert data to db.	2023-04-17 13:52:34.309000000	Time
player_time	UTC time received from player (example: 40s behind realtime)	2023-04-17 13:52:34.309000000	Time
time	UTC realtime when the event was captured on the device	2023-04-17 13:52:34.309000000	Time
interaction	Value to be able to recognise if the user is active or not when the tracking was made	0 or 1	bigint
measure_name	Event measure name (example: pollShow, pollHide, pollResponse)	pollShow	Name
measure_value::bigint	Value of the measure name (if bigint).	1	Value (bigint)
measure_value::varchar	Value of the measure name (if varchar).	Any string	Value (varchar)