Fields reference (pageview)

The list of descriptions of the JavaScript error events. Each event has the same index in all errors.* fields.

Data typeExample value
Array(String)[‘Uncaught Error: Mismatched anonymous define() module…’, ‘Uncaught TypeError: Cannot read properties of undefined’]

The list of timestamps of the JavaScript error events. Each event has the same index in all errors.* fields.

Data typeExample value
Array(String)[‘2020-07-11 18:55:41’,‘2020-07-11 18:55:42’]

The list of URLs of the files where the JavaScript error events occurred. Each event has the same index in all errors.* fields.

Data typeExample value
Array(String)[‘https://some.site.com/static/scripts/somelib.js’,‘https://someother.site.com/static/scripts/someotherlib.js’]

The list of line numbers in the files where the JavaScript error events occurred. Each event has the same index in all errors.* fields.

Data typeExample value
Array(Number)[2, 1998]

The list of column numbers in the files where the JavaScript error events occurred. Each event has the same index in all errors.* fields.

Data typeExample value
Array(Number)[55, 44]

The list of Group IDs of the JavaScript error events, used to regroup similar errors together in Contentsquare. Each event has the same index in all errors.* fields.

Data typeExample value
Array(Number)[2406037528566246307, 17923195893144918451]

This field is only available for CS Find & Fix clients who have access to the API errors feature. Contact your CSM if you don’t have access to this feature.

The list of URL endpoints of the API error events. Each event has the same index in all errors_api.* fields.

Data typeExample value
Array(String)[‘https://some.site.com/login’, ‘https://someother.site.com/login’]

This field is only available for CS Find & Fix clients who have access to the API errors feature. Contact your CSM if you don’t have access to this feature.

The list of HTTP method of the API error events. Each event has the same index in all errors_api.* fields.

Data typeExample value
Array(String)[‘GET’, ‘POST’]

This field is only available for CS Find & Fix clients who have access to the API errors feature. Contact your CSM if you don’t have access to this feature.

The list of HTTP status codes of the API error events. Each event has the same index in all errors_api.* fields.

Data typeExample value
Array(Number)[500, 501]

This field is only available for CS Find & Fix clients who have access to the API errors feature. Contact your CSM if you don’t have access to this feature.

The list of the API call start timestamps of the API error events. Each event has the same index in all errors_api.* fields.

Data typeExample value
Array(String)[‘2023-01-19 01:50:36’, ‘2023-01-21 01:50:36’]

This field is only available for CS Find & Fix clients who have access to the API errors feature. Contact your CSM if you don’t have access to this feature.

The list of Group IDs of the API error events, used to regroup similar errors together in Contentsquare. Each event has the same index in all errors_api.* fields.

Data typeExample value
Array(Number)[2406037528566246307, 17923195893144918451]

This field is only available for CS Find & Fix clients who have access to the custom errors feature. Contact your CSM if you don’t have access to this feature.

The list of descriptions of the custom error events. Each event has the same index in all custom_errors.* fields.

Data typeExample value
Array(String)[‘An error happened’, ‘Another error happened’]

This field is only available for CS Find & Fix clients who have access to the custom errors feature. Contact your CSM if you don’t have access to this feature.

The list of timestamps of the custom error events. Each event has the same index in all custom_errors.* fields.

Data typeExample value
Array(String)[‘2023-01-19 01:50:36’, ‘2023-01-20 01:50:36’]

This field is only available for CS Find & Fix clients who have access to the custom errors feature. Contact your CSM if you don’t have access to this feature.

The list of key/value pairs of custom tags of the custom error events. Each event can have a list of several key/value pairs. Each event has the same index in all custom_errors.* fields.

Data typeExample value
Array(Array(String))[[(‘severity’, ‘high’), (‘category’, ‘login’)]]

This field is only available for CS Find & Fix clients who have access to the custom errors feature. Contact your CSM if you don’t have access to this feature.

The list of Group IDs of the custom error events, used to regroup similar errors together in Contentsquare. Each event has the same index in all custom_errors.* fields.

Data typeExample value
Array(Number)[2406037528566246307, 17923195893144918451]

If we got all kinds of events (clicks, mouse moves etc.) on the page, value is 1, else 0.

Data typeExample value
Integer0

List of page events.

Data typeExample value
Array(String)[‘Config: Release_20201112’,‘FB_MD_Feedback Submitted’]

The list of the dates and UTC times of the click events. Each event has the same index in all raw_click.* fields.

Data typeExample value
String[‘2020-07-26 05:53:04’, ‘2020-07-26 05:54:22’]

The list of the raw events types. Can be either:

  • 5: CLICK
  • 10: CHANGE
  • 11: FOCUS
  • 12: BLUR

Each event has the same index in all raw_click.* fields.

Data typeExample value
Array(Integer)[5, 11]

Number of milliseconds between the beginning of the view and each of the raw events. Each event has the same index in all raw_click.* fields.

Data typeExample value
Array(Integer)[3981, 1782]

Whether the event was an interaction with a blank field in a form. Can be either:

  • 0: Not applicable
  • 1: False
  • 2: True

Each event has the same index in all raw_click.* fields.

Data typeExample value
Array(Integer)[1, 2]

The list of the paths that were clicked. Each event has the same index in all raw_click.* fields.

Data typeExample value
Array(String)[‘html
(0)>form
(0)>div
(0)>button
(0)’, ‘html
(0)>button
(0)‘]

The list of the paths of the target zone. Each target has the same index in all targets_clicks.* fields.

Data typeExample value
Array(String)[‘html
(0)>form
(0)>div
(0)>button
(0)’, ‘html
(0)>button
(0)‘]

The number of times the target was clicked on (aggregation of raw_clicks). Each target has the same index in all targets_clicks.* fields.

Data typeExample value
Array(Integer)[2, 1]

targets_clicks.time_before_msec

Section titled targets_clicks.time_before_msec

The delay between the loading of the page and the time the user clicked on the target for the first time (in milliseconds). Each target has the same index in all targets_clicks.* fields.

Data typeExample value
Array(Integer)[779, 391]

targets_clicks.time_between_last_hover_and_first_click

Section titled targets_clicks.time_between_last_hover_and_first_click

Time before last hover and first select the target (in milliseconds). Each target has the same index in all targets_clicks.* fields.

Data typeExample value
Array(Integer)[13533, 30791]

List of the raw path of the targets. Each target has the same index in all targets_focus.* fields.

Data typeExample value
Array(String)[‘html
(0)>form
(0)>div
(0)>button
(0)’, ‘html
(0)>button
(0)‘]

List of the number of times the target was focused on. Each target has the same index in all targets_focus.* fields.

Data typeExample value
Array(Integer)[2, 5]

targets_focus.time_before_msec

Section titled targets_focus.time_before_msec

List of times before first focus on a zone (in milliseconds). Each target has the same index in all targets_focus.* fields.

Data typeExample value
Array(Integer)[13533, 30791]

List of the raw path of the targets. Each target has the same index in all targets_hover.* fields.

Data typeExample value
Array(String)[‘html
(0)>form
(0)>div
(0)>button
(0)’, ‘html
(0)>button
(0)‘]

List of the number of times the target was hovered on. Each target has the same index in all targets_hover.* fields.

Data typeExample value
Array(Integer)[2, 5]

List of the total time the target was hovered on (in milliseconds). Each target has the same index in all targets_hover.* fields.

Data typeExample value
Array(Integer)[2563 ,252]

targets_hover.time_before_msec

Section titled targets_hover.time_before_msec

List of times before first hover on a zone (in milliseconds). Each target has the same index in all targets_hover.* fields.

Data typeExample value
Array(Integer)[13533, 30791]

Those fields are only exportable for projects with an access to the frustration score in Contentsquare.

A normalized score between 0 and 1 to indicate whether any API error occurred on the page. This field is only exportable for projects with an access to the frustration score in Contentsquare.

Data typeExample value
Float0.27

A normalized score between 0 and 1 to indicate whether any JavaScript error occurred on the page. This field is only exportable for projects with an access to the frustration score in Contentsquare.

Data typeExample value
Float0.27

A normalized score between 0 and 2 to indicate whether API errors occurred after some clicks. This field is only exportable for projects with an access to the frustration score in Contentsquare.

Data typeExample value
Float0.27

A normalized score between 0 and 2 to indicate whether excessive hovers occurred on the page. This field is only exportable for projects with an access to the frustration score in Contentsquare.

Data typeExample value
Float1.64

A normalized score between 0 and 100 computed based on all other frustration indicators, to express an overall frustration level on the page. This field is only exportable for projects with an access to the frustration score in Contentsquare.

Data typeExample value
Float0.27

Whether the page is considered watchable (1) or not (0). Only pages that are watchable have a frustration score. To be considered watchable, the page view must respect the following conditions:

  • Be part of a collected session (is_recorded = 1)
  • Its duration should be at least 2 seconds
  • There should be at least 2 clicks on the page

This field is only exportable for projects with an access to the frustration score in Contentsquare.

Data typeExample value
Integer0

A normalized score between 0 and 2 to indicate whether any JavaScript error occurred after clicks on the page. This field is only exportable for projects with an access to the frustration score in Contentsquare.

Data typeExample value
Float1.64

A normalized score between 0 and 1 to indicate whether loading time was slow on the page. This field is only exportable for projects with an access to the frustration score in Contentsquare.

Data typeExample value
Float0.27

multiple_button_interaction_ind

Section titled multiple_button_interaction_ind

A normalized score between 0 and 2 to indicate multiple interactions on button targets on the page. This field is only exportable for projects with an access to the frustration score in Contentsquare.

Data typeExample value
Float1.64

multiple_field_interaction_ind

Section titled multiple_field_interaction_ind

A normalized score between 0 and 2 to indicate multiple interactions on field targets on the page. This field is only exportable for projects with an access to the frustration score in Contentsquare.

Data typeExample value
Float1.64

A normalized score between 0 and 1 to indicate multiple interactions on targets on the page. This field is only exportable for projects with an access to the frustration score in Contentsquare.

Data typeExample value
Float0.27

A normalized score between 0 and 1 to indicate low activity on the page. This field is only exportable for projects with an access to the frustration score in Contentsquare.

Data typeExample value
Float0.27

A normalized score between 0 and 2 to indicate rage clicks (multiple clicks in a short time frame). This field is only exportable for projects with an access to the frustration score in Contentsquare.

Data typeExample value
Float1.64

City associated to the user.

Data typeExample value
StringParis

Country associated to the user.

Data typeExample value
StringFR

Language associated to the user.

Data typeExample value
Stringfr

Unique project identifier.

Data typeExample value
Integer42

Unique user identifier. This is the hash of the user_id_unashed identifier.

Data typeExample value
Integer5066017809039612144

Unique user identifier. User id stored in a cookie named _cs_id, which has a lifetime of 13 months.

Data typeExample value
Stringae267-6g87D-88Nn6od

List of the app event names. Each app event has the same index in all app_events.* fields.

Data typeExample value
Array(String)[‘appStartEvent’, ‘appShowEvent’, ‘appHideEvent’]

List of dates and UTC time of the app events. Each app event has the same index in all app_events.* fields.

Data typeExample value
Array(String)[‘2020-06-24 17:07:42’, ‘2020-06-24 17:07:42’, ‘2020-06-24 17:08:53’]

List of the app events types related to the session:

  • 0: app start
  • 1: app show
  • 2: app hide

Each app event has the same index in all app_events.* fields.

Data typeExample value
Array(Integer)[0, 1, 2]

The pageview number related to the event. Each app event has the same index in all app_events.* fields.

Data typeExample value
Array(Integer)[0, 0, 1]

The client app version.

Data typeExample value
Integer2814771241943040

Pixel density measured in PPI, i.e. to the number of Pixels Per Inch on the display.

Data typeExample value
Float38912.312

The mobile device manufacturer.

Data typeExample value
StringHUAWEI

The mobile device model.

Data typeExample value
StringSNE-LX1

Version of Android or iOS used by the visitor (iOS 13.1. or iOS 13.2 etc.)

Data typeExample value
Integer2251799813685248

The screen name.

Data typeExample value
StringShowroom

List of finger directions related to the swipe events:

  • 1: up
  • 2: down
  • 3: left
  • 4: right
  • 5: complex

Each target has the same index in all targets_drag.* fields.

Data typeExample value
List(Integer)[2, 5]

The number of times the target was swiped.

Data typeExample value
List(Integer)[3, 1]

Each target has the same index in all targets_drag.* fields.

targets_drag_and_flick.finger_direction

Section titled targets_drag_and_flick.finger_direction

List of finger directions related to the swipe or fast swipe events:

  • 1: up
  • 2: down
  • 3: left
  • 4: right
  • 5: complex

Each target has the same index in all targets_drag_and_flick.* fields.

Data typeExample value
List(Integer)[2, 5]

targets_drag_and_flick.orientation

Section titled targets_drag_and_flick.orientation

List of orientations related to the swipe or fast swipe events:

  • 0: portrait
  • 1: landscape

Each target has the same index in all targets_drag_and_flick.* fields.

Data typeExample value
List(Integer)[1, 0]

Each target has the same index in all targets_drag_and_flick.* fields.

Data typeExample value
List(Integer)[3, 1]

Each value has the same array index as their corresponding targets_drag_and_flick.finger_direction and targets_drag_and_flick.orientation.

targets_flick.finger_direction

Section titled targets_flick.finger_direction

List of finger directions related to the fast swiped events:

  • 1: up
  • 2: down
  • 3: left
  • 4: right
  • 5: complex

Each target has the same index in all targets_flick.* fields.

Data typeExample value
List(Integer)[2, 5]

The number of times the target was fast swiped.

Data typeExample value
List(Integer)[3, 1]

Each target has the same index in all targets_flick.* fields.

List of the number of times the target was long press (a target is considered long pressed after at least 500ms).

Data typeExample value
List(Integer)[3, 1]

List of values equal to 1 if the App reacted to the tap, else 0. Each target has the same index in all targets_tap.* fields.

Data typeExample value
Aray(Integer)[0, 1]

List of the number of times the target was tapped. Each target has the same index in all targets_tap.* fields.

Data typeExample value
Aray(Integer)[3, 1]

List of delays between the loading of the page and the time the user tap on the target for the first time (in milliseconds). Each target has the same index in all targets_tap.* fields.

Data typeExample value
Aray(Integer)[31029, 26496]

Array of keys of custom variables extracted from the website datalayer. Each variable has the same index in all custom_vars_view.* fields.

Data typeExample value
Array(String)[‘pageType’, ‘page_error’, ‘user_logged’]

Array of positions of custom variables extracted from the website datalayer. Each variable has the same index in all custom_vars_view.* fields.

Data typeExample value
Array(Integer)[1, 7, 16]

Array of values of custom variables extracted from the website datalayer. Each variable has the same index in all custom_vars_view.* fields.

Data typeExample value
Array(String)[‘catalogsearch_result_index’, ‘200’, ‘not_logged’]

Page height in pixels.

Data typeExample value
Integer4326

Page width in pixels.

Data typeExample value
Integer1280

The time in milliseconds required before the user is able to interact with the page (although all resources may not be fully loaded yet).

Data typeExample value
Integer5356

Array of keys of integer dynamic variables extracted from the website datalayer of the pageview. Each variable has the same index in all dynamic_vars_int_in_view.* fields.

Data typeExample value
Array(String)[‘VAR_name_123’, VAR_name_456’]

dynamic_vars_int_in_view.value

Section titled dynamic_vars_int_in_view.value

Array of values of integer dynamic variables extracted from the website datalayer of the pageview. Each variable has the same index in all dynamic_vars_int_in_view.* fields.

Data typeExample value
Array(Integer)[123, 456]

dynamic_vars_string_in_view.key

Section titled dynamic_vars_string_in_view.key

Array of keys of string dynamic variables extracted from the website datalayer of the pageview. Each variable has the same index in all dynamic_vars_string_in_view.* fields.

Data typeExample value
Array(String)[‘VAR_name_123’, VAR_name_456’]

dynamic_vars_string_in_view.value

Section titled dynamic_vars_string_in_view.value

Array of values of string dynamic variables extracted from the website datalayer of the pageview. Each variable has the same index in all dynamic_vars_string_in_view.* fields.

Data typeExample value
Array(String)[‘VAR_value_123’, ‘VAR_value_456’]

The time in milliseconds required to fully load all the resources of the page, from initiation of the pageview to load completion in the browser.

Data typeExample value
Integer8186

If the page is the entry page then value is 1, otherwise value is 0.

Data typeExample value
Integer0

If the page is the exit page then value is 1, otherwise value is 0.

Data typeExample value
Integer1

The last path the was hovered by the visitor.

Data typeExample value
Stringhtml
(0)>body
(0)>div
(4)>input
(0)

Interaction time in milliseconds.

Data typeExample value
Integer4967

Path of the pageview URL.

Data typeExample value
String/cs-squad-3307216025801.html

Host of the pageview URL.

Data typeExample value
Stringwww.contentsquare.com

Query of the pageview URL.

Data typeExample value
Stringcs=42&lang=fr

Protocol (HTTP or HTTPS).

Data typeExample value
Stringhttps

The portion of the page which was displayed (in percentage points).

Data typeExample value
Float61.4

Timestamp sent by tag when the rendering of the page started.

Data typeExample value
Integer112

The complete URL of the page (concatenation of prefix, path and query).

Data typeExample value
Stringhttps://contentsquare.com/?s=ux

The URL of the page excluding query parameters (concatenation of prefix and path).

Data typeExample value
Stringhttps://contentsquare.com/

Duration between the page view event time (view_time) and the timestamp of the last interaction event (in milliseconds).

Data typeExample value
Integer49118

The pageview number in the session.

Data typeExample value
Integer2

The pageview date and UTC time.

Data typeExample value
String2020-07-26 05:53:04

viewports.bottom_screen_position

Section titled viewports.bottom_screen_position

Array of bottom positions of the screen of the user. A new value is appended in the array after each scroll event if it’s not already present in the array.

Data typeExample value
Array(Integer)[754, 2332, 2620]

The values in this array can be combined with the values at the same index in the arrays viewports.top_screen_position and viewports.exposition_time_msec to find corresponding top position of viewports and the total time the viewport was exposed in a given position.

For example, say a user:

  • Starts at a viewport position (top=0, bottom=800) and stays in that position for 30 seconds; then
  • Scrolls down to a viewport position (top=600, bottom=1400) and stays there for 10 seconds; then
  • Scrolls up again back to the original viewport position (top=0, bottom=800) and stays there for another 20 seconds

Then the 3 viewports array fields will look like this:

  • viewports.bottom_screen_position: [0, 600]
  • viewports.top_screen_position: [800, 1400]
  • viewports.exposition_time_msec: [50000, 10000] (30s + 20s = 50s = 50000ms)

viewports.exposition_time_msec

Section titled viewports.exposition_time_msec

The exposition time in milliseconds of the areas that were exposed to the user. A new value is appended in the array after each scroll event.

Data typeExample value
Array(Integer)[22740, 679, 1338]

The values in this array can be combined with the values at the same index in the arrays viewports.bottom_screen_position and viewports.top_screen_position to find corresponding top position of viewports and the total time the viewport was exposed in a given position.

For example, say a user:

  • Starts at a viewport position (top=0, bottom=800) and stays in that position for 30 seconds; then
  • Scrolls down to a viewport position (top=600, bottom=1400) and stays there for 10 seconds; then
  • Scrolls up again back to the original viewport position (top=0, bottom=800) and stays there for another 20 seconds

Then the 3 viewports array fields will look like this:

  • viewports.bottom_screen_position: [0, 600]
  • viewports.top_screen_position: [800, 1400]
  • viewports.exposition_time_msec: [50000, 10000] (30s + 20s = 50s = 50000ms)

Array of top positions of the screen of the user. A new value is appended in the array after each scroll event if it’s not already present in the array.

Data typeExample value
Array(Integer)[0, 1578, 1866]

The values in this array can be combined with the values at the same index in the arrays viewports.bottom_screen_position and viewports.exposition_time_msec to find corresponding top position of viewports and the total time the viewport was exposed in a given position.

For example, say a user:

  • Starts at a viewport position (top=0, bottom=800) and stays in that position for 30 seconds; then
  • Scrolls down to a viewport position (top=600, bottom=1400) and stays there for 10 seconds; then
  • Scrolls up again back to the original viewport position (top=0, bottom=800) and stays there for another 20 seconds

Then the 3 viewports array fields will look like this:

  • viewports.bottom_screen_position: [0, 600]
  • viewports.top_screen_position: [800, 1400]
  • viewports.exposition_time_msec: [50000, 10000] (30s + 20s = 50s = 50000ms)

Height of the window in which the page is opened.

Data typeExample value
Integer720

Width of the window in which the page is opened.

Data typeExample value
Integer1280

Values are either 1 or 0, to indicate whether the session is generated from bot traffic (1) or not (0).

Data typeExample value
Integer1

For Session Replay, indicates whether the session was collected (1) or not (0).

Data typeExample value
Integer1

Session start date.

Data typeExample value
String2020-07-26

Session duration in milliseconds.

Data typeExample value
Integer881633

Unique session identifier.

Data typeExample value
Integer5066017809039605767

The number of sessions of the user (takes into account how many times the user visited before).

Data typeExample value
Integer7

session_number_of_transactions

Section titled session_number_of_transactions

Number of transactions placed during the session.

Data typeExample value
Integer2

The number of page views in the session.

Data typeExample value
Integer5

The session replay link, if the session was collected (see is_recorded field).

Data typeExample value
Stringhttps://app.contentsquare.com/quick-playback/index.html?pid=

Session start date and UTC time.

Data typeExample value
String2020-07-26 05:53:04

session_transactions_revenue_cents

Section titled session_transactions_revenue_cents

Total revenue generated by the session (in US dollar cents).

Data typeExample value
Integer37655

The referring URL to the first page view of the session.

Data typeExample value
Stringhttps://www.google.fr/

Those fields are only exportable for projects with an access to the Speed Analysis module in Contentsquare.

Delay (in milliseconds) between the request for the web page and when the web browser received the first piece of data. This field is only exportable for projects with an access to the Speed Analysis module in Contentsquare.

Data typeExample value
Integer83

Delay (in milliseconds) to render the first piece of content. This field is only exportable for projects with an access to the Speed Analysis module in Contentsquare.

Data typeExample value
Integer196

Delay (in milliseconds) to render the largest piece of content (part of Core Web Vitals). This field is only exportable for projects with an access to the Speed Analysis module in Contentsquare.

Data typeExample value
Integer297

Score about the layout stability of the page rendering (part of Core Web Vitals). This field is only exportable for projects with an access to the Speed Analysis module in Contentsquare.

Data typeExample value
Integer7

Delay (in milliseconds) between the first user interaction and when the web browser can handle it (part of Core Web Vitals). This field is only exportable for projects with an access to the Speed Analysis module in Contentsquare.

Data typeExample value
Integer42

The browser major version.

Data typeExample value
Integer83

The browser name.

Data typeExample value
StringChrome

The browser version.

Data typeExample value
String83.0.4103.116

Unique device identifier:

  • 0: Unknown
  • 1: Desktop
  • 2: Mobile (Web)
  • 3: Tablet (Web)
  • 4: Mobile (App)
  • 5: Tablet (App)
Data typeExample value
Integer2

The operating system name.

Data typeExample value
StringWindows

The operating system version.

Data typeExample value
Integer10

The screen height in pixels.

Data typeExample value
Integer700

The screen width in pixels.

Data typeExample value
Integer1280