Application data type

Application is a standard Experience Data Model (XDM) data type that describes details related to the application generated interactions. An application refers to a software experience, such as a mobile or desktop application that can be installed, run, closed, or uninstalled by an end user. The properties for this data type are not intended to describe agents such as chatbots, browser-based plugins, or other experiences that do not apply to applications.


Property Data type Description
applicationCloses Measure Describes details on the termination of an application.
crashes Measure This property triggers when the application does not exit as intended.
featureUsages Measure Describes any data from the activation of an application feature that being measured.
firstLaunches Measure Contains data on the first launch. This property is triggered on first launch after an installation.
installs Measure Records the installation of an application on a device when a specific installation event is available.
launches Measure Describes a value associated with the launch of an application. This is triggered on every run, including crashes, installs, and resuming from background when the session timeout has been exceeded.
upgrades Measure Contains data on the upgrade of an application that has previously been installed. This is triggered on the first launch after an upgrade.
id String A unique identifier for the application.
name String The name of the application.
userPerspective String The perspective or physical relationship between the user and the app or brand at the time an event happened. Understanding the perspective of the user in relation to the app helps with accurately generating sessions as the majority of the time you will not want to include background and detached events as part of an “active” session. The value of this property must be equal to one of the enum values listed below.
  • foreground: The user and app are directly interacting with one another.
  • background: The app and user are indirectly interacting with one another. For example, the app could measure a value and refresh while the screen is locked or another app is being used in the foreground.
  • detached: Detached means the event was related to the app but didn’t come directly from the app, such as the sending of an email or push notification from an external system.
  • version String The version of the application.

    For more details on the data type, refer to the public XDM repository:

    On this page