Skip to main content

Snowplow event specification

At its heart, Snowplow is a platform for granular tracking of events. Snowplow trackers fire events, which are either HTTP GET or POST requests to a Snowplow collector. By adding parameters to these requests, trackers can pass data into the collector for processing by Snowplow.

This section aims to give an overview of Snowplow events. It lists the available data types and links to the tracking and modeling documentation for them. If you are interested in an overview of the properties in the atomic events table, please refer to this page.

Custom events and context entities​

Snowplow data is designed to be able to tailor to your business needs using custom events and context entities.

CategoryDescription
Context entitiesAdd information to events using reusable entities.
Self-describing eventsTrack custom events with schemas.
Structured eventsTrack custom events without schemas (not recommended – we recommend tracking self-describing events instead).

Out-of-the-box data​

Snowplow also provides out-of-the-box events, context entities and atomic event properties for common Web and mobile use cases.

CategoryDescription
Page and screen view eventsBasic building block for tracking views of Web pages or mobile screens.
Page activity eventsTracking user engagement on the Web page using page pings.
Mobile app lifecycle eventsEvents to track mobile app lifecycle (install, going to foreground, background).
Referrers, deep links and cross-navigation eventsEvents and properties to track referrer information and linking between apps and websites.
App error eventsTracking errors and exceptions from apps.
Consent eventsEvents for tracking user consent.
E-commerce eventsEvents for tracking e-commerce transactions and more.
Media eventsTracking media playback in Web or mobile apps.
Performance metricsEvents to track performance metrics from websites and apps.
App informationInformation about the app that the events originate from.
Device and browser informationInformation about the device or browser of the user.
User and session identification and stitchingOverview of the user and session identifiers provided by the trackers and how to stitch them.
Geolocation informationGeolocation information attached to events.
Going deeper into the event properties

These pages are for you if you want to understand the tracker payload in more detail, and especially if you are building your own tracker. In the latter case, utilizing the parameters documented here will ensure that your tracker works with the rest of the Snowplow stack.

CategoryDescription
Event parametersProtocol of all the parameters in the event payload.
HTTP headersCollecting HTTP request headers and cookies.
Example requestsExample tracker requests with sample payload.