Analytics CSV Export Format

Fields and Enums Reference

Fields

Note: See "Required Fields Table" for an overview of what other column values are expected in certain situations (e.g. all "interactions" will also come with "category" and "actionType" values)

Available Fields

FieldTypeDescription
trackTimestamptimestampTime
eventIdunsigned integerStreamLayer event id
organizationIdstringOrganization id
userIdstringStreamLayer user id
userExternalIdstringUser id on external system
deviceIdstringUser device id
deviceNamestringUser device name
sessionIdstringUser session id
overlaySessionIdstringStreamLayer overlay session id
topicIdstringID of the chat or question
osstring full os nameVersion of the Operating System of the device
osNamestring os familyName of the Operating System of the device
userAgentstring client user agentDevice metadata
slSdkVersionstringClient SDK version
slProtofilesVersionstring clientSDK protofiles version
routeMapstring
participantsCountunsigned integerNumber of participants at the time of event in question
actionTypeAction TypeGeneral action type
permissionPermissionGeneral permission
categoryCategoryGeneral category
kindKindGeneral kind
notificationNotification KindAdditional kind for notification
notificationTypeNotification TypeAdditional type for notification
screenOrientationScreen OrientationDevice screen orientation
topicTypeTopic TypeGeneral topic type
parentTopicIdstringParent topic id
parentTopicTypeTopic TypeParent topic type
pollOpenedFromPoll Opened FromPoll opened from
fromFromInvitation from

Required Fields Table

Important: All fields should be considered as optional if they do not have a "+" in the table below. The fields eventId and deviceId are required for all kind values.

kindcategoryactionTypeparticipantsCountpermissionnotificationType
VIEWERS+
EVENT_OPENED
LAUNCH_BUTTON
INTERACTIONS++
AUTHENTICATION_ATTEMPTED
AUTHENTICATION_COMPLETED
PERMISSION_PROVIDED+
PERMISSION_NOT_PROVIDED+
CONVERSATION_CREATED++
CONVERSATION_JOINED
CONVERSATION_DELETED++
NEW_CALL++
CALL_JOINED
CALL_FINISHED++
INVITATION_SENT+
INVITATION_ACCEPTED
WAVES_SENT+
WAVES_REPLIES
NOTIFICATION_RECEIVED+++
NOTIFICATION_OPENED+++
SESSION_HEARTBEAT+
CONVERSATION_OPENED++
GROUP_CONVERSATION_OPENED++
GROUP_CALL_JOINED++
POLLS_VOTE+
POLLS_RECEIVED+
POLLS_OPENED+
GAMES_JOINED+

Enums

Enum Kind

All enums values are of unsigned integer type

ValueNameDescription
1VIEWERSInitialization of the SDK button after user opened a new stream
2EVENT_OPENEDDeprecated
3AUTHENTICATION_ATTEMPTEDAuthentication attempt sent
4AUTHENTICATION_COMPLETEDAuthentication attempt completed
5LAUNCH_BUTTONThe launch button has been activated
6PERMISSION_PROVIDEDPermission request accepted
7PERMISSION_NOT_PROVIDEDPermission request has been declined
8INTERACTIONSAny interaction with the overlay besides the launch button
9CONVERSATION_CREATEDA new conversation has been created
10CONVERSATION_JOINEDThe user has joined a conversation
11CONVERSATION_DELETEDThe conversation has been deleted
12NEW_CALLA call has been created
13CALL_JOINEDA call has been joined
14CALL_FINISHEDA call has finished
15INVITATION_SENTAn invitation has been sent
16INVITATION_ACCEPTEDAn invitation has been accepted
17WAVES_SENTA ping has been sent
18WAVES_REPLIESA ping has been replied
19NOTIFICATION_RECEIVEDA notification has been received
20NOTIFICATION_OPENEDA notification has been opened
21SESSION_HEARTBEATA regular track (heartbeat) is sent every 5 seconds while the user is watching an event
22CONVERSATION_OPENEDThe 1-1 chat (UI screen) has been opened
23GROUP_CONVERSATION_OPENEDThe group chat (UI screen) has been opened
24GROUP_CALL_JOINEDA group call has been joined
25KIND_POLLS_VOTEThe user has voted in a poll
26KIND_POLLS_RECEIVEDThe user has received a poll
27KIND_POLLS_OPENEDThe user has opened a poll
28KIND_GAMES_JOINEDA game has been joined

Enum Screen Orientation

ValueNameDescription
0UNSETEmpty value
1PORTRAITPortrait orientation
2LANDSCAPELandscape orientation

Enum Category

ValueNameDescription
0UNSETEmpty value
1STATS_HOMELeaderboard screen initialization
2STATSLeaderboard screen
3TWITTER_HOMETwitter screen initialization
4TWITTERTwitter screen
5MESSAGING_HOMEMessaging screen initialization
6MESSAGINGMessaging screen
7CALLING_HOMECalling screen initialization
8CALLINGCalling screen
9PROFILE_HOMEProfile screen initialization
10PROFILEProfile screen
11WHOISWATCHINGWho's watching screen
12WHOISWATCHING_HOMEWho's watching screen initialization
13INTERSTITIALInterstitial screen
14BETTINGBetting screen
15BETTING_HOMEBetting screen initialization
16INPLAYInplay screen
17INPLAY_HOMEInplay screen initialization
18MERCHANDISEMerchandise screen
19MERCHANDISE_HOMEMerchandise screen initialization
20CONTESTSContests screen
21CONTESTS_HOMEContests screen initialization
22TICKETSTickets screen
23TICKETS_HOMETickets screen initialization
24INVITATIONInvitation screen
25INVITATION_HOMEInvitation screen initialization
26POLLSPolls screen
27POLLS_HOMEPolls screen initialization
28FANTASYFantasy screen
29WPWatch party screen
30HIGHLIGHTS_HOMEHighlights screen initialization
31HIGHLIGHTSHighlights screen

Enum Notification Kind

ValueNameDescription
0UNSETEmpty value
1MESSAGEMessage notification
2CALLCall notification
3TWITTERTwitter notification
4WAVEPing notification
5INPLAYDeprecated
6GROUP_CALLGroup call notification
7MISSED_CALLMissed call notification
8MISSED_GROUP_CALLMissed group call notification
9WATCH_PARTYWatch party notification
10POLLSPolls notification

Enum Notification Type

ValueNameDescription
0UNSETEmpty value
1IN_APPIn-app notification
2PUSHPush notification

Enum Action Type

ValueNameDescription
0UNSETEmpty value
1TAPTap event
2CALLCall event
3MESSAGEMessage event
4SCROLLScroll event

Enum Permission

ValueNameDescription
0UNSETEmpty value
1ADDRESS_BOOKAllow read contacts
2CALLINGAllow calls
3CAMERAAllow take photos and shoot videos

Enum Poll Opened From

ValueNameDescription
0UNSETEmpty value
1IN_APPOpened from in-app notification
2HISTORYDeprecated
3PICK_HISTORYOpened from pick history
4INSIGHT_HISTORYOpened from insight history
5TWEETS_HISTORYOpened from tweets history

Enum From

ValueNameDescription
0UNSETEmpty value
1TITLE_CARDThe invitation comes from the title card
2MENUThe invitation comes from the menu

Enum Topic Type

ValueNameDescription
0UNSETEmpty value
1CALLThe topic is a call
2CHATThe topic is a chat
3FANTASYThe topic is a fantasy
4POLLSDeprecated
5POLLS_POLLThe topic is a poll
6POLLS_TRIVIAThe topic is a trivia
7POLLS_PREDICTIONThe topic is a prediction
8POLLS_INSIGHTThe topic is an insight
9POLLS_TWITTERThe topic is a tweet
10LINKThe topic is a link
11MESSAGEThe topic is a message

Enum Invitation Category

When Enum Kind in (15,16), these are the values for Enum Category

ValueNameDescription
0UNSETEmpty value
1WATCHINGThe invitation is for watching
2MESSAGINGThe invitation is for messaging
3VOICINGThe invitation is for voicing
4GAMESThe invitation is for games

Enum Waves Sent

When Enum Kind in (17,18), these are the values for Enum Category

ValueNameDescription
0UNSETEmpty value
1WATCHINGThe wave is for watching
2MESSAGINGThe wave is for messaging
3VOICINGThe wave is for voicing