Integrate with SONA Systems

This page describes how to configure a new Batch of participants that will be recruited through your institution's SONA recruitment site. You can read more about recruitment and batches in general on this page.

Entry URL

After having configured and comfirmed your batch, you'll enter this on SONA as the Study URL.

Entry variables

With these so-called query parameters you can store metadata about your participant from SONA with your Meadows data. This is required in order for the participant to report back to SONA with the Exit URL (see below).

survey_code (recommended)
Add this variable to store the participant's SONA ID on Meadows.

Exit URL

Here you should paste the Completion URL from SONA. Note that this typically includes the specific domain of your institution.

Exit variables

This modifies the completion (exit) URL so that SONA know which participant is reporting back

survey_code (recommended)
Forwards the participant's anonymous token to SONA so they can be marked as done.

Exit page

These are features of the final page on Meadows that the participant will see when they finish your experiment:

display exit link (recommended)
This will show a large green button that links back to SONA.
display completion code (NOT recommended)
As SONA does not use completion codes, but a participant-specific identity, this would simply display as empty.
display meadows alias
This will display the Meadows nickname (of the form "adjective-animal") on the final page, which may further help in your troubleshooting communication with the participant.
automatically forward to exit link (recommended)
If this is selected, after 4 seconds on the thank you page, the participant's browser will take them back to SONA.

You can test your configuration with the instructions on this SONA help page.