DocumentationExperience PlatformExperience Data Model (XDM) Guide

Environment data type

Last update: January 31, 2025
  • Topics:
  • Schemas

CREATED FOR:

  • Developer

Environment is a standard XDM data type that describes the surrounding environment of an observed event, specifically detailing transitory information such as network and software versions.

IMPORTANT
All values should be aligned with the DeviceAtlas database, licensed by Adobe.

PropertyData typeDescription
_dcObjectAn object that contains a single field, language, which indicates the language of the environment to represent the user’s linguistic, geographical, or cultural preferences for data presentation. Languages are specified in language code as defined in IETF RFC 3066.
browserDetailsBrowser detailsDescribes the browser-specific details of the environment, such as browser name, version, JavaScript version, user agent string, and accept language.
ISPStringThe name of the user’s internet service provider.
carrierStringThe name of the mobile network carrier or MNO (also known as a wireless service provider, wireless carrier, cellular company, or mobile network carrier) that sells and delivers communication services to to the user.
colorDepthIntegerThe number of bits used for each color component of a single pixel.
connectionTypeString

The internet connection type. Accepted values include:

  • dialup
  • isdn
  • bisdn
  • dsl
  • cable
  • wireless_wifi
  • mobile
  • mobile_edge
  • mobile_2g
  • mobile_3g
  • mobile_lte
  • t1
  • t3
  • oc3
  • lan
  • modem
domainStringThe domain of the user’s ISP.
ipV4StringThe numerical label assigned to a device participating in a computer network that uses the Internet Protocol for communication (32-bit).
ipV6StringThe numerical label assigned to a device participating in a computer network that uses the Internet Protocol for communication (128-bit).
operatingSystemStringThe name of the operating system used when the observation was made. The attribute should not contain any version information such as 10.5.3, but instead contain “edition” designations such as Ultimate or Professional.
operatingSystemVendorStringThe name of the operating system vendor used when the observation was made.
operatingSystemVersionStringThe full version identifier for the operating system used when the observation was made. Versions are generally numerically composed but may be in a vendor-defined format.
typeStringThe type of the application environment. See the appendix for accepted values.
viewportHeightIntegerThe vertical size in pixels of the window the experience was displayed inside. For a web-view event, this is the browser viewport height.
viewPortWidthIntegerThe horizontal size in pixels of the window the experience was displayed inside. For a web-view event, this is the browser viewport width.

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

  • Populated example
  • Full schema

Appendix

The following section contains additional information about the Device data type.

Accepted values for type

The following table outlines the accepted values for type and their associated meanings:

ValueDescription
browserBrowser
applicationApplication
iotInternet of things
externalExternal system
widgetApplication extension
recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07