Skip to main content

App & tracker information

Information about the app and the tracker instance that the events originate from is tracked using:

  1. Atomic event properties
  2. Application context entity on mobile apps

Atomic event properties​

These properties can be assigned across all our trackers regardless of the platform.

Atomic table fieldTypeDescriptionExample values
name_trackertextThe tracker namespacetracker_1
app_idtextUnique identifier for website / applicationsnow-game-android
platformtextThe platform the app runs onweb,Β mob,Β app
v_trackertextIdentifier for Snowplow tracker. The format follows the convention of TRACKER_NAME-TRACKER_VERSIONjs-2.16.2
Tracker namespace

The tracker namespace parameter is used to distinguish between different trackers. The name can be any string thatΒ does notΒ contain a colon or semi-colon character. Tracker namespacing allows you to run multiple trackers, pinging to different collectors.

How to track?​

You can specify the tracker namespace and app ID when creating a new tracker instance (the newTracker call in the JavaScript and Snowplow.createTracker in mobile trackers). The tracker platform is set automatically but can be overriden in most of our trackers. The tracker version is also set automatically.

Application context entity on Web apps​

This context entity is tracked with events tracked using the JavaScript tracker starting from version 4.1.0. The application version is provided in the tracker configuration, see instructions here.

Context entity: application

Schema for an application context which tracks the app version.

Schema URI:iglu:com.snowplowanalytics.snowplow/application/jsonschema/1-0-0

WebMobileTracked automatically
βœ…βŒβŒ
πŸ‘€ Example
{
"version": "1.1.0"
}
πŸ“ƒ Schema properties definition
PropertyTypeDescriptionRequired?
version"string"Version of the application. Can be a semver-like structure (e.g 1.1.0) or a Git commit SHA hash.βœ…

Application context entity on mobile apps​

This context entity is automatically tracked with events on mobile apps and gives information about the app version and build number.

Context entity: application

Schema for an application context which automatically tracks version number and build name when using our mobile SDK's.

Schema URI:iglu:com.snowplowanalytics.mobile/application/jsonschema/1-0-0

WebMobileTracked automatically
βŒβœ…βœ…
πŸ‘€ Example
{
"version": "1.1.0",
"build": "s9f2k2d"
}
πŸ“ƒ Schema properties definition
PropertyTypeDescriptionRequired?
version"string"Version number of the application e.g 1.1.0βœ…
build"string"Build name of the application e.g s9f2k2d or 1.1.0 betaβœ…

How to track?​

It is tracked on our iOS and Android trackers as well as on the React Native and Flutter tracker (when used in iOS or Android).