EventStore Data Guide

[#1]

This article provides a summary of event-level data points made available through EventStore.

In this article:

Table of Contents Placeholder

How it Works

EventStore provides the most efficient way for collecting and exporting event-level data from your site.

Here's how it works:

1. The Tealium Collect tag captures the live event feed on your site and feeds the events to EventStore, which allows you to view and download the underlying data.
2. The captured data is then compressed into a flattened JSON file and made available for download from Tealium’s Amazon S3 bucket. Each JSON object in the file may contain one or more rows of name-value pairs associated with the event.
   

   If you send your event data (event feeds), to another location, such as your S3 bucket or server, the feeds will not display in EventStore.

Data Captured by the Collect Tag

The Collect tag captures a mix of predefined data variables and data from the page, as described in the following sections.

Ignore legacy values prefixed by "_t" in your data log files.

Default Variables

Variable	Description
Visitor ID	The unique ID of the visitor.
Event ID	An alphanumeric identifier unique to the event.
Event Time	The UNIX/epoch timestamp of the event, based on UTC time zone.
User Agent	The user-agent header.

DOM Variables

Variable	Description
dom_domain	Domain of the site.
dom_pathname	Pathname of the URL.
dom_query_string	Querystring portion of the URL following the "?" character.
dom_url	The entire URL of the HTML document.
dom_title	Title of the HTML document.
dom_viewport_width	Device screen width.
dom_viewport_height	Device screen height.

Page URL Variables

Variable	Description
pageurl_scheme	The Uniform Resource Identifier (URI) protocol, such as "http" or"https".
pageurl_domain	Domain of the site.
pageurl_path	Pathname of the URL.
pageurl_querystring	Querystring portion of the URL following the "?" character.
pageurl_query_params_key	For each querystring parameter, there is a data point that contains the parameter key and value.
pageurl_full_url	The URL of the HTML document without querystring parameters.

Referrer URL Variables

Variable	Description
referrerurl_scheme	The URI protocol of referring URL, such as "http" or"https".
referrerurl_domain	Domain of the referring URL site.
referrerurl_path	Pathname of the referring URL.
referrerurl_querystring	Querystring portion of the referring URL following the "?" character.
referrerurl_query_params_key	For each querystring parameter, there is a data point that contains the parameter key and value.
referrerurl_full_url	The entire URL of the referring page.

Tags Executed

Variable	Description
tags_profile_tag-uid_executed	The profile and tag that successfully executed. Each successful tag trigger includes its own entry.

Environment Detail Variables

Variable	Description
Account ut.account	Tealium iQ account.
Profile ut.profile	Tealium iQ profile.
Environment ut.env	The publish environment associated with the utag.js file.

Tealium Built-in Variables

A full list of Tealium built-in variables is provided in the Built-In Data Layer Variables article.

Variable	Description
Event ut.event	The name of the event being tracked, such as a view or link.
Version ut.version	The utag.js version number, followed by the publish timestamp.
Domain ut.domain	The top-level domain of the currently-loaded web page.
tealium_session_number	A duplicate of the existing value in cp.utag_main__sn.
tealium_session_event_number	A new cookie value in cp.utag_main__se that counts the number of utag.link/view/track calls in the current session (visit) Useful for Single Page Apps (SPAs) where there is always 'one page' and many events on that page

First-Party Tealium Cookies

Variable	Description
_ses_id	A unique identifier for the session. Requires utag.js version 4.27 and later.
_st	The time at which the visitor session expires if the visitor does nothing more. This is the visitor's "now" time, plus the session timeout time. This timeout period is normally 30 minutes (1800000 milliseconds) unless configured otherwise. The value of utag.cfg.session_timeout, which can be overridden by changing this variable using a JavaScript Extension. Requires utag.js version 4.26 and later.
_v_id	The ID value unique to the visitor. Requires utag.js version 4.26 and later.
_ss	A flag value indicating the start of session. Values are 0 or 1. Requires utag.js version 4.26 and later.
_pn	The page number value. Starts over at 1 with each new session and increments each time utag.js loads. Requires utag.js version 4.28 and later.
_sn	The session count. Requires utag.js version 4.28 and later.
_dc_visit	Keeps count of visits. Starts as "1" for the first visit.
_dc_event	Keeps count of page views. Starts as "1" for the first page view of a visit.
_dc_region	The AudienceStream region where the visit session resides.

Additional Data Variables

The tag collects a variety of other data from the page, including:

• Data points defined in your data layer. The maximum character length for any one value is 255 characters.
• Webpage elements, such as metadata, cookie parameters, and JavaScript page variables
• Performance timing metrics for gathering Real User Monitoring (RUM) data. This data can be used to understand a user's experience. For example, the browser time to DOM interactive state for pages on your site.
  

  Peformance Timing Variable	Description
  timing.domain	The domain where the timing data was collected.
  timing.pathname	The path name (web page) where the timing data was collected.
  timing.query_string	The query string value in URL where the timing data was collected.
  timing.timestamp	The date/time when the timing data was collected (epoch time of client's web browser).
  timing.dns	t.domainLookupStart
  timing.connect	t.connectStart
  timing.response	t.responseStart
  timing.dom_loading_to_interactive	t.domInteractive - t.domLoading
  timing.dom_interactive_to_complete	t.domComplete minus t.domInteractive
  timing.load	t.loadEventEnd minust.loadEventStart
  timing.time_to_first_byte	t.responseStart minus t.connectEnd
  timing.front_end	t.loadEventStart minust.responseEnd
  timing.fetch_to_response	t.responseStart minus t.fetchStart
  timing.fetch_to_complete	t.domComplete minus t.fetchStart
  timing.fetch_to_interactive	t.domInteractive minust.fetchStart

  
  

  If the value of a data point equals zero (0), no timing information was captured. You can ignore the zero values when reporting or averaging.

Calculating Visitor Timezone

The timezone for a visitor is not sent in the EventStore data. You can calculate the timezone by viewing the difference between EventTime and _ses_id on the record where _ss is 1, since that record is the start of the session.

If utag.cfg.session_timeout is known, you can calculate the current local time for the user by subtracting utag.cfg.session_timeout from _st, and then calculating the timezone by looking at the difference between the current time and EventTime. This approach can be used for any record.

Individual utag.js Versions

For detailed information about individual utag versions, see the utag.js Release Notes.

Sample JSON Object

{
    "visitorid": "014fb34a718e001ad754191d58ff1c074003a06c00c48",
    "eventid": "65f61a4b-54ca-4adf-b757-657e1711f6e7",
    "eventtime": 1441822083000,
    "useragent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_5) AppleWebKit/600.8.9 (KHTML, like Gecko) Version/8.0.8 Safari/600.8.9",
    "dom_domain": "tealium.com",
    "dom_pathname": "/products/audiencestream/",
    "dom_query_string": "",
    "dom_url": "http://tealium.com/products/audiencestream/",
    "dom_title": "AudienceStream | Real-time Data Action Engine | Tealium",
    "dom_viewport_width": "1670",
    "dom_viewport_height": "1059",
    "pageurl_scheme": "http",
    "pageurl_domain": "tealium.com",
    "pageurl_path": "/products/audiencestream/",
    "pageurl_querystring": "",
    "pageurl_full_url": "http://tealium.com/products/audiencestream/",
    "referrerurl_scheme": "https",
    "referrerurl_domain": "google.com",
    "referrerurl_path": "",
    "referrerurl_querystring": "",
    "referrerurl_full_url": "https://www.google.com/",
    "tags_tiq_as_3_executed": true,
    "tags_tiq_as_1_executed": true,
    "udo_ut_account": "tealium",
    "udo_ut_profile": "main",
    "udo_ut_env": "prod",
    "udo_ut_event": "view",
    "udo_ut_version": "ut4.39.201509091709",
    "udo_ut_domain": "tealium.com",
    "firstpartycookies_utag_main_ses_id": "1441822044558",
    "firstpartycookies_utag_main__st": "1441823881730",
    "firstpartycookies_utag_main_v_id": "014fb34a718e001ad754191d58ff1c074003a06c00c48",
    "firstpartycookies_utag_main__ss": "0",
    "firstpartycookies_utag_main__pn": "2",
    "firstpartycookies_utag_main__sn": "1",
    "firstpartycookies_utag_main_dc_visit": "1",
    "firstpartycookies_utag_main_dc_event": "2",
    "firstpartycookies_utag_main_dc_region": "us-west-1",
    "firstpartycookies__gat": "1",
    "firstpartycookies__ga": "GA1.2.2095105468.1441822080",
    "js_page.is_mobile": "false",
    "js_page.is_tablet": "false",
    "device_type": "desktop",
    "udo_page_name": "AudienceStream | Real-time Data Action Engine | Tealium",
    "udo_site_name": "Tealium",
    "udo_site_description": "Tag Management and Audience Segmentation",
    "udo_page_type": "page",
    "udo_post_author": "tealium",
    "udo_post_date": "2014/11/26",
}

Performance Timing Metrics

For additional information about performance timing metrics, see:

• http://calendar.perfplanet.com/2011/a-practical-guide-to-the-navigation-timing-api/
• http://engineering.tripadvisor.com/html5-navigation-timing/