Create Study via URL
Video explaining the concept: Create Study via URL - YouTube
You can help your users easily publish a study on prolific by creating a link that will automatically fill in the complicated aspects of a new study.
Below is an example of this link; please copy this into your browser and see what it does!
https://app.prolific.co/researcher/studies/new?name=Your%20study%20title&internal_name=Your%20study%20internal%20name&description=Your%20study%20description&external_study_url=https%3A%2F%2Funiversity.org%3FPROLIFIC_PID%3D%7B%7B%25PROLIFIC_PID%25%7D%7D%26STUDY_ID%3D%7B%7B%25STUDY_ID%25%7D%7D%26SESSION_ID%3D%7B%7B%25SESSION_ID%25%7D%7D&completion_code=DOSL45F&completion_option=url&prolific_id_option=url_parameters
As you can see, it auto-fills the following example query parameters (url encoded):
name=Your study title
internal_name=Your study internal name
external_study_url=https://university.org?PROLIFIC_PID={{%PROLIFIC_PID%}}&STUDY_ID={{%STUDY_ID%}}&SESSION_ID={{%SESSION_ID%}}
prolific_id_option=url_parameters
completion_code=DOSL45F
completion_option=url
The name parameter is the study title. It can be anything, it could be the same name as your survey.
The internal_name param is your internal_name.
The description param is your study description.
The external_study_url param is your study link.
The prolific_id_option can be either:
-
questionWhich means the study needs to ask the user to fill in their prolific id. -
url_parametersAllows you to pass the PROLIFIC_PID (as shown in the example above) back to your survey. More information about this can be found here
You need to create a unique completion_code
for every study, this is what allows users to verify that they have completed your survey.
The completion_option is the way the participant verifies that they have completed the study.
It can be either:
-
codeThat the user will get from the survey and fill into prolific -
urlThe end of the study will then need to be redirected to this link
https://app.prolific.co/submissions/complete?cc=<completion_code>
to automatically submit a completion for the participant.
A small example of simple UI to build the Create Study via URL - JSFiddle - Code Playground