Participants Archives | SnapSurveys Support documentation for Snap Surveys products Mon, 18 Dec 2023 11:12:15 +0000 en-GB hourly 1 https://wordpress.org/?v=6.4.5 https://www.snapsurveys.com/support-snapxmp/wp-content/uploads/2020/07/favicon-32x32-1.png Participants Archives | SnapSurveys 32 32 Managing your participants https://www.snapsurveys.com/support-snapxmp/snapxmp/managing-your-participants/ Tue, 30 Jun 2020 10:01:56 +0000 https://www.snapsurveys.com/support-snapxmp/?post_type=epkb_post_type_1&p=580 View participants settings This table describes each option in the overview summary. Option Description Questionnaire type Shows whether this is a Standard or Group questionnaire. Interview access Displays information regarding whether participants need to log in. This is set in Snap XMP Desktop. Identify respondents Shows whether you will be able to see which respondent […]

The post Managing your participants appeared first on SnapSurveys.

]]>
View participants settings
  1. Open your survey in Snap XMP Online and from the survey’s Summary navigate to the Collect section.
  2. Select the Participants side menu to view the participants and invitations. The Participants Overview is selected by default.
Participants side menu with Overview highlighted
  1. The main overview area shows the Participants overview. An example of the overview is shown below.
Participants overview

This table describes each option in the overview summary.

OptionDescription
Questionnaire typeShows whether this is a Standard or Group questionnaire.
Interview accessDisplays information regarding whether participants need to log in. This is set in Snap XMP Desktop.
Identify respondentsShows whether you will be able to see which respondent has submitted the response data. This can be changed in the Interview Access dialog.
Multiple responsesShows whether a participant can submit more than one response to the current survey. This can be changed in the Interview Access dialog.
Participant access expiresDisplays the length of time that the participant has to complete the survey before it expires. The default is after 30 days from the time the first invitation is sent. This can be changed in the Interview Access dialog.
Invitations statusDisplays whether the invitations are being sent or not. This will display Invitations are not currently being sent prior to the invitations being started or when they have been paused and Invitations are being sent when they have been activated. This is changed in the Invitations section of Participants using the Start sending invitations and Pause invitations buttons.
Completion rateDisplays both the percentage and count of the number of participants who have completed the survey.

Change the interview access for participants

You can change some of the participant’s settings in the Interview access dialog.

  1. Open your survey in Snap XMP Online and from the survey’s Summary navigate to the Collect section.
  2. Select the Participants side menu to view the participants and invitations. The Participants Overview is selected by default.
Participants side menu with Overview highlighted
  1. Click the Change Interview Access button to show the Interview access dialog.
Interview access settings
  1. The settings for interviewing can be changed and are described in the table.
OptionDescription
Identify respondents in the response dataSet when you want to identify the respondent who completed the response data.
Allow participants to submit multiple responsesSet to allow participants to respond as many times as they like. When it is not set each participant may only respond to the survey once.
Running partials …Displays the status information for running partials in the interview process. Partials cannot run in a survey that allows multiple responses.
Participants have a limited time to respondSets a time limit on how long the survey is open for responses. The number of days before the survey expires can be set. The default is 30 days after the first invitation has been sent.
  1. Click Save to update the settings.

View participant details

The Participant list shows the list of all the participants in the current survey, along with their login details and invitation status.

  1. Open your survey in Snap XMP Online and from the survey’s Summary navigate to the Collect section.
  2. Select the Participants side menu to view the participants and invitations. The Participants Overview is selected by default.
  3. Click on the Participant list menu item to view the participants.
Participants side menu with Participants highlighted
  1. The Participant list is displayed in the overview area.
Participant list
ColumnDescription
LoginThe login of the participant that is used to log in and complete the survey.
Email addressThe email address used to send the invitations and reminders.
EnabledThe participant can be enabled or disabled.
StatusThis is the status of the survey completion process. These are the available status settings.                                           
Not Started  The participant has not logged into the survey.
Started  The participant has logged in and seen at least the first page of the interview
PartialThe participant has logged in and moved past the first page of the interview or the participant has come back to a saved interview and progressed to the next page.
SavedThe participant has clicked the Save button part way through interview.
Completed  The participant has finished the interview and clicked the Submit button.
SubmittedThe researcher has closed the participant’s partial, and the data is now in the response file.
Send invitesFlags whether email invitations will be sent.
Opted outIndicates whether the participant has opted out of the survey and any correspondence regarding this survey only.

The columns shown in the Participant list depend on the options selected when the participant data is uploaded from Snap XMP Desktop to Snap XMP Online.

Sorting the participant list

Send email invitations onlyLog in respondent onlyLog in respondent with Send email invitationsLog in respondent with Seed database data
Login Image: tickImage: tick Image: tick
Email addressImage: tickImage: tick 
EnabledImage: tickImage: tickImage: tickImage: tick
StatusImage: tickImage: tickImage: tickImage: tick
Send invitesImage: tick Image: tick 
Opted outImage: tick Image: tick 

The participant list can be sorted by Login or Email address. The list is displayed initially with the participants sorted by Login in ascending order.

Participant list sorted by Login
  1. Click the Email address column header to sort by Email address in ascending order.
  2. The Up arrow  icon shows that the sorting is in ascending order.
  3. Click the Email address column header again to sort in descending order.
  4. The Down arrow icon shows that the sorting is in descending order.
  5. Click the Email address column header once more removes the sorting and no icon is displayed. Repeat the process to display a different sort order.

Expand the participant details

You can expand each participant to see a more detailed view of the invitation schedule and seeding data.

  1. Click the Details arrow icon button at the left hand side of a participant row to expand the information held for the selected participant.
  2. The details are split into three sections.
    • Schedule shows the times that the invitations and reminders will be or have been sent.
    • Invitation seeding shows the participant data that is seeded in the invitations.
    • Questionnaire seeding shows the participant data that is seeded in the questionnaire.
Participant details expanded
  1. There are four actions that can be performed on each participant from the expanded participant details.
    • Edit opens the Edit participant dialog where the participant’s details can be changed.
    • Reset opens the Reset participant dialog where aspects of the invitation can be reset.
    • Preview questionnaire opens a preview of the questionnaire for that participant containing the questionnaire seeding information.
    • Delete opens the Delete participant dialog where you can remove this participant from this survey.

The table shows the actions that are available for the different distribution options.

Send email invitations onlyLog in respondent (with any other options)
EditImage: tickImage: tick 
ResetImage: tickImage: tick
DeleteImage: tickImage: tick
Preview Questionnaire Image: tick

Edit a participant

The participants list initially shows the data that was generated in Snap XMP Desktop. If you need to make any changes you can edit the participant’s data including the seeding data in Snap XMP Online.

  1. Click the Edit button that is at the right hand end of the participant that you want to edit. This displays the Edit participant dialog with the participant’s data entered.
Edit the participant details
  1. The dialog is split into 3 sections
    • Identity and status displays the participant’s login details and invitation settings shown in the participant list.
    • Invitation seeding displays the seeding data that will be used in the invitation. In the example above, the First name is shown. There can be multiple fields in this section depending on how the invitation is set up.
    • Questionnaire seeding displays the seeding data that will be used in the questionnaire. The fields in this section depend on the initial set up in Snap XMP Desktop.
  2. When you have made your changes click Save to save your changes.

These are the fields that are displayed with the different distribution options.

Send email invitations onlyLog in respondent onlyLog in respondent with Send email invitationsLog in respondent with Seed database data
LoginImage: tick Image: tickImage: tick
PasswordImage: tickImage: tickImage: tick
Email addressImage: tick Image: tick 
EnabledImage: tick Image: tickImage: tickImage: tick
Send invitesImage: tick Image: tick 
Opted outImage: tick Image: tick 
Invitation seedingImage: tick Image: tick 
Questionnaire seeding   Image: tick

Preview the questionnaire for the selected participant

The preview questionnaire option, available for each participant, will take you through a test version of the questionnaire for the selected participant. This allows you to check that any seeded data for the selected participant is entered correctly as you progress through the test questionnaire.

  1. Click the Details arrow icon button at the left hand side of a participant row to expand the information held for the selected participant.
  2. Click the Preview questionnaire button.
Preview questionnaire with the participant seeding
  1. The survey preview page will display. Click the I understand – start the preview link at the bottom of the page to start the preview questionnaire.
  2. When running the questionnaire you can check that the questionnaire seeding is showing the correct values for the selected participant.
  3. The preview will not save any response data.

Filter the participant list

If you have a large list of participants you can view a subset of participants by using the filter function.

  1. Click the filter symbol Filter icon on the column header that you wish to filter on.
  2. This displays the filter dialog for the particular column.
ColumnFilter selectorValue
Login Email addressChoose Contains or Starts withEnter the text that you want to use to match the participant’s Login or Email address.
EnabledChoose whether participants are Enabled or Disabled 
StatusChoose Is or Is notSelect a status value Not started Started Partial Saved Completed Submitted
Send invitesChoose whether invitations are Enabled or Disabled 
Opted outChoose whether participants Have opted out or Have not opted out 
  1. Click
    • Filter to show the filtered participants
    • Clear to remove an existing filter on the selected column.

Add a participant

You can add a new participant to your survey.

  1. Click the Add Participant button in the main participant list menu. This displays the Add participant dialog.
Add a new partiicpant
  1. The dialog is split into 3 sections
    • Identity and status displays the participant’s details from the participant list.
    • Invitation seeding displays the seeding data that will be used in the invitation. In the example above the First name is shown, but there may be multiple fields in this section depending on the invitation set up in Snap XMP Desktop.
    • Questionnaire seeding displays the seeding data that will be used in the questionnaire. The fields in this section depend on the initial set up in Snap XMP Desktop.
  2. The Login entered must be unique within the participant list for the selected survey.
  3. The Email address must be a valid email address.
  4. Values for the Invitation seeding may be left blank. You will need to consider the impact on the invitation wording when the emails are sent out.
  5. Values for the Questionnaire seeding may be left blank. When the participant completes the survey the corresponding questions will be left blank also.
  6. When you have made your changes click Save to save your changes.

These are the fields that are displayed with the different distribution options.

Send email invitations onlyLog in respondent onlyLog in respondent with Send email invitationsLog in respondent with Seed database data
LoginImage: tick Image: tickImage: tick
PasswordImage: tickImage: tickImage: tick
Email addressImage: tick Image: tick 
EnabledImage: tick Image: tickImage: tickImage: tick
Send invitesImage: tick Image: tick 
Opted outImage: tick Image: tick 
Invitation seedingImage: tick Image: tick 
Questionnaire seeding   Image: tick

Reset participants

The Reset button can be used to reset different aspects of the interview schedule for participants at both the individual or group level.

Reset a participant

  1. Click the Details arrow icon button at the left hand side of a participant row to expand the information held for the selected participant.
  2. Click on the Reset button in the expanded participant details.
Reset an individual participant
  1. This will display the Reset Participant dialog. The first line shows that you are about to reset the selected participant by displaying their login.
  1. You are able to reset the
    • Activation time

This resets the time set for Participant activated and Access expires to the time that the participant is reset by clicking the Reset participants button. This is only shown when invitations are used.

  • Invitations schedule

This resets the time scheduled for the invitations and reminders to be sent out. The first invitation is scheduled to the time that the participant is reset by clicking the Reset participants button. The following reminders are rescheduled according to the Days to wait before sending. This is only shown when invitations are used.

  • Completion status

This resets the participant to the Not started status, discarding any partial responses but keeping submitted responses.

  • Select the options that need to be reset.
  • Click Reset participants to reset the participants.

Reset a group of participants

  1. Navigate to the Participant list in the Participants section.
  2. Click on the Reset button in the Participant list overview.
  3. This will display the Reset Participants dialog where you select which participants you would like to reset.
Select the group of participants to reset
Reset
  1. There are three selection criteria available
    • All participants
    • By the participant’s Send invites status
    • By the participant’s completion Status
  2. Click Next to proceed to select which aspects to reset.
Reset participants wizard final page
  1. You are able to reset the
    • Activation time

This resets the time set for Participant activated and Access expires to the time that the participant is reset by clicking the Reset participants button. This is only shown when invitations are used.

  • Invitations schedule

This resets the time scheduled for the invitations and reminders to be sent out. The first invitation is scheduled to the time that the participant is reset by clicking the Reset participants button. The following reminders are rescheduled according to the Days to wait before sending. This is only shown when invitations are used.

  • Completion status

This resets the participant to the Not started status, discarding any partial responses but keeping submitted responses.

  1. Select the options that you require to be reset.
  2. Click Reset participants to reset the participants.

Delete participants

You are able to delete participants from the participants list. You can delete a single participant or a group of participants.

Delete a group of participants

  1. Navigate to the Participant list in the Participants section.
  2. Click the Delete button to delete a group of participants.
  3. The Delete Participants dialog displays and shows a number of selection options.
Delete participants
  1. There are four selection criteria available
    • All participants
    • By whether the participant has opted-out
    • By the participant’s Send invites status
    • By the participant’s completion Status
  2. Click Next to proceed to the delete confirmation message.
Delete participants confirmation
  1. Check that you wish to delete these participants and tick the confirmation.
  2. Click Delete to delete these participants from the survey.
  3. When the deletion is completed you are shown a delete confirmation message. Click Finish.

Delete a participant

  1. Navigate to the Participant list in the Participants section.
  2. Click the Details arrow icon button at the left hand side of a participant row to expand the information held for the selected participant.
Delete an individual participant
  1. Click the Delete {Login} button. A delete confirmation message is displayed.
Delete participant confirmation
  1. The message identifies the participant by the Login. Check that this is the correct participant and tick the confirmation.
  2. Click Delete to delete the participant from the survey.
  3. When the deletion is completed you are shown a delete confirmation message. Click Finish.

Remove All Participants and response data

When your survey is finished you may want to remove all the participants from the Participant list and remove all the response data.

  1. Open your survey in Snap XMP Online and from the survey’s Summary navigate to the Collect section.
  2. Select the Participants side menu to view the participants and invitations. The Participants Overview is selected by default.
  3. Click Remove Participants.
  4. Select the check box I confirm I want to remove the Participants feature.
  5. This cannot be undone. If you wish to proceed click Reset.

Export participants data

The participants’ data can be exported to an Excel or CSV file using the appropriate option in the Export menu.

  1. Click on the Export menu. This displays two options to export to an Excel file or a comma separated values (CSV) file format.
Export menu
  1. When you have chosen the file format you need select the relevant menu option. The filename is given the name {Survey name} – participants with the suffix .csv or.xlsx depending on the export format selected. If there is more than one export for the survey the file name will have a bracketed number before the suffix. An example of an export file is Conference – participants.csv.
  2. A download ready message is displayed once your file is exported. The file can be found in your download directory.

The post Managing your participants appeared first on SnapSurveys.

]]>
Uploading participants from a spreadsheet https://www.snapsurveys.com/support-snapxmp/snapxmp/uploading-participants-from-a-spreadsheet/ Thu, 25 Jun 2020 15:32:11 +0000 https://www.snapsurveys.com/support-snapxmp/?post_type=epkb_post_type_1&p=419 Uploading the file containing participant information lets you: The Upload Participants Wizard is used to set up participants for your survey and guides you through the following steps. What you need in your file (for seed data, email invites and/or logins) To send emails To login participants To seed data into your survey A unique […]

The post Uploading participants from a spreadsheet appeared first on SnapSurveys.

]]>
Uploading the file containing participant information lets you:

  • provide the participants’ names and email addresses
  • set up a requirement to login and seed the survey with participants’ login data
  • seed the survey with other participants’ data that is used during completion
  • create email invitations and reminders

The Upload Participants Wizard is used to set up participants for your survey and guides you through the following steps.

  1. Select the file containing the participant data. The accepted formats are CSV or Excel.
  2. Select whether you wish to link to participants, create email invitations and seed the survey with data.
  3. Choose whether to run this as a standard or group questionnaire.
  4. Define the email invitations and reminders.
  5. Specify the mapping between the survey variables and the data fields.
  6. Upload the participants in Snap XMP Online.

What you need in your file (for seed data, email invites and/or logins)

To send emailsTo login participantsTo seed data into your survey
A unique email address for each respondentA unique login for all participants (this can be their email address)A database field for each survey variable that you want to load with data

This table shows the required elements for each database record for the different operations.

Unique email addressUnique
participant login
Participant passwordFields containing data
Send email invitationsTick   
Participants login Emails do not have to be unique for loginTick(may be email address)If required 
Seed data Tick(may be email address) TickOne database field per survey variable to load with data

An example of an Excel database file is shown below.

Example of an Excel spreadsheet used to upload participants

This data file contains

  • unique email addresses used to send email invitations
  • user names and password data used for participant logins
  • two columns that contain seed data, First name and Age

Note: Age is a single choice question and the data refers to the codes

Upload participants using the Upload Participants Wizard

Use the Upload Participant Wizard to add your participants to the survey.

  1. Open your survey in Snap XMP Online and from the Summary tab navigate to the Collect section.
  2. Select the Participants side menu to view the participants and invitations. The Participants Overview is selected by default.
  3. Click on the Participant list menu item to view the participants.
Participants side menu with Participants highlighted
  1. Click on Upload Participants to open the Upload Participants Wizard.
  1. On the first page, click Select file to add the file with the participants’ data. The accepted formats are CSV and XLSX. Click Next.
Upload participants wizard - select the spreadsheet
  1. On the next page, select the survey options for sending email invitations
  2. If you want to invite the participants by email
    • Select Send email invites/reminders
    • In Email address field, select the spreadsheet column that contains the email address for the participants. This field is required and Snap XMP Online attempts to match the most likely column.
    • Select Seed data into invites/reminders if you want to seed data into the invitations, such as, name or surname, which can personalize the message.
  3. If you do not want to use email invitations
    • Clear Send email invites/reminders. This disables the Email address field and Seed data into invites/reminders checkbox.
    • On the same page you can set whether to track respondents using login details or to create an anonymous survey.
Upload participants wizard - select invitation options
  1. If you want to track your respondents
    • Select Allow Snap Online to track your respondents for questionnaire seeding
    • In Login field, select the spreadsheet column that contains the Login for the participants. This field is required and needs to be unique as it is used to track the participant. Snap sets the default as the first column in the spreadsheet.
    • In Password field, select the spreadsheet column that contains the Password for the participants.
    • Select Seed data into questionnaire when your spreadsheet contains data that you want to default into the questionnaire as the participant is completing it.
    • Select Group questionnaire if you are running a group questionnaire. This is covered in the Group questionnaire section.
  2. If you want to run an anonymous survey
    • Clear Allow Snap Online to track your respondents for questionnaire seeding. The other fields in this section become disabled.
Upload participants wizard - select login options
  • Click Next. If you have selected Seed data into invites/reminders the next page lets you set this up.
  • Select a spreadsheet column from the Spreadsheet Column list and click Add next to the selected column. This adds another field below. Repeat for all the columns you need for your invitations and reminders.
Upload participants wizard - invitation seeding
  • Click Next. If you selected Seed data into questionnaire the next page lets you set this up.
  • Select a spreadsheet column from the Spreadsheet Column list then select the question to seed from the Snap  Variable list
  • Click Add next to the row. This adds another row below. Repeat for all the columns you need for your questionnaire seeding
Upload participants wizard - questionnaire seeding
  • In Single and Multiple Choice questions you can map values found in Spreadsheet Column to the code labels in Snap Variable. For each Spreadsheet Value select the corresponding Snap Variable Code Label. Click OK when you have finished returning to the wizard.
Upload participants wizard - questionnaire seeding values
  • Click Next. The overview summarizes the chosen settings for you to review.
  • Click Upload to upload the participants to the survey. The results are displayed when the upload is complete.
Upload participants wizard - overview

Updating the participant data

During interviewing you may want to update the participants who are responding to your survey. This is done using the Upload Participants Wizard.

  1. Open your survey in Snap XMP Online and from the survey’s Summary navigate to the Collect section.
  2. Select the Participants side menu to view the participants and invitations. The Participants Overview is selected by default.
  3. Click on the Participant list menu item to view the participants.
  4. Click on Upload Participants to open the Upload Participants Wizard.

The first page gives three options to update the participants

OptionDescription
Add new participants onlyParticipants in the spreadsheet that are not already in the list will be added. The survey options for sending invitations and tracking the response cannot be changed.
Update participantsParticipants in the spreadsheet that are in the list will be updated (seeding properties will also be replaced). Participants in the spreadsheet but not in the list will be added. The survey options for sending invitations and tracking the response cannot be changed.
Replace all participantsNew participants will be added. Participants in the spreadsheet that are in the list will be updated (seeding properties will also be replaced). Participants that are in the list but absent from the spreadsheet will be deleted. Existing response data will NOT be deleted. The survey options for sending invitations and tracking the response can be changed.
Delete participantsAll current participants will be deleted. The response data will NOT be deleted.
  1. Select the option you require then click Next. The wizard shows the same pages as described in the Upload Participants Wizard section.

The post Uploading participants from a spreadsheet appeared first on SnapSurveys.

]]>