DOI: 10.6084/m9.figshare.28211636
title: mLab App Paradata

description: # mLab App Paradata Data<br><br>This data is part of the publications associated with the analysis of paradata and user engagement with the mLab App, a digital health application designed to support at-home HIV testing. The dataset includes detailed user interactions, testing results, and metadata collected during a multi-site clinical trial. The data is divided into several files, each with its own schema and purpose, as described below.<br><br>**Notes:**<br>- The data has been de-identified and cleaned.<br>- The datasets originated from a REDCap project. Due to the different needs that the custom reports used to generate the dataset served, there may be redunancies across the different files.<br>- The `user_id` assigned to each user is consistent across each of the files (i.e., test windows in test_windows.csv for user_id == 10 correspond to user_id == 10 in para.csv, info.csv, etc.).<br>- Paradata collection was designed to operate asynchronously, ensuring that no user interactions were disrupted during data collection. As mLab was a browser-based technology, when users use browser navigation rapidly, there can be things that appear out of order (as we noted in our manuscripts).<br>- Dataframe column datatypes have been converted to satisfy specific analyses. Please check datatypes and convert as needed for your particular needs.<br>- <i>*Due to the sensitive nature of the survey data, the CSV/parquet files for survey are not included in this data repository. They will be made available upon reasonable request.*</i><br>- For detailed descriptions of the study design and methodology, please refer to the associated publication.<br><br>## File Descriptions<br><br>### facts.csv / facts.parquet<br><br>This file records the educational facts shown to users.<br><br><i>_Column Name_</i>: <i>_Description_</i><br>`display_timestamp`: Unix timestamp when an educational fact was displayed to the user.<br>`session_id`: Unique identifier for the user’s session when the fact was shown.<br>`user_id`: Unique identifier for the user the fact was shown to.<br>`fact_category`: Category of the educational fact displayed to the user.<br>`fact_index`: Index number of the fact shown to the user.<br>`fact_text`: Text of the educational fact displayed.<br><br>### info.csv / info.parquet<br><br>This file contains user-specific metadata, and repeated data about each user (alerts and pinned facts).<br><br><i>_Column Name_</i>: <i>_Description_</i><br>`user_id`: Unique identifier for the user.<br>`redcap_repeat_instrument`: REDCap field indicating the repeat instrument used. For general information about the user (userlocation and numberoflogins), redcap_repeat_instrument is blank. For repeated data (alerts, pinned facts, scheduled tests), redcap_repeat_instrument will identify the instrument.<br>`redcap_repeat_instance`: Instance number of the repeat instrument (if applicable).<br>`user_location`: Location of the user (if available). (1: New York City cohort; 2: Chicago cohort)<br>`alert_date`: A unix timestamp of when an alert was sent to the user.<br>`number_of_logins`: Total number of logins by the user.<br>`alert_subject`: Subject or type of the alert sent.<br>`alert_read`: Indicates whether the alert was read by the user (1: True; 0: False).<br>`end_date`: Unix timestamp of the end date of scheduled tests.<br>`start_date`: Unix timestamp of the start date of scheduled tests.<br>`fact_category`: Category of the educational fact pinned by the user.<br>`fact_index`: Index number of the fact pinned by the user.<br>`fact_text`: Text of the educational fact pinned by the user.<br>`fact_link`: Link to additional information associated with the fact pinned by the user (if available).<br><br>### para.csv / para.parquet<br><br>This file includes paradata (detailed in-app user interactions) collected during the study.<br><br><i>_Column Name_</i>: <i>_Description_</i><br>`timestamp`: A timezone-naive timestamp of the user action or event.<br>`session_id`: Unique identifier for the user’s session.<br>`user_id`: Unique identifier for the user.<br>`user_action`: Specific user action (e.g., button press, page navigation). "[]clicked" indicates a pressable element (i.e., button, collapsible/expandable menu) is pressed.<br>`current_page`: Current page of the app being interacted with.<br>`browser`: Browser used to access the app.<br>`platform`: Platform used to access the app (e.g., Windows, iOS).<br>`platform_description`: Detailed description of the platform.<br>`platform_maker`: Manufacturer of the platform.<br>`device_name`: Name of the device used.<br>`device_maker`: Manufacturer of the device used.<br>`device_brand_name`: Brand name of the device used.<br>`device_type`: Type of device used (Mobile, Computer, etc.).<br>`user_location`: Location of the user (1: New York City cohort; 2: Chicago cohort).<br><br>### survey.csv / survey.parquet<br><br>This file contains survey responses collected from users.<br><i>*NOTE: Due to the sensitive nature of this data, CSV/parquet files are not included in this data repository. They will be made available upon reasonable request.*</i><br><br><i>_Column Name_</i>: <i>_Description_</i><br>`user_id`: Unique identifier for the user.<br>`timepoint`: Timepoint of the survey (baseline/0 months, 6 months, 12 months).<br>`race`: Race of the user.<br>`education`: Education level of the user.<br>`health_literacy`: Health literacy score of the user.<br>`health_efficacy`: Health efficacy score of the user.<br>`itues_mean`: Information Technology Usability Evaluation Scale (ITUES) mean score.<br>`age`: Age of the user.<br><br>### tests.csv / tests.parquet<br><br>This file contains data related to the HIV self-tests performed by users in the mLab App.<br><br><i>_Column Name_</i>: <i>_Description_</i><br>`user_id`: Unique identifier for the user that took the test.<br>`visual_analysis_date`: A unix timestamp of the visual analysis of the test by the user.<br>`visual_result`: Result of the visual analysis (positive, negative).<br>`mlab_analysis_date`: A unix timestamp of the analysis conducted by the mLab system.<br>`mlab_result`: Result from the mLab analysis (positive, negative).<br>`signal_ratio`: Ratio of the intensity of test signal to the control signal.<br>`control_signal`: mLab calculated intensity of the control signal.<br>`test_signal`: mLab calculated intensity of the test signal.<br>`browser`: Browser used to access the app (from the User Agent string).<br>`platform`: Platform used to access the app (e.g., Windows, iOS) (from the User Agent string).<br>`platform_description`: Detailed description of the platform (from the User Agent string).<br>`platform_maker`: Manufacturer of the platform (from the useragUser Agentent string).<br>`device_name`: Name of the device used (from the User Agent string).<br>`device_maker` Manufacturer of the device used (from the User Agent string).<br>`device_brand_name`: Brand name of the device used (from the User Agent string).<br>`device_type`: Type of device used (Mobile, Computer, etc.) (from the User Agent string).<br><br>### test_windows.csv / test_windows.parquet<br><br>This file contains information on testing windows assigned to users.<br><br><i>_Column Name_</i>: <i>_Description_</i><br>`user_id`: Unique identifier for the user.<br>`redcap_repeat_instance`: Instance of the repeat instrument.<br>`start_date`: Start date of the (hard) testing window.<br>`end_date`: End date of the (hard) testing window.<br><br><br>## Citation<br><br>If you use this dataset, please cite the associated mLab and mLab paradata publications.<br><br><br><br>