App Events

App events track various actions performed within an application. These events can be used for user segmentation and analytics. Some events are triggered automatically, while others require manual firing.

Event List


Event Name	Description	Manual Trigger
Application Installed	Automatically triggered when a user installs the application.	No
Application Opened	Automatically triggered when a user opens the application.	No
Application Updated	Automatically triggered when the app gets updated.	No
Application Backgrounded	Should be sent when a user backgrounds the app.	Yes (iOS) No (Android)
Application Crashed	Should be sent when the app crashes.	Yes
Application Uninstalled	Should be sent when the app is uninstalled.	Yes
Application Session Started	Automatically triggered when a user spends 10+ seconds in the app.	No
Application Session Concluded	Automatically triggered after 20 minutes of user inactivity.	No

Event Examples

Application Installed

Triggered automatically when the app is installed.

Properties:


Property	Type	Description
`userId`	String	Unique ID of the user
`type`	String	Type of event (`track` in this case)
`event`	String	Name of the event
`properties`	Object	Additional data (e.g., app version, build number).

Example:

{
  "userId": "019mr8mf4r",
  "type": "track",
  "event": "Application Installed",
  "properties": {
    "version": "1.2.3",
    "build": "1234"
  }
}

Application Opened

Triggered automatically when the app is opened.

Properties:


Property	Type	Description
`from_background`	String	If application transitioned from "Background" to "Inactive" state prior to foregrounding (as opposed to from "Not Running" state).
`referring_application`	String	The value of `UIApplicationLaunchOptionsSourceApplicationKey` from `launchOptions`. Automatically collected on iOS only.
`url`	String	The value of `UIApplicationLaunchOptionsURLKey` from `launchOptions`.Collected on iOS only.
`version`	String	The version installed.
`build`	String	The build number of the installed app.

Example:

    {
  "userId": "019mr8mf4r",
  "type": "track",
  "event": "Application Opened",
  "properties": {
    "from_background": false,
    "referring_application": "GMail",
    "url": "url://location"
  }
}

Application Updated

Triggered automatically when the app gets updated.

Properties:


Property	Type	Description
`previous_version`	String	The previously recorded version.
`previous_build`	String	The previously recorded build.
`version`	String	The new version.
`build`	String	The new build.

Example:

{
  "userId": "019mr8mf4r",
  "type": "track",
  "event": "Application Updated",
  "properties": {
    "previous_version": "1.1.2",
    "previous_build": "1234",
    "version": "1.2.0",
    "build": "1456"
  }
}

Application Background

Manually triggered when the user backgrounds the application.

Properties:


Property	Type	Description
`userId`*	String	Unique ID of the user
`type`*	String	Type of the event (`track` in this case)
`event`*	String	Name of the event
`properties`	Object	Additional properties of the event

Example:

{
  "userId": "019mr8mf4r",
  "type": "track",
  "event": "Application Backgrounded",
  "properties": {} //add any properties you like
}

Application Uninstalled

Manually triggered when the app is uninstalled.

Example:

{
  "userId": "019mr8mf4r",
  "type": "track",
  "event": "Application Uninstalled",
  "properties": {} //add any properties you like
}

Application Crashed

Manually triggered when the app crashes.

Example:

{
  "userId": "019mr8mf4r",
  "type": "track",
  "event": "Application Crashed",
  "properties": {} //add any properties you like
}

Application Session Started

Automatically triggered when a user spends more than 10 seconds in the app.

Example:

{
  "userId": "019mr8mf4r",
  "type": "track",
  "event": "Application Session Started"
}

Application Session Concluded

Automatically triggered after 20 minutes of inactivity, or when a session ends.


Property	Type	Description
`userId`*	String	Unique ID of the user
`type`*	String	Type of the event (`track` in this case)
`event`*	String	Name of the event
`properties`	Object	Additional properties of the event

Example:

{
  "userId": "019mr8mf4r",
  "type": "track",
  "event": "Application Session Concluded",
  "properties": {
    "length": "45000",
    "sessionId": "f92j2tj",
    "lastEventTimestamp": "1638458316949" 
  }
}

properties definition:


`length`	String	Total session length in seconds.
`sessionId`	String	Unique ID identifier for the session.
`lastEventTimestamp`	String	The timestamp of the last event recorded before inactivity.