Skip to main content

Measurement Data

This is the measurement data that is available in our dashboards and when you query the API for measurements. It contains all data that is generated for a measurement, including metadata like when it was generated, and what was being measured, and the actual statistic values (KPIs).

Note that the definition of calculated statistics is not part of this page. You will find the definitions in the statistic values (KPIs) documentation.

For some measurements we provide detailed client reports which contain additional measurement data. To understand what they contain, please see the Client Reports documentation.

Note

For legacy reasons, speed test measurements contain their statistics directly in their attributes. They are listed here.

Note

Connection details are specified below, but explained in more detail here

Example File​

Here is a (somewhat contrived) response for a YouTube video measurement run on a mobile probe in Vienna. It covers most of the fields you may encounter in production exports, including the network, ISP, geolocation and contract information.

{
"id": 184523,
"video_measurement_id": 76841,
"web_measurement_id": 132956,
"internal_id": "8e3a1f2c-4d59-4b1a-9e7e-2a6f8c4d1e90",
"started_at": "2026-05-08T14:23:12.418Z",
"finished_at": "2026-05-08T14:24:13.802Z",
"aborted_at": null,
"aborted_reason": null,
"started_at_skewed": "2026-05-08T14:23:12.421Z",
"finished_at_skewed": "2026-05-08T14:24:13.806Z",
"aborted_at_skewed": null,
"statistics_calculated_at": "2026-05-08T14:25:11.244Z",
"last_indexed_at": "2026-05-08T14:25:11.319Z",
"created_at": "2026-05-08T14:24:15.103Z",
"updated_at": "2026-05-08T14:25:11.330Z",
"finished_reason": "STUDY_FINISHED",
"url": "https://www.youtube.com/watch?v=aqz-KE-bpKQ",
"url_stripped": false,
"domain": "youtube.com",
"hostname": "www.youtube.com",
"ad_block_used": false,
"logged_in": false,
"membership": null,
"incognito": false,
"client_version": "1.42.3",
"client_type": "SurfmeterLabMobileClient",
"notes": null,
"params": {
"run_in_control_tab": true
},
"metadata": {
"deviceModel": "Pixel 8",
"osBuild": "AP31.240617.009"
},
"service": "youtube",
"manifest_url": "",
"player": "youtube_player",
"player_version": null,
"playback_technology": "dash",
"play_mode": "lab_embedded",
"remote_ip": "172.217.16.142",
"statistic_values": {
"video_completion_ratio": 0.945,
"p1203_overall_mos": 4.32,
"p1203_overall_audiovisual_quality": 4.61,
"p1203_max_theoretical_mos": 4.72,
"p1203_average_video_quality": 4.18,
"p1203_average_audio_quality": 4.41,
"p1203_stalling_quality": 4.88,
"initial_resolution": 480,
"longest_played_chunk": 1080,
"largest_played_video_size": 1080,
"initial_loading_delay": 0.812,
"number_of_stalling_events": 1,
"total_stalling_time": 0.642,
"stalling_ratio": 0.0107,
"average_stalling_time": 0.642,
"total_play_time": 60.012,
"average_total_bitrate": 2284.71,
"average_video_bitrate": 2156.43,
"average_audio_bitrate": 128.28,
"number_of_quality_switches": 3,
"quality_switch_up_count": 3,
"quality_switch_down_count": 0
},
"client": {
"uuid": "a3c19d7e-5b8f-4c2a-9e6d-1f4b8a3c7d92",
"created_at": "2025-09-14T09:12:03.421Z",
"updated_at": "2026-05-08T14:25:11.302Z",
"disabled_at": null,
"disabled_reason": null,
"label": "vie-probe-014",
"extra_label": "Vienna 22nd district roof installation",
"type": "SurfmeterLabMobileClient",
"tags": ["austria", "mobile-5g", "production"],
"client_group_names": ["AT mobile probes", "Magenta 5G"]
},
"client_context": {
"browser_type": "Chrome",
"browser_version": "125.0.6422.165",
"operating_system": "Android",
"operating_system_version": "14",
"valid_from": "2026-04-22T07:54:18.901Z",
"valid_until": null
},
"isp_detail": {
"ip_address": "91.114.218.27",
"as": "AS8412",
"latitude": 48.2085,
"longitude": 16.3721,
"lonlat": [16.3721, 48.2085],
"city": "Vienna",
"region": "Vienna",
"country": "AT",
"zip": "1010",
"isp": {
"name": "Magenta Telekom"
}
},
"remote_isp_detail": {
"ip_address": "172.217.16.142",
"as": "AS15169",
"latitude": 37.4056,
"longitude": -122.0775,
"lonlat": [-122.0775, 37.4056],
"city": "Mountain View",
"region": "California",
"country": "US",
"zip": "94043",
"isp": {
"name": "Google LLC"
}
},
"geolocation": {
"latitude": 48.21042,
"longitude": 16.36381,
"lonlat": [16.36381, 48.21042],
"city": "Vienna",
"zip": "1090",
"region": "Wien",
"country": "Austria"
},
"isp_contract": {
"name": "Magenta Mobile Max",
"connection_type": "5g",
"upload_speed": 100,
"download_speed": 500,
"monthly_price": 39.9,
"currency": "EUR",
"assumed_tariff": null,
"valid_from": "2025-08-01T00:00:00.000Z",
"valid_until": null
},
"connection_detail": {
"type": "MobileConnectionDetail",
"client_time": "2026-05-08T14:23:12.418Z",
"client_time_skewed": "2026-05-08T14:23:12.421Z",
"is_internet_reachable": true,
"is_connection_expensive": true,
"is_roaming": false,
"mobile_network_type": "NR",
"mobile_network_type_general": "5G",
"ip_address": "10.142.83.14",
"subnet": "255.255.255.0",
"mcc": 232,
"mnc": 3,
"mno": "Magenta Telekom",
"tac": 41201,
"pci": 327,
"nci": 12387429,
"nrarfcn": 632448,
"rsrp": -82,
"rsrq": -10,
"rssnr": 18,
"ssrsrp": -84,
"ssrsrq": -11,
"sssinr": 16,
"dbm": -82,
"asu_level": 50,
"signal_level": 4
},
"video": {
"service": "youtube",
"stream_id": "aqz-KE-bpKQ",
"is_reference_video": true,
"title": "Big Buck Bunny",
"content_type": "feature",
"duration": 634.601,
"num_comments": 84512,
"num_likes": 312840,
"num_dislikes": null,
"num_views": 9281402,
"channel_id": "UCERrR0PT1U2cZL1Hcf3lzgg",
"channel_title": "Blender Foundation",
"src": null
},
"study_chain": {
"id": 8421,
"started_at": "2026-05-08T14:22:58.103Z",
"finished_at": "2026-05-08T14:24:14.221Z",
"aborted_at": null,
"created_at": "2026-05-08T14:22:55.012Z",
"updated_at": "2026-05-08T14:24:14.231Z",
"aborted_reason": null,
"abort_action": null,
"abort_action_at": null,
"started_at_skewed": "2026-05-08T14:22:58.106Z",
"finished_at_skewed": "2026-05-08T14:24:14.225Z",
"aborted_at_skewed": null,
"abort_action_at_skewed": null,
"study_ids": ["16842"]
},
"study": {
"id": 16842,
"type": "VideoStudy",
"subject": "youtube",
"started_at": "2026-05-08T14:23:00.422Z",
"finished_at": "2026-05-08T14:24:13.808Z",
"aborted_at": null,
"aborted_reason": null,
"abort_action": null,
"abort_action_at": null,
"created_at": "2026-05-08T14:22:55.094Z",
"updated_at": "2026-05-08T14:24:13.821Z",
"run_options": {
"run_in_control_tab": true
},
"started_at_skewed": "2026-05-08T14:23:00.425Z",
"finished_at_skewed": "2026-05-08T14:24:13.812Z",
"aborted_at_skewed": null,
"abort_action_at_skewed": null,
"description": {
"id": "STUDY_YOUTUBE_BBB",
"type": "VIDEO",
"subject": "youtube",
"names": {
"de_de": {
"long": "YouTube Big Buck Bunny Referenz",
"short": "YT BBB"
},
"en_us": {
"long": "YouTube Big Buck Bunny Reference",
"short": "YT BBB"
}
},
"params": {
"video": {
"src": "https://www.youtube.com/watch?v=aqz-KE-bpKQ",
"content_type": "feature"
},
"timeout": 30,
"duration": 60,
"play_mode": "lab_embedded"
}
},
"notes": null,
"metadata": {}
},
"@timestamp": "2026-05-08T14:23:12.418Z",
"type": "VideoMeasurement",
"started_at_minute": 23,
"source": "rails"
}

Notable fields in this example:

  • statistic_values are the calculated KPIs for this measurement, see the Statistic Values reference for details on what each of them means.
  • isp_detail contains the IP-derived ISP and geolocation of the client based on the IP address. The lonlat array is in [longitude, latitude] order so it can be used directly as an Elasticsearch geo_point.
  • remote_isp_detail describes the remote host (here a Google content server) if we have a remote IP (usually the case for web measurements).
  • geolocation is the top-level geolocation of the measurement itself, which needs to have been set explicitly (e.g. from a GPS-equipped probe) rather than derived from the client's IP.

Properties​

These are the properties of all measurements. We first describe those common to all types of measurements, then those specific to each type.

Common Properties​

A base measurement JSON Schema (never sent to analytics, just for providing inheritance)

PropertyTypeDescription
idnumberThe unique ID of the measurement
internal_idstringAn internal ID for the measurement
created_atstring, or nullThe time the measurement was created on the server (ISO 8601 format)
updated_atstring, or nullThe time the measurement was last updated on the server (ISO 8601 format)
started_atstring, or nullThe time the measurement was started (ISO 8601 format)
finished_atstring, or nullThe time the measurement was finished (ISO 8601 format)
aborted_atstring, or nullThe time the measurement was aborted (ISO 8601 format)
aborted_reasonstring, or nullThe reason why the measurement was aborted
started_at_skewedstring, or nullThe time the measurement was started (ISO 8601 format), adjusted in case of client skew
finished_at_skewedstring, or nullThe time the measurement was finished (ISO 8601 format), adjusted in case of client skew
aborted_at_skewedstring, or nullThe time the measurement was aborted (ISO 8601 format), adjusted in case of client skew
statistics_calculated_atstring, or nullThe time the statistics were calculated (ISO 8601 format)
last_indexed_atstring, or null (optional)The time the measurement was last indexed to Elasticsearch (ISO 8601 format)
finished_reasonstring, or null (optional)A string describing the reason why the measurement was finished
urlstring, or null (optional)A URL corresponding to the measurement
url_strippedboolean, or null (optional)Whether the URL was stripped for privacy reasons
ad_block_usedboolean, or null (optional)Whether ad blocking was used
logged_inboolean, or null (optional)Whether the user was logged in
membershipstring, or null (optional)A string describing the membership of the user on the measured service
client_versionstring (optional)The version of the client used
client_typestring, or null (optional)The type of the client used (e.g. SurfmeterLabClient or SurfmeterAutomatorClient)
domainstring (optional)The domain of the measurement
incognitoboolean, or null (optional)Whether incognito mode was used
notesstringAny notes associated with the measurement
metadataobjectCustom metadata associated with the measurement
paramsobjectCustom params used for running the measurement
statistic_valuesobjectA dictionary of statistic values calculated for the measurement, see Statistic Values reference.
geolocationGeolocation (optional)A dictionary of geolocation information
clientClientAn object describing the client used for the measurement
client_contextClient Context (optional)Detailed information about the client
isp_detailIsp Detail (optional)Information about the ISP
remote_isp_detailRemote Isp Detail (optional)Information about the ISP of the remote host
connection_detailConnection Detail (optional)More information about the connection
isp_contractIsp Contract (optional)ISP contract details for the client at measurement time. Derived from the server-side ISP contract assigned to the client, looked up by the measurement's start time.
study_chainStudy Chain (optional)The study chain containing individual studies
studyStudy (optional)The description of a study
@timestampstringThe time when the measurement was created (ISO 8601 format)
started_at_minuteinteger, or null (optional)The minute when the measurement was started (integer)
sourcestring (one of: rails, client-analytics)The system that indexed the document. rails for documents indexed by the Rails server, client-analytics for documents indexed by the client-analytics service.
remote_ipstring, or null (optional)The IP address of the remote host the measurement was performed against. Used to populate remote_isp_detail.

Studydescription​

The description of a study

PropertyTypeDescription
idstringThe ID of the study
typestringThe type of the study
subjectstringThe subject of the study
namesobject (no predefined properties) (optional)The names of the study
paramsobject (no predefined properties)The parameters of the study
nativeobject with properties: enabled (optional)Native study parameters
automatorobject (no predefined properties) (optional)Automator study parameters

Study​

The description of a study

PropertyTypeDescription
idintegerThe ID of the study
subjectstringThe subject of the study
started_atstring, or nullThe time when the study started (ISO 8601 format)
finished_atstring, or nullThe time when the study finished (ISO 8601 format)
aborted_atstring, or nullThe time when the study was aborted (ISO 8601 format)
aborted_reasonstring, or nullA reason for aborting the study
abort_actionstring, or nullWhich action was taken to abort the study
abort_action_atstring, or nullWhen the abort action was taken (ISO 8601 format)
created_atstring, or nullThe time when the study was created (ISO 8601 format)
updated_atstring, or nullThe time when the study was last updated (ISO 8601 format)
run_optionsobject (no predefined properties)Special options used to run the study
started_at_skewedstring, or nullThe time when the study started (ISO 8601 format), adjusted in case of client skew
finished_at_skewedstring, or nullThe time when the study finished (ISO 8601 format), adjusted in case of client skew
aborted_at_skewedstring, or nullThe time when the study was aborted (ISO 8601 format), adjusted in case of client skew
abort_action_at_skewedstring, or nullWhen the abort action was taken (ISO 8601 format), adjusted in case of client skew
descriptionobject with properties: id, type, subject, names, params, native, automatorThe description of a study
notesstring (optional)Any notes associated with the study
metadataobject (no predefined properties) (optional)Custom metadata associated with the study

Study Chain​

The study chain containing individual studies

PropertyTypeDescription
idintegerThe ID of the study chain
started_atstring, or nullThe time when the study chain started (ISO 8601 format)
finished_atstring, or nullThe time when the study chain finished (ISO 8601 format)
aborted_atstring, or nullThe time when the study chain was aborted (ISO 8601 format)
created_atstring, or nullThe time when the study chain was created (ISO 8601 format)
updated_atstring, or nullThe time when the study chain was last updated (ISO 8601 format)
aborted_reasonstring, or nullA reason for aborting the study chain
abort_actionstring, or nullWhich action was taken to abort the study chain
abort_action_atstring, or nullWhen the abort action was taken (ISO 8601 format)
started_at_skewedstring, or nullThe time when the study chain started (ISO 8601 format), adjusted in case of client skew
finished_at_skewedstring, or nullThe time when the study chain finished (ISO 8601 format), adjusted in case of client skew
aborted_at_skewedstring, or nullThe time when the study chain was aborted (ISO 8601 format), adjusted in case of client skew
abort_action_at_skewedstring, or nullWhen the abort action was taken (ISO 8601 format), adjusted in case of client skew
study_idsarray of stringThe IDs of the studies in the chain

Connection Detail​

More information about the connection

PropertyTypeDescription
typestringThe type of connection (MobileConnectionDetail, WifiConnectionDetail, EthernetConnectionDetail)
mobile_network_typestring, or null (optional)The type of mobile network (EDGE, HSDPA, etc.)
mobile_network_type_generalstring, or null (optional)The general type of mobile network (2G, 3G, 4G, etc.)
client_timestring, or null (optional)The time when the client sent the data (ISO 8601 format)
client_time_skewedstring, or null (optional)The time when the client sent the data (ISO 8601 format), adjusted in case of client skew
signal_strengthnumber, or null (optional)WiFi signal strength in percent (0–100); the raw value in dBm is in rssi
is_internet_reachableboolean, or null (optional)Boolean indicating if the internet is accessible
is_connection_expensiveboolean, or null (optional)Boolean indicating if the connection is metered or roaming
arfcninteger, or null (optional)Absolute Radio Frequency Channel Number
bsicinteger, or null (optional)Base Station Identity Code
bsidinteger, or null (optional)Base Station ID
cidinteger, or null (optional)Cell Identity
lacinteger, or null (optional)Location Area Code
mccinteger, or null (optional)Mobile Country Code
mncinteger, or null (optional)Mobile Network Code
mnostring, or null (optional)Mobile Network Operator
enodeb_idinteger, or null (optional)eNodeB ID (for LTE networks)
pciinteger, or null (optional)Physical Cell ID (for LTE networks)
pscinteger, or null (optional)Primary Scrambling Code
tacinteger, or null (optional)Tracking Area Code (for LTE networks)
bssidstring, or null (optional)MAC address of the connected access point
ssidstring, or null (optional)Name of the WiFi network
rssiinteger, or null (optional)Received Signal Strength Indicator
channelinteger, or null (optional)WiFi channel number
link_speednumber, or null (optional)Connection speed in Mbps (symmetric/legacy)
link_speed_rxnumber, or null (optional)Downlink connection speed in Mbps (when reported separately)
link_speed_txnumber, or null (optional)Uplink connection speed in Mbps (when reported separately)
frequencyinteger, or null (optional)WiFi frequency in MHz
ip_addressstring, or null (optional)IP address of the device on the current network
subnetstring, or null (optional)Subnet mask of the network
dbmnumber, or null (optional)Signal strength in dBm
is_roamingboolean, or null (optional)Boolean indicating if the device is roaming
asu_levelinteger, or null (optional)Signal level as an ASU (Arbitrary Strength Unit) value
signal_levelinteger, or null (optional)Signal level as an integer from 0 to 4
cpidinteger, or null (optional)Cell Parameters ID
ecnonumber, or null (optional)Energy per Chip to Noise Ratio
nciinteger, or null (optional)NR Cell Identity (for 5G networks)
nidinteger, or null (optional)Network ID
nrarfcninteger, or null (optional)NR Absolute Radio Frequency Channel Number (for 5G networks)
rscpnumber, or null (optional)Received Signal Code Power
rsrpnumber, or null (optional)Reference Signal Received Power
rsrqnumber, or null (optional)Reference Signal Received Quality
rssnrnumber, or null (optional)Reference Signal Signal-to-Noise Ratio
sidinteger, or null (optional)System ID
ssrsrpnumber, or null (optional)SS Reference Signal Received Power
ssrsrqnumber, or null (optional)SS Reference Signal Received Quality
sssinrnumber, or null (optional)SS Signal-to-Noise and Interference Ratio
uarfcninteger, or null (optional)UTRA Absolute RF Channel Number

Isp Detail​

Information about the ISP

PropertyTypeDescription
ispobject with properties: nameThe ISP
ip_addressstring, or nullThe IP address of the client
asstring, or nullThe AS number of the client
latitudenumber, or null (optional)Latitude derived from the IP address (city centroid)
longitudenumber, or null (optional)Longitude derived from the IP address (city centroid)
lonlatarray (optional)The longitude and latitude as a [lon, lat] geo_point
citystring, or null (optional)The city derived from the IP address
regionstring, or null (optional)The region derived from the IP address
countrystring, or null (optional)The country derived from the IP address
zipstring, or null (optional)The ZIP code derived from the IP address

Remote Isp Detail​

Information about the ISP of the remote host

PropertyTypeDescription
ispobject with properties: nameThe ISP
ip_addressstring, or nullThe IP address of the remote host
asstring, or nullThe AS number of the remote host
latitudenumber, or null (optional)Latitude derived from the remote IP address (city centroid)
longitudenumber, or null (optional)Longitude derived from the remote IP address (city centroid)
lonlatarray (optional)The longitude and latitude as a [lon, lat] geo_point
citystring, or null (optional)The city derived from the remote IP address
regionstring, or null (optional)The region derived from the remote IP address
countrystring, or null (optional)The country derived from the remote IP address
zipstring, or null (optional)The ZIP code derived from the remote IP address

Isp Contract​

ISP contract details for the client at measurement time. Derived from the server-side ISP contract assigned to the client, looked up by the measurement's start time.

PropertyTypeDescription
namestring, or null (optional)The name of the ISP contract/tariff
connection_typestring, or null (optional)The type of connection (e.g. fiber, dsl, cable)
upload_speedinteger, or null (optional)Contracted upload speed in MBit/s
download_speedinteger, or null (optional)Contracted download speed in MBit/s
monthly_pricenumber, or null (optional)Monthly price of the contract
currencystring, or null (optional)Currency of the monthly price (e.g. EUR, USD)
assumed_tariffstring, or null (optional)Assumed tariff name
valid_fromstring, or null (optional)Start date of the contract validity (ISO 8601 format)
valid_untilstring, or null (optional)End date of the contract validity (ISO 8601 format)

Client Context​

Detailed information about the client

PropertyTypeDescription
browser_typestring, or null (optional)The browser type
browser_versionstring, or null (optional)The browser version
operating_systemstring, or null (optional)The operating system
operating_system_versionstring, or null (optional)The operating system version

Client​

An object describing the client used for the measurement

PropertyTypeDescription
uuidstringThe UUID of the client
created_atstring, or nullThe time when the client was created (ISO 8601 format)
updated_atstring, or nullThe time when the client was last updated (ISO 8601 format)
disabled_atstring, or nullThe time when the client was disabled (ISO 8601 format)
disabled_reasonstring, or nullThe reason why the client was disabled
labelstring, or nullA custom label for the client
typestring, or nullThe client type
tagsarray of stringAny tags associated with the client
client_group_namesarray of string (optional)The names of the client groups the client belongs to
extra_labelstring, or nullAn extra label for the client

Geolocation​

A dictionary of geolocation information

PropertyTypeDescription
latitudenumber, or nullThe latitude of the measurement
longitudenumber, or nullThe longitude of the measurement
lonlatarray (optional)The longitude and latitude of the measurement
citystring, or null (optional)The city of the measurement
zipstring, or null (optional)The ZIP code of the measurement
regionstring, or null (optional)The region of the measurement
countrystring, or null (optional)The country of the measurement

Web Measurement Properties​

A web measurement sent to analytics

PropertyTypeDescription
technologystring, or nullThe technology used for the web measurement (see subject in Public Config)
page_typestring, or nullA string describing the type of page
web_measurement_idintegerThe specific ID of the web measurement
client_report_valuesobject (optional)A hash of the data of all client reports for this measurement, keyed by the underscored client report type (e.g. performance_client_report). Only present when elasticsearch.index_conditions.index_web_measurements_with_client_reports is enabled.

Network Measurement Properties​

A network measurement sent to analytics

PropertyTypeDescription
technologystringThe technology used for the network measurement (see subject in Public Config)
network_measurement_idintegerThe specific ID of the network measurement

Speedtest Measurement Properties​

A speedtest measurement sent to analytics

PropertyTypeDescription
uploadnumber, or nullThe upload speed in Mbit/s
downloadnumber, or nullThe download speed in Mbit/s
pingnumber, or nullThe ping/latency time in milliseconds
remote_serverstring, or nullThe remote server used for the speedtest, if available
versionstring, or nullThe version of the speedtest, if available
speedtest_measurement_idintegerThe specific ID of the speedtest measurement

Video Measurement Properties​

A video measurement sent to analytics

PropertyTypeDescription
videoVideoThe video that was measured
play_modestring (one of: normal, embedded, lab_embedded, unknown) (optional)The play mode of the measurement. normal: A normal video playback in a browser tab or similar; embedded: A video embedded into a custom HTML webpage; lab_embedded: A video embedded into a lab app like Surfmeter; unknown: Not specified
servicestring (optional)The service that the video is hosted on
manifest_urlstring (optional)The URL of the MPEG-DASH/HLS manifest (if streamed from a manifest directly, or if the URL is known). This may not be known for some services.
playerstring (one of: avplayer, exoplayer, html5_player, dashjs_player, hlsjs_player, youtube_player, videojs_player, brightcove_player, unknown) (optional)The player that was used to play the video
player_versionstring, or null (optional)The version of the player that was used to play the video (if available)
playback_technologystring (one of: dash, hls, smooth, progressive, unknown) (optional)The playback technology that was used to play the video
video_measurement_idintegerThe specific ID of the video measurement
video_sequence_numberinteger, or null (optional)The 0-based position of this video among the videos in the same study (0 = first video played in the study). Null if the measurement is not part of a study.
client_report_valuesobject (optional)A hash of the data of the client reports for this measurement, keyed by the underscored client report type. Holds the byte_count_client_report alone, unless elasticsearch.index_conditions.index_video_measurements_with_client_reports is enabled, in which case it holds every client report of the measurement.

Video​

The video that was measured

PropertyTypeDescription
servicestringThe service that the video is hosted on
stream_idstringThe internal ID of the stream or video ID
is_reference_videobooleanWhether the video is a reference video (i.e., one that is repeatedly used in measurements)
content_typestring (one of: trailer, feature, advertisement, live, lab, unknown)The content type of the video, as set in the study description. Note that this has no implication on the results at the moment and is purely used for identification purposes.
durationnumber, or nullThe duration of the video in seconds (not available for live streams)
channel_titlestring, or null (optional)The title of the channel (if applicable)
channel_idstring, or null (optional)The ID of the channel (if applicable)
srcstring, or null (optional)A URL to the video (if available)
num_commentsnumber, or null (optional)The number of comments (if available)
num_dislikesnumber, or null (optional)The number of dislikes (if available)
num_likesnumber, or null (optional)The number of likes (if available)
num_viewsnumber, or null (optional)The number of views (if available)
titlestring, or null (optional)The title of the video

Conferencing Measurement Properties​

A conferencing measurement sent to analytics

PropertyTypeDescription
servicestringThe service that the conferencing measurement is for
conferencing_measurement_idintegerThe specific ID of the conferencing measurement
conferencing_measurement_groupConferencing Measurement Group (optional)The group of conferencing measurements that share a single conference, identified by a shared conference hash. Allows correlating multiple participants of the same conference.

Conferencing Measurement Group​

The group of conferencing measurements that share a single conference, identified by a shared conference hash. Allows correlating multiple participants of the same conference.

PropertyTypeDescription
shared_conference_hashstring, or null (optional)A hash that uniquely identifies the shared conference across multiple participants/measurements

Traceparents​

When the responses of a measurement carried a W3C traceparent header, the measurement's metadata contains the values in surfmeter.requests.traceparents:

{
"metadata": {
"surfmeter": {
"requests": {
"traceparents": [
"00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
]
}
}
}
}

Use these values to find the requests of a measurement in the logs or tracing system of your CDN. The field is filled for:

  • Lightweight Video Player measurements, since Surfmeter Automator v1.65.0 and Lightweight Video Player v0.10.0. See Trace context for details.
  • Browser-based measurements whose network requests are sent to the server, if this is enabled for your server. Contact us to enable it.

The field is missing when no response carried a traceparent header. Not every CDN sends this header in its responses; it may have to be enabled in your CDN configuration.

Connection Data Details​

The following properties are only available for MobileConnectionDetail:

FieldDescriptionTypeGSMWCDMALTECDMATDSCDMANR (5G)
mnoMobile Network Operatorstring✓✓✓✓✓†✓†
mccMobile Country Codestring✓✓✓✓✓†✓†
mncMobile Network Codestring✓✓✓✓✓†✓†
dbmSignal strength in dBminteger✓✓✓✓✓†✓†
signal_levelOverall signal levelinteger✓✓✓✓✓†✓†
asu_levelSignal level in ASUinteger✓✓✓✓✓†✓†
rssiReceived Signal Strength Indicatorinteger✓‡-----
rscpReceived Signal Code Powerinteger-✓--✓†-
ecnoEnergy per Chip to Noise Ratiointeger-✓‡----
rsrpReference Signal Received Powerinteger--✓*---
rsrqReference Signal Received Qualityinteger--✓*---
rssnrReference Signal Signal-to-Noise Ratiointeger--✓†---
arfcnAbsolute RF Channel Numberinteger✓¹✓¹✓¹---
bsicBase Station Identity Codeinteger✓¹-----
cidCell Identityinteger✓✓✓-✓†-
lacLocation Area Codeinteger✓✓--✓†-
pscPrimary Scrambling Codeinteger-✓¹----
uarfcnUTRA Absolute RF Channel Numberinteger-✓¹----
pciPhysical Cell Idinteger--✓--✓†
tacTracking Area Codeinteger--✓--✓†
bsidBase Station IDinteger---✓--
nidNetwork IDinteger---✓--
sidSystem IDinteger---✓--
cpidCell Parameters IDinteger----✓†-
nciNR Cell Identityinteger-----✓†
nrarfcnNR Absolute RF Channel Numberinteger-----✓†
ssrsrpSS Reference Signal Received Powerinteger-----✓†
ssrsrqSS Reference Signal Received Qualityinteger-----✓†
sssinrSS Signal-to-Noise and Interference Ratiointeger-----✓†

Footnotes:

  • ¹ Requires Android API level 24 (Android 7.0 Nougat) or higher
  • * Requires Android API level 26 (Android 8.0 Oreo) or higher
  • † Requires Android API level 29 (Android 10) or higher
  • ‡ Requires Android API level 30 (Android 11) or higher

Note:

  • The signal_level field is available for all network types when the device is running Android 11 or higher.
  • For GSM and WCDMA, rssi and rscp respectively are noted to be the same as dbm