Articles in this section

See more

Tapping Interval Active Task Export Format

  • Updated
Follow

In the Tapping Interval Test, the participant rapidly alternates tapping two targets on the screen with two fingers. The system tracks the location and speed of their taps.

When your project uses the CSV export format for Survey Results, data for Active Tasks is exported in the file SurveyTappingIntervalResults.csv. When your project uses the JSON export format, Active Task data is included in the file SurveyResults.json.

For a typical survey using this task, you'll expect to see:

  • One survey result each time the participant completes the survey.
  • One step result representing the Active Task.
  • One Tapping Interval result for that step. The individual taps are captured within this result.

Table of Contents

Data Fields

Field Description
SurveyTappingIntervalResultKey A unique, auto-generated observation ID for a single tapping interval attempt.
SurveyStepResultKey A unique, auto-generated key for this step result. Can be used to cross reference with other survey results.
SurveyResultKey The key for the survey result which this step result is contained in. Can be used to cross reference with other survey results.
ParticipantIdentifier The identifier of the participant this task was for. Can be used to cross reference with Participants.
ButtonRect1

Describes the rectangle for the left target button, in JSON format. Fields include:

  • Size: The width and height of the target, in screen coordinates.
  • Origin: The X and Y screen coordinates of the target.
ButtonRect2

Describes the rectangle for the right target button, in JSON format. Fields include:

  • Size: The width and height of the target, in screen coordinates.
  • Origin: The X and Y screen coordinates of the target.
StepViewSize The overall screen size available to the step, in screen coordinates, which gives context for the relative sizes of the buttons.
StartDate The timestamp for when the participant started the tapping interval attempt, in ISO 8601 format. Includes timezone offset information.
EndDate The timestamp for when the participant completed the tapping interval attempt, in ISO 8601 format. Includes timezone offset information.
Taps

A list of the individual taps made during the tapping interval attempt, in JSON format. Each tap reports:

  • Timestamp: A timestamp (elapsed seconds since the start of the tapping interval attempt).
  • ButtonIdentifier: Which button was tapped - left, right, or none.
  • Duration: The duration of the tap, in seconds, between the finger touching the screen and lifting up.
  • Location: The X and Y screen coordinates of the tap.

Sample CSV Export

SurveyTappingIntervalResultKey,SurveyStepResultKey,SurveyResultKey,ParticipantIdentifier,ButtonRect1,ButtonRect2,StepViewSize,StartDate,EndDate,Taps
1111-2222-3333,4444-5555-6666,7777-8888-9999,aaaa-bbbb-cccc,"{""Size"":{""Height"":104.0,""Width"":104.0},""Origin"":{""X"":79.0,""Y"":476.0}}","{""Size"":{""Height"":104.0,""Width"":104.0},""Origin"":{""X"":207.0,""Y"":476.0}}","{""Height"":753.0,""Width"":390.0}",2020-12-14T21:07:35+00:00,2020-12-14T21:07:46+00:00,"[{""Timestamp"":0.0,""ButtonIdentifier"":""Left"",""Duration"":0.090478180998616153,""Location"":{""X"":161.33332824707031,""Y"":557.0}},{""Timestamp"":0.375023753997084,""ButtonIdentifier"":""Right"",""Duration"":0.13912872800210607,""Location"":{""X"":254.0,""Y"":557.0}},{""Timestamp"":0.79039350599850877,""ButtonIdentifier"":""Left"",""Duration"":0.11910793299830402,""Location"":{""X"":127.0,""Y"":557.0}}]"

Sample JSON Export

Note that since the JSON export is included in the SurveyResults.json file, some of the reference keys either do not apply, or are part of the overall survey step data.

{
      "SurveyStepResultKey": "4444-5555-6666",
      "StepIdentifier": "TAPPING_TEST",
      "StartDate": "2020-12-14T21:07:35+00:00",
      "EndDate": "2020-12-14T21:07:46+00:00",
      "Results": [
        {
          "Type": "TappingIntervalResult",
          "TappingIntervalResultKey": "1111-2222-3333",
          "ButtonRect1": {
            "Size": {
              "Height": 104,
              "Width": 104
            },
            "Origin": {
              "X": 79,
              "Y": 476
            }
          },
          "ButtonRect2": {
            "Size": {
              "Height": 104,
              "Width": 104
            },
            "Origin": {
              "X": 207,
              "Y": 476
            }
          },
          "StepViewSize": {
            "Height": 753,
            "Width": 390
          },
          "Taps": [
            {
              "Timestamp": 0,
              "ButtonIdentifier": "Left",
              "Duration": 0.09047818099861615,
              "Location": {
                "X": 161.3333282470703,
                "Y": 557
              }
            },
            {
              "Timestamp": 0.375023753997084,
              "ButtonIdentifier": "Right",
              "Duration": 0.13912872800210607,
              "Location": {
                "X": 254,
                "Y": 557
              }
            },
            {
              "Timestamp": 0.7903935059985088,
              "ButtonIdentifier": "Left",
              "Duration": 0.11910793299830402,
              "Location": {
                "X": 127,
                "Y": 557
              }
            }
          ],
          "StartDate": "2020-12-14T21:07:35+00:00",
          "EndDate": "2020-12-14T21:07:46+00:00"
        }
      ]
    },

Related articles