Fields reference (pageview)
Errors
Section titled Errorserrors.message
Section titled errors.messageThe list of descriptions of the JavaScript error events.
Each event has the same index in all errors.*
fields.
Data type | Example value |
---|---|
Array(String) | [‘Uncaught Error: Mismatched anonymous define() module…’, ‘Uncaught TypeError: Cannot read properties of undefined’] |
errors.error_time
Section titled errors.error_timeThe list of timestamps of the JavaScript error events.
Each event has the same index in all errors.*
fields.
Data type | Example value |
---|---|
Array(String) | [‘2020-07-11 18:55:41’,‘2020-07-11 18:55:42’] |
errors.filename
Section titled errors.filenameThe list of URLs of the files where the JavaScript error events occurred.
Each event has the same index in all errors.*
fields.
Data type | Example value |
---|---|
Array(String) | [‘https://a.site.com/static/scripts/lib1.js’, ‘https://b.site.com/static/scripts/lib2.js’] |
errors.line_number
Section titled errors.line_numberThe list of line numbers in the files where the JavaScript error events occurred.
Each event has the same index in all errors.*
fields.
Data type | Example value |
---|---|
Array(Number) | [2, 1998] |
errors.col_number
Section titled errors.col_numberThe list of column numbers in the files where the JavaScript error events occurred.
Each event has the same index in all errors.*
fields.
Data type | Example value |
---|---|
Array(Number) | [55, 44] |
errors.group_id
Section titled errors.group_idThe 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 type | Example value |
---|---|
Array(Number) | [2406037528566246307, 17923195893144918451] |
errors_api.url
Section titled errors_api.urlThe list of URL endpoints of the API error events.
Each event has the same index in all errors_api.*
fields.
Data type | Example value |
---|---|
Array(String) | [‘https://some.site.com/login’, ‘https://someother.site.com/login’] |
errors_api.method
Section titled errors_api.methodThe list of HTTP method of the API error events.
Each event has the same index in all errors_api.*
fields.
Data type | Example value |
---|---|
Array(String) | [‘GET’, ‘POST’] |
errors_api.status_code
Section titled errors_api.status_codeThe list of HTTP status codes of the API error events.
Each event has the same index in all errors_api.*
fields.
Data type | Example value |
---|---|
Array(Number) | [500, 501] |
errors_api.request_time
Section titled errors_api.request_timeThe list of the API call start timestamps of the API error events.
Each event has the same index in all errors_api.*
fields.
Data type | Example value |
---|---|
Array(String) | [‘2023-01-19 01:50:36’, ‘2023-01-21 01:50:36’] |
errors_api.group_id
Section titled errors_api.group_idThe 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 type | Example value |
---|---|
Array(Number) | [2406037528566246307, 17923195893144918451] |
custom_errors.message
Section titled custom_errors.messageThe list of descriptions of the custom error events.
Each event has the same index in all custom_errors.*
fields.
Data type | Example value |
---|---|
Array(String) | [‘An error happened’, ‘Another error happened’] |
custom_errors.error_time
Section titled custom_errors.error_timeThe list of timestamps of the custom error events.
Each event has the same index in all custom_errors.*
fields.
Data type | Example value |
---|---|
Array(String) | [‘2023-01-19 01:50:36’, ‘2023-01-20 01:50:36’] |
custom_errors.attributes
Section titled custom_errors.attributesThe 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 type | Example value |
---|---|
Array(Array(String)) | [[(‘severity’, ‘high’), (‘category’, ‘login’)]] |
custom_errors.group_id
Section titled custom_errors.group_idThe 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 type | Example value |
---|---|
Array(Number) | [2406037528566246307, 17923195893144918451] |
Events
Section titled Eventshas_all_interaction_events
Section titled has_all_interaction_eventsIf we got all kinds of events (clicks, mouse moves etc.) on the page, value is 1, else 0.
Data type | Example value |
---|---|
Integer | 0 |
page_events
Section titled page_eventsList of page events.
Data type | Example value |
---|---|
Array(String) | [‘Config: Release_20201112’,‘FB_MD_Feedback Submitted’] |
raw_clicks.event_time
Section titled raw_clicks.event_timeThe list of the dates and UTC times of the click events.
Each event has the same index in all raw_click.*
fields.
Data type | Example value |
---|---|
String | [‘2020-07-26 05:53:04’, ‘2020-07-26 05:54:22’] |
raw_clicks.event_type
Section titled raw_clicks.event_typeThe list of the raw events types. Can be either:
5
: CLICK10
: CHANGE11
: FOCUS12
: BLUR
Each event has the same index in all raw_click.*
fields.
Data type | Example value |
---|---|
Array(Integer) | [5, 11] |
raw_clicks.relative_time_ms
Section titled raw_clicks.relative_time_msNumber 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 type | Example value |
---|---|
Array(Integer) | [3981, 1782] |
raw_clicks.target_blank_field
Section titled raw_clicks.target_blank_fieldWhether the event was an interaction with a blank field in a form. Can be either:
0
: Not applicable1
: False2
: True
Each event has the same index in all raw_click.*
fields.
Data type | Example value |
---|---|
Array(Integer) | [1, 2] |
raw_clicks.target_path
Section titled raw_clicks.target_pathThe list of the paths that were clicked.
Each event has the same index in all raw_click.*
fields.
Data type | Example value |
---|---|
Array(String) | [‘html:eq(0)>form:eq(0)>div:eq(0)>button:eq(0)’, ‘html:eq(0)>button:eq(0)‘] |
targets_clicks.path
Section titled targets_clicks.pathThe list of the paths of the target zone.
Each target has the same index in all targets_clicks.*
fields.
Data type | Example value |
---|---|
Array(String) | [‘html:eq(0)>form:eq(0)>div:eq(0)>button:eq(0)’, ‘html:eq(0)>button:eq(0)‘] |
targets_clicks.sum
Section titled targets_clicks.sumThe number of times the target was clicked on (aggregation of raw_clicks
).
Each target has the same index in all targets_clicks.*
fields.
Data type | Example value |
---|---|
Array(Integer) | [2, 1] |
targets_clicks.time_before_msec
Section titled targets_clicks.time_before_msecThe 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 type | Example value |
---|---|
Array(Integer) | [779, 391] |
targets_clicks.time_between_last_hover_and_first_click
Section titled targets_clicks.time_between_last_hover_and_first_clickTime before last hover and first select the target (in milliseconds).
Each target has the same index in all targets_clicks.*
fields.
Data type | Example value |
---|---|
Array(Integer) | [13533, 30791] |
targets_focus.path
Section titled targets_focus.pathList of the raw path of the targets.
Each target has the same index in all targets_focus.*
fields.
Data type | Example value |
---|---|
Array(String) | [‘html:eq(0)>form:eq(0)>div:eq(0)>button:eq(0)’, ‘html:eq(0)>button:eq(0)‘] |
targets_focus.sum
Section titled targets_focus.sumList of the number of times the target was focused on.
Each target has the same index in all targets_focus.*
fields.
Data type | Example value |
---|---|
Array(Integer) | [2, 5] |
targets_focus.time_before_msec
Section titled targets_focus.time_before_msecList of times before first focus on a zone (in milliseconds).
Each target has the same index in all targets_focus.*
fields.
Data type | Example value |
---|---|
Array(Integer) | [13533, 30791] |
targets_hover.path
Section titled targets_hover.pathList of the raw path of the targets.
Each target has the same index in all targets_hover.*
fields.
Data type | Example value |
---|---|
Array(String) | [‘html:eq(0)>form:eq(0)>div:eq(0)>button:eq(0)’, ‘html:eq(0)>button:eq(0)‘] |
targets_hover.sum
Section titled targets_hover.sumList of the number of times the target was hovered on.
Each target has the same index in all targets_hover.*
fields.
Data type | Example value |
---|---|
Array(Integer) | [2, 5] |
targets_hover.sum_times
Section titled targets_hover.sum_timesList of the total time the target was hovered on (in milliseconds).
Each target has the same index in all targets_hover.*
fields.
Data type | Example value |
---|---|
Array(Integer) | [2563 ,252] |
targets_hover.time_before_msec
Section titled targets_hover.time_before_msecList of times before first hover on a zone (in milliseconds).
Each target has the same index in all targets_hover.*
fields.
Data type | Example value |
---|---|
Array(Integer) | [13533, 30791] |
Frustration
Section titled FrustrationThose fields are only exportable for projects with an access to the frustration score in Contentsquare.
any_api_error_ind
Section titled any_api_error_indA 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 type | Example value |
---|---|
Float | 0.27 |
any_js_error_ind
Section titled any_js_error_indA 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 type | Example value |
---|---|
Float | 0.27 |
api_error_after_click_ind
Section titled api_error_after_click_indA 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 type | Example value |
---|---|
Float | 0.27 |
excessive_hovers_ind
Section titled excessive_hovers_indA 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 type | Example value |
---|---|
Float | 1.64 |
frustration_score
Section titled frustration_scoreA 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 type | Example value |
---|---|
Float | 0.27 |
is_watchable
Section titled is_watchableWhether 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 type | Example value |
---|---|
Integer | 0 |
js_error_after_click_ind
Section titled js_error_after_click_indA 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 type | Example value |
---|---|
Float | 1.64 |
loading_time_ind
Section titled loading_time_indA 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 type | Example value |
---|---|
Float | 0.27 |
multiple_button_interaction_ind
Section titled multiple_button_interaction_indA 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 type | Example value |
---|---|
Float | 1.64 |
multiple_field_interaction_ind
Section titled multiple_field_interaction_indA 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 type | Example value |
---|---|
Float | 1.64 |
multiple_used_targets_ind
Section titled multiple_used_targets_indA 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 type | Example value |
---|---|
Float | 0.27 |
no_clicks_on_page_ind
Section titled no_clicks_on_page_indA 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 type | Example value |
---|---|
Float | 0.27 |
rage_click_all_targets_ind
Section titled rage_click_all_targets_indA 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 type | Example value |
---|---|
Float | 1.64 |
Geography
Section titled GeographyCity associated to the user.
Data type | Example value |
---|---|
String | Paris |
country_code
Section titled country_codeCountry associated to the user.
Data type | Example value |
---|---|
String | FR |
language
Section titled languageLanguage associated to the user.
Data type | Example value |
---|---|
String | fr |
Identifiers
Section titled Identifiersproject_id
Section titled project_idUnique project identifier.
Data type | Example value |
---|---|
Integer | 42 |
user_id
Section titled user_idUnique user identifier.
This is the hash of the user_id_unashed
identifier.
Data type | Example value |
---|---|
Integer | 5066017809039612144 |
user_id_unhashed
Section titled user_id_unhashedUnique user identifier.
User id stored in a cookie named _cs_id
, which has a lifetime of 13 months.
Data type | Example value |
---|---|
String | ae267-6g87D-88Nn6od |
Mobile (CS App)
Section titled Mobile (CS App)app_events.event_name
Section titled app_events.event_nameList of the app event names.
Each app event has the same index in all app_events.*
fields.
Data type | Example value |
---|---|
Array(String) | [‘appStartEvent’, ‘appShowEvent’, ‘appHideEvent’] |
app_events.event_time
Section titled app_events.event_timeList of dates and UTC time of the app events.
Each app event has the same index in all app_events.*
fields.
Data type | Example value |
---|---|
Array(String) | [‘2020-06-24 17:07:42’, ‘2020-06-24 17:07:42’, ‘2020-06-24 17:08:53’] |
app_events.event_type
Section titled app_events.event_typeList of the app events types related to the session:
0
: app start1
: app show2
: app hide
Each app event has the same index in all app_events.*
fields.
Data type | Example value |
---|---|
Array(Integer) | [0, 1, 2] |
app_events.view_number
Section titled app_events.view_numberThe pageview number related to the event.
Each app event has the same index in all app_events.*
fields.
Data type | Example value |
---|---|
Array(Integer) | [0, 0, 1] |
app_version
Section titled app_versionThe client app version.
Data type | Example value |
---|---|
String | 10.8.2.0 |
density
Section titled densityPixel density measured in Pixels Per Inch (PPI) on the display.
Data type | Example value |
---|---|
Float | 38912.312 |
manufacturer
Section titled manufacturerThe mobile device manufacturer.
Data type | Example value |
---|---|
String | HUAWEI |
model
Section titled modelThe mobile device model.
Data type | Example value |
---|---|
String | SNE-LX1 |
os_version
Section titled os_versionVersion of Android or iOS used by the visitor (iOS 13.1. or iOS 13.2 etc.)
Data type | Example value |
---|---|
Integer | 2251799813685248 |
screen_name
Section titled screen_nameThe screen name.
Data type | Example value |
---|---|
String | Showroom |
targets_drag.finger_direction
Section titled targets_drag.finger_directionList of finger directions related to the swipe events:
1
: up2
: down3
: left4
: right5
: complex
Each target has the same index in all targets_drag.*
fields.
Data type | Example value |
---|---|
List(Integer) | [2, 5] |
targets_drag.sum
Section titled targets_drag.sumThe number of times the target was swiped.
Data type | Example 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_directionList of finger directions related to the swipe or fast swipe events:
1
: up2
: down3
: left4
: right5
: complex
Each target has the same index in all targets_drag_and_flick.*
fields.
Data type | Example value |
---|---|
List(Integer) | [2, 5] |
targets_drag_and_flick.orientation
Section titled targets_drag_and_flick.orientationList of orientations related to the swipe or fast swipe events:
0
: portrait1
: landscape
Each target has the same index in all targets_drag_and_flick.*
fields.
Data type | Example value |
---|---|
List(Integer) | [1, 0] |
targets_drag_and_flick.sum
Section titled targets_drag_and_flick.sumEach target has the same index in all targets_drag_and_flick.*
fields.
Data type | Example 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_directionList of finger directions related to the fast swiped events:
1
: up2
: down3
: left4
: right5
: complex
Each target has the same index in all targets_flick.*
fields.
Data type | Example value |
---|---|
List(Integer) | [2, 5] |
targets_flick.sum
Section titled targets_flick.sumThe number of times the target was fast swiped.
Data type | Example value |
---|---|
List(Integer) | [3, 1] |
Each target has the same index in all targets_flick.*
fields.
targets_long_press.sum
Section titled targets_long_press.sumList of the number of times the target was long press (a target is considered long pressed after at least 500ms).
Data type | Example value |
---|---|
List(Integer) | [3, 1] |
targets_tap.responsive
Section titled targets_tap.responsiveList 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 type | Example value |
---|---|
Aray(Integer) | [0, 1] |
targets_tap.sum
Section titled targets_tap.sumList of the number of times the target was tapped.
Each target has the same index in all targets_tap.*
fields.
Data type | Example value |
---|---|
Aray(Integer) | [3, 1] |
targets_tap.time_before_msec
Section titled targets_tap.time_before_msecList 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 type | Example value |
---|---|
Aray(Integer) | [31029, 26496] |
custom_vars_view.key
Section titled custom_vars_view.keyArray of keys of custom variables extracted from the website datalayer.
Each variable has the same index in all custom_vars_view.*
fields.
Data type | Example value |
---|---|
Array(String) | [‘pageType’, ‘page_error’, ‘user_logged’] |
custom_vars_view.position
Section titled custom_vars_view.positionArray of positions of custom variables extracted from the website datalayer.
Each variable has the same index in all custom_vars_view.*
fields.
Data type | Example value |
---|---|
Array(Integer) | [1, 7, 16] |
custom_vars_view.value
Section titled custom_vars_view.valueArray of values of custom variables extracted from the website datalayer.
Each variable has the same index in all custom_vars_view.*
fields.
Data type | Example value |
---|---|
Array(String) | [‘catalogsearch_result_index’, ‘200’, ‘not_logged’] |
document_height
Section titled document_heightPage height in pixels.
Data type | Example value |
---|---|
Integer | 4326 |
document_width
Section titled document_widthPage width in pixels.
Data type | Example value |
---|---|
Integer | 1280 |
dom_interactive_after_msec
Section titled dom_interactive_after_msecThe time in milliseconds required before the user is able to interact with the page (although all resources may not be fully loaded yet).
Data type | Example value |
---|---|
Integer | 5356 |
dynamic_vars_int_in_view.key
Section titled dynamic_vars_int_in_view.keyArray 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 type | Example value |
---|---|
Array(String) | [‘VAR_name_123’, VAR_name_456’] |
dynamic_vars_int_in_view.value
Section titled dynamic_vars_int_in_view.valueArray 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 type | Example value |
---|---|
Array(Integer) | [123, 456] |
dynamic_vars_string_in_view.key
Section titled dynamic_vars_string_in_view.keyArray 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 type | Example value |
---|---|
Array(String) | [‘VAR_name_123’, VAR_name_456’] |
dynamic_vars_string_in_view.value
Section titled dynamic_vars_string_in_view.valueArray 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 type | Example value |
---|---|
Array(String) | [‘VAR_value_123’, ‘VAR_value_456’] |
fully_loaded
Section titled fully_loadedThe 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 type | Example value |
---|---|
Integer | 8186 |
is_first
Section titled is_firstIf the page is the entry page then value is 1, otherwise value is 0.
Data type | Example value |
---|---|
Integer | 0 |
is_last
Section titled is_lastIf the page is the exit page then value is 1, otherwise value is 0.
Data type | Example value |
---|---|
Integer | 1 |
last_hover_path
Section titled last_hover_pathThe last path the was hovered by the visitor.
Data type | Example value |
---|---|
String | html:eq(0)>body:eq(0)>div(4)>input:eq(0) |
page_interaction_time_msec
Section titled page_interaction_time_msecInteraction time in milliseconds.
Data type | Example value |
---|---|
Integer | 4967 |
Path of the pageview URL.
Data type | Example value |
---|---|
String | /cs-squad-3307216025801.html |
prefix
Section titled prefixHost of the pageview URL.
Data type | Example value |
---|---|
String | www.contentsquare.com |
query
Section titled queryQuery of the pageview URL.
Data type | Example value |
---|---|
String | cs=42&lang=fr |
scheme
Section titled schemeProtocol (HTTP or HTTPS).
Data type | Example value |
---|---|
String | https |
scroll_rate
Section titled scroll_rateThe portion of the page which was displayed (in percentage points).
Data type | Example value |
---|---|
Float | 61.4 |
start_render
Section titled start_renderTimestamp sent by tag when the rendering of the page started.
Data type | Example value |
---|---|
Integer | 112 |
The complete URL of the page (concatenation of prefix, path and query).
Data type | Example value |
---|---|
String | https://contentsquare.com/?s=ux |
url_no_params
Section titled url_no_paramsThe URL of the page excluding query parameters (concatenation of prefix and path).
Data type | Example value |
---|---|
String | https://contentsquare.com/ |
view_duration_msec
Section titled view_duration_msecDuration between the page view event time (view_time
) and the timestamp of the
last interaction event (in milliseconds).
Data type | Example value |
---|---|
Integer | 49118 |
view_number
Section titled view_numberThe pageview number in the session.
Data type | Example value |
---|---|
Integer | 2 |
view_time
Section titled view_timeThe pageview date and UTC time.
Data type | Example value |
---|---|
String | 2020-07-26 05:53:04 |
viewports.bottom_screen_position
Section titled viewports.bottom_screen_positionArray 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 type | Example 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_msecThe 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 type | Example 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)
viewports.top_screen_position
Section titled viewports.top_screen_positionArray 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 type | Example 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)
window_height
Section titled window_heightHeight of the window in which the page is opened.
Data type | Example value |
---|---|
Integer | 720 |
window_width
Section titled window_widthWidth of the window in which the page is opened.
Data type | Example value |
---|---|
Integer | 1280 |
Session
Section titled Sessionis_excludable
Section titled is_excludableValues are either 1 or 0, to indicate whether the session is generated from bot traffic (1) or not (0).
Data type | Example value |
---|---|
Integer | 1 |
is_recorded
Section titled is_recordedFor Session Replay, indicates whether the session was collected (1) or not (0).
Data type | Example value |
---|---|
Integer | 1 |
session_date
Section titled session_dateSession start date.
Data type | Example value |
---|---|
String | 2020-07-26 |
session_duration_msec
Section titled session_duration_msecSession duration in milliseconds.
Data type | Example value |
---|---|
Integer | 881633 |
session_id
Section titled session_idUnique session identifier.
Data type | Example value |
---|---|
Integer | 5066017809039605767 |
session_number
Section titled session_numberThe number of sessions of the user (takes into account how many times the user visited before).
Data type | Example value |
---|---|
Integer | 7 |
session_number_of_transactions
Section titled session_number_of_transactionsNumber of transactions placed during the session.
Data type | Example value |
---|---|
Integer | 2 |
session_number_of_views
Section titled session_number_of_viewsThe number of page views in the session.
Data type | Example value |
---|---|
Integer | 5 |
session_replay_link
Section titled session_replay_linkThe replay link, if the session was collected (see is_recorded
field).
Data type | Example value |
---|---|
String | https://app.contentsquare.com/quick-playback/index.html?pid=… |
session_time
Section titled session_timeSession start date and UTC time.
Data type | Example value |
---|---|
String | 2020-07-26 05:53:04 |
session_transactions_revenue_cents
Section titled session_transactions_revenue_centsTotal revenue generated by the session (in US dollar cents).
Data type | Example value |
---|---|
Integer | 37655 |
referer_url
Section titled referer_urlThe referring URL to the first page view of the session.
Data type | Example value |
---|---|
String | https://www.google.fr/ |
Speed Analysis
Section titled Speed AnalysisThose fields are only exportable for projects with an access to the Speed Analysis module in Contentsquare.
time_to_first_byte
Section titled time_to_first_byteDelay (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 type | Example value |
---|---|
Integer | 83 |
first_contentful_paint
Section titled first_contentful_paintDelay (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 type | Example value |
---|---|
Integer | 196 |
largest_contentful_paint
Section titled largest_contentful_paintDelay (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 type | Example value |
---|---|
Integer | 297 |
cumulative_layout_shift
Section titled cumulative_layout_shiftScore 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 type | Example value |
---|---|
Integer | 7 |
first_input_delay
Section titled first_input_delayDelay (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 type | Example value |
---|---|
Integer | 42 |
interaction_to_next_paint
Section titled interaction_to_next_paintLongest visual delay (in milliseconds) experienced by a user when interacting with the page (clicks or keystrokes). This field is only exportable for projects with an access to the Speed Analysis module in Contentsquare.
Data type | Example value |
---|---|
Integer | 61 |
Technology
Section titled Technologybrowser_major_version
Section titled browser_major_versionThe browser major version.
Data type | Example value |
---|---|
Integer | 83 |
browser_name
Section titled browser_nameThe browser name.
Data type | Example value |
---|---|
String | Chrome |
browser_version
Section titled browser_versionThe browser version.
Data type | Example value |
---|---|
String | 83.0.4103.116 |
device_id
Section titled device_idUnique device identifier:
0
: Unknown1
: Desktop2
: Mobile (Web)3
: Tablet (Web)4
: Mobile (App)5
: Tablet (App)
Data type | Example value |
---|---|
Integer | 2 |
platform_name
Section titled platform_nameThe operating system name.
Data type | Example value |
---|---|
String | Windows |
platform_version
Section titled platform_versionThe operating system version.
Data type | Example value |
---|---|
Integer | 10 |
screen_height
Section titled screen_heightThe screen height in pixels.
Data type | Example value |
---|---|
Integer | 700 |
screen_width
Section titled screen_widthThe screen width in pixels.
Data type | Example value |
---|---|
Integer | 1280 |