Data export
The collected raw data can be exported as a CSV file and further processed with any spreadsheet or statistical software. To do so, click on the desired realisation in the "Realisations" tab and then on the "Export" button in the top right corner. In the following dialogue box, you can configurate the time stamp format or the resampling, among other settings. You can now download time series data and metadata in table format.
Sync-Offset
The latency that occurs during communication between the device and the server is automatically measured and compensated. The offset that can occur as a result is displayed in the session info, but is already automatically corrected in the export. This means that the exported timestamps are directly comparable.
Darstellung der Skalen-Startwerte
In Playback Projekten können Medien im Part abgespielt und parallel Daten, z.B. auf Skalen, erhoben werden. Soll das Medium manuell von den Teilnehmenden gestartet werden, erscheint zu Beginn des Parts ein Popup Fenster mit einem Play Dialog. Mit der Skala kann man zu dem Zeitpunkt noch nicht interagieren. In der Exportdatei werden dennoch Tickchange-Events (mit negativem Zeitstempel) erzeugt, die den Initialwert der Skala anzeigen. Dieser muss erfasst werden für den Fall, dass der Zeiger von den Teilnehmenden nicht bewegt wird.
The columns of the exported file
| The columns of the exported file | Explanation |
|---|---|
| session_id | The ID of the current session (automatically created) |
| object_id | The ID of the object that was interacted with. This can be, for example, a scale (automatically created). |
| created_at | A time/date string in Unix millisecond format that can be used to read the time from when the event in question started. |
| created_at_relative | The relative time in milliseconds to the synchronisation event of the respective part. |
| x | Here, different values can be generated depending on the event and object [see table]. Generally, the X-value is used for horizontal scales. |
| y | Here, different values can be generated depending on the event and object. [see table]. Generally, the Y value is used for vertical scales. |
| object | Indicates the name or type of the associated object that was interacted with. |
| Part | The name of the active part, or "Part n". "n" indicates the position of the part in the sequence. |
| type | The type of the current event. More detailed descriptions of the different event types are explained in the next chapter. |
Event types
| Data (active interactions with the interface by the participant) | Explanation |
|---|---|
| Pointerchange | Within a 2D scale, the participant has pressed the left mouse button and moved the mouse, or touched the touch screen and moved the finger/ stylus.
Note: Since version 1.6.1 (02.09.2022), the values of the pointer position within the 2D scale are standardised to values between 0 and 1. The point 0/0 is located in the lower-left corner of the scale. In earlier versions, the values output were the position of the pointer within the entire interface instead of within the scale. They thus varied depending on where the scale was positioned in the part. |
| Dblclick | The participant has double-clicked within a part. |
| Tickchange | The participant changes the value of a one-dimensional scale. The output X- or Y-value corresponds to the value of the selected step. |
| Check | The participant changes the value of a multiple-choice category scale. A comma-separated list with labels of the selected options is printed. |
| Optionchange | he participant changes the value of a single-choice category scale. The label of the selected option is printed. |
| Button | A button was clicked. |
| Buttontap | A tap button was clicked. Two events are generated: one for pressing and one for releasing the button. This keeps track of how long the button was pressed. |
| Buttonsingle | The single-use button outputs its current state for each event: 0 for "not pressed", 1 for "pressed". |
| Buttontoggle | The toggle button was clicked and changed its status. It outputs its current state at each event like the single-use button: 0 for "not pressed", 1 for "pressed". |
| Meta (passively triggered events by interaction with the participant's device) | Explanation |
| Part | The currently displayed part has changed. The event is triggered when the manager selects a different part from the current one in an ongoing live study and it is displayed in the Participant Interface. In a playback study, the event is selected when buttons in the participant interface have been used to navigate to another part and the new part is displayed. |
| Blur | emoTouch is running in the background. The event is triggered when the participant switches to another window, tab or application during an ongoing study. |
| Focus | The event is triggered when the Blur state is ended. The participant has switched back to the tab/window with emoTouch as the application currently running in the foreground. |
| Play | A medium starts playing. |
| Ytstatechanged | For an embedded YouTube video, certain values of the API are printed. For example, the time when the video actually starts playing. More information on this can be found at Documentation of the intersection |
| Fullscreen | The display of the study is changed from window mode to fullscreen mode. |
| Orientationchange | The screen orientation of the user's mobile device is about to change. The event is triggered when the participant turns their mobile device 90° during an ongoing study. |
| Orientationchangeend | The screen orientation of the user's mobile device has fully changed. The event is triggered when the participant is done turning their mobile device 90° during an ongoing study. |
| End-Events | Are generated automatically for each interactive element for resampling. |
Sources
- https://developers.google.com/youtube/iframe_api_reference?hl=de#Playback_status (last access 28 Feb 2022).