This guide will walk you through how to use URL parameters.

URL parameters allow the researchers to pass additional information to/from participants by appending the study URL. This may allow you to track Participant IDs for internal recruitment, force participants into specific tasks/conditions, or collect other information stored in the study URL.

MUiQ platform has 2 types of URL parameters:

1) Default URL Parameters

2) Custom URL Parameters

The URL Parameters can be found in your study by navigating to Information/Settings > URL Parameters. 

Default URL Parameters

There are 4 types of Default URL Parameters

Participant ID:

This parameter allows the researchers to uniquely identify each participant. When this parameter is included in a URL, the platform knows which participant is performing the task or survey. 

https://stag1.mu-iq.com/run-task-survey?pbid=6918543&IDIN={x}

Here {x} is a placeholder and would be replaced with a specific identifier for a user, such as their participant ID. For example, &IDIN=part123 would give this participant the ID 'part123' in the study results.

General Parameter:

The STUDYIN parameter is used to direct participants to a specific study, group, or task version when they access a survey or usability test through a URL. It helps researchers control which version of a study a participant sees and keeps the collected data organized by group.

https://stag1.mu-iq.com/run-task-survey?pbid=6918543&STUDYIN={x}

Here {x} is a placeholder and would be replaced with a real value, such as group name or study condition. For example, &STUDYIN=versionA, &STUDYIN=group1.

Condition Assignment

The CONDITION parameter lets researchers control what version of a survey or test someone sees by adding that info to the URL, so they can compare results across different conditions in a structured way. It is only shown if participants are shown Just One Condition (Assigned At Random).

https://stag1.mu-iq.com/run-task-survey?pbid=6918543&CONDITION={x}

Here {x} is a placeholder and would be replaced with a condition number. For example, if there are 2 conditions and you want to force participants into the second condition then it would be &CONDITION=2.

This parameter is only available if you have conditions enabled in your study.

Multipanel Code

The MP parameter is used by researchers to redirect users to specific URLs upon reaching the max quota, study completion, and screenout. It is only shown when the Panel Redirects are enabled.

https://stag1.mu-iq.com/run-task-survey?pbid=6918543&MP={x}

Here {x} is a placeholder and would be replaced with a study URL shorthand code so that participants can be redirected to specific URLs post-study. For example, &MP=12345.

Custom URL Parameters

Apart from Default Parameters, Researchers also have the option of customizing URL parameters to track specific conditions, groups, versions, or other information that you want to pass through to to results of your study.

https://stag1.mu-iq.com/run-task-survey?pbid=6918543&paramXYZ={x}

Here {x} is a placeholder that will be replaced with a real value depending on what the researcher wants to track or control.