In this tutorial we will be taking a look at how to create an experience sampling method project in psychexp.
The Psychexp Experience Sampling Method (ESM) Survey platform combines both a convenient and intuitive interface for the researcher together with an ease of use experience for the respondent. The ESM project utilizes a progressive web application (PWA) to send notifications to inform respondents when it is time to answer a survey, and the respondents respond on their device's web browser, ensuring a reliable reach and extremely high response rate. The Psychexp ESM platform is compatible with numerous types of ESM research and is highly customizable.
An ESM project requires some form of signalling system to inform the respondents that it is time to participate in a survey. The Psychexp ESM platform utilizes a progressive web app (PWA) to deliver such a signal to the respondents mobile device.
A PWA is a very small javascript program that is downloaded from a link and installed like an addon to the device's browser. Once installed to the browser it looks and feels like any other native app on a mobile device, however in actual fact it is just a cleverly disguised web browser window that can receive a notification (signal) and can also display the notification to inform the respondent when it is time to complete a survey.
Unlike a native app that can require hundreds of MEGABYTES of space, the Psychexp PWA only requires a few hundred KILOBYTES of space to install the javascript to the browser. Additionally, unlike a native app the psychexp PWA does not need permission to access any part of the respondent's device and only requires permission to receive notifications to the device's browser. A PWA can be installed on either an IOS (safari) or ANDROID (chrome) device. PWA technology and the ability to send notifications to a PWA has been available on the ANDROID platform for many years, however sending notifications to a PWA on IOS is relatively new and as such requires IOS 16.4 or higher to operate correctly.
Installation of the PWA is quick and easy and once installed the respondent needs only to enter a 4 digit code to register for your ESM project. (An email address will also need to be entered if you select to have your ESM project require email registration) The 4 digit code and the PWA download link are both displayed on the registration page so you only need to supply your resondents with the project's registration link or QR-code in order to have them sign up for your project.
Once installed the PWA is accessed from an icon that is automatically displayed on the device's home screen, or when a notification arrives to the device the PWA is automatically opened when the respondent clicks on the notification. Once the PWA is opened all current and past signals are displayed and clicking on a signal directly opens the ESM survey page for that signal in a browser window.
If you would like to install the Psychexp PWA and send a test notification to your device, firstly open this page on your mobile device and then click the following link to install the pwa.
Psychexp PWA
The Psychexp ESM offers the researcher a very large degree of design freedom. You can create multiple sets of questions and assign a different question set to each signal that is sent to the respondent. An ESM question set can utilize the same functionality as any other type of Psychexp project, including the ability to insert an experiment into the question flow.
For example, let's say you wish to create a survey schedule consisting of one pre-survey, then one ESM: morning and evening signal x 4 days, and one post-survey. With the Psychexp ESM, you can create the pre-survey, ESM, and post-survey question sets within a single project, which means your respondent only needs to register once to participate in all surveys. It is also possible to create different sets of questions for the morning and evening surveys, or to display a different set of questions for every signal sent.
Creating an esm is as simple as clicking "Add New Project", entering a name for your project and selecting "ESM" from the project type list.
Once you have created your project you can edit it in the same way as you would any other type of Psychexp project. For full details of how to edit a project please refer to the "Getting Started" tutorial.
When creating your question sets it is very important to plan them in advance.
After planning out your ESM survey, proceed with the following steps to create each question set.
At the top of the edit project page, you will find the [Question set] section.
Directly under the [Question set] section, the edit screen is displayed containing the components in [Question set 1].
Here you will find a [Default block] that contains one [Single choice] question. You can edit this question and also add more blocks, questions or experiments to complete your [Question set 1].
Clicking the [ADD QUESTION SET] button will create the new [Question set 2].
Create the required blocks, questions and experiments in [Question set 2] in the same way as the previous step.
Clicking on the [DUPLICATE THIS QUESTION SET] button will copy the contents of the question set currently displayed into a new question set.
For example, duplicating [Question set 2] will create [Question set 3] with exactly the same content.
Clicking the [DELETE THIS QUESTION SET] button will delete the entire question set that is currently displayed.
Once a question set has been deleted it cannot be restored. If there is currently only one question set, or if the question set you are trying to delete is assigned to a signal on the settings page, then an error message will be displayed and the question set is unable to be deleted.
Once you have created your question sets, you can then create your ESM signals on the PROJECT SETTINGS page. The method of setting the signals varies depending on the type of ESM.
The following is a step-by-step explanation.
SET SIGNALS BY DAY NUMBER
In the [SET SIGNALS BY DAY NUMBER] ESM, for each signal, the date (DAY#), send time, and question set number needs to be set.
Before setting the signals, carefully plan a research schedule.
Referring to the chart below, make a diagram that reflects the research schedule that you have planned.
Tips for creating your research schedule.
Please pay particular attention to the timing of when the first signal will be sent.
Once you have finished planning your research schedule, you can begin to set the signals in accordance with the plan.
Create the required number of sending times in accordance with your research plan.
The diagram below shows the send times created in accordance with the schedule in the [SET SIGNALS BY DAY NUMBER] ESM example diagram shown above.
Create and edit the settings for the required number of signals in accordance with your research plan.
Once you have set all your signals, it is time to check if they match the research plan you created.
Click the TEST SIGNALS button located directly beneath the section where you made your times and signals. Signal times for each day will be displayed in accordance with the settings you created.
SET SIGNALS BY WEEKDAY
In the [SET SIGNALS BY WEEKDAY] ESM, for each signal, the day of the week, send time, and question set number needs to be set.
Before setting the signals, carefully plan a research schedule.
Referring to the chart below, make a diagram that reflects the research schedule that you have planned.
Tips for creating your research schedule.
Please pay particular attention to the timing of when the first signal will be sent.
Once you have finished planning your research schedule, you can begin to set the signals in accordance with the plan.
Create the required number of sending times in accordance with your research plan.
The diagram below shows the send times created in accordance with the schedule in the [SET SIGNALS BY WEEKDAY] ESM example diagram shown above.
Once you have set all your signals, it is time to check if they match the research plan you created.
SET SIGNALS BY DAY OF THE MONTH
In the [SET SIGNALS BY DAY OF THE MONTH] ESM, for each signal, the day of the week, send time, and question set number needs to be set.
Before setting the signals, carefully plan a research schedule.
The procedure for making a schedule diagram is mostly the same as for [SET SIGNALS BY WEEKDAY] however, instead of a weekly cycle a monthly cycle is made.
Tips for creating your research schedule.
Once you have set all your signals, it is time to check if they match the research plan you created.
SET SIGNALS EVERY [N] DAYS
In the [SET SIGNALS EVERY [N] DAYS] ESM, for each signal, the number of days cycle to wait in between signals, send time, and question set number needs to be set.
Before setting the signals, carefully plan a research schedule.
Referring to the chart below, make a diagram that reflects the research schedule that you have planned.
Tips for creating your research schedule.
Please pay particular attention to the timing of when the first signal will be sent.
Once you have finished planning your research schedule, you can begin to set the signals in accordance with the plan.
Create the required number of sending times in accordance with your research plan.
The diagram below shows the send times created in accordance with the schedule in the [SET SIGNALS EVERY [N] DAYS] ESM example diagram shown above.
Once you have set all your signals, it is time to check if they match the research plan you created.
With an editable project you can firstly get your respondents to sign up to the project, and then after that, at any time, as often as you wish, you can create a new survey (question set) and send all or individual respondents a signal to inform them it is time to do the survey.
Firstly let us look at the difference between an ESM and an EDITABLE RROJECT. With an esm, once a respondent registers for the project the project locks and no changes can be made to any question sets. With an EDITABLE PROJECT the project does not lock when respondents register. Instead, each question set locks when you send a signal containing that question set to any respondents.
The following example shows just one scenario of how an EDITABLE PROJECT could be used.
Once you have created your question set you can send your respondents a signal by going to the SEND SIGNAL page.
Multiple signals can be scheduled to be sent to all or individual respondents. However, please note caution is required as once a signal has been registered it cannot be deleted and will be sent to the selected respondents.
For an editable project each question set has an individual dataset. To download the data go to the DATASET page and select the question set you require from the dropdown menu, then enter your column names and save the changes before clicking the download button.