Actions

Survey quotas: Difference between revisions

From LimeSurvey Manual

No edit summary
No edit summary
Line 14: Line 14:


  <!--T:31-->
  <!--T:31-->
{{Alert|Quotas are tested only when survey is activated. So, if you set a quota with limit "0"  and the survey is not activated , you will not be able to check whether it is working or not.}}
{{Alert|title=Attention|text=Quotas are tested only when survey is activated. So, if you set a quota with limit "0"  and the survey is not activated , you will not be able to check whether it is working or not.}}




Line 23: Line 23:
=How do quotas work= <!--T:5-->
=How do quotas work= <!--T:5-->


<!--T:6-->
Quotas are not comprehensive and automatically exclusive. To explain, think of a survey that contains only a "Yes or No" question.


<!--T:7-->
<!--T:7-->
You set a quota on this survey that contains a restriction of 20 users who have answered "Yes" to this question. The quota will be checked every time somebody answers "Yes" to that question '''<u>and</u>''' completes the whole survey. If the person answers the quota question but doesn't complete the survey, that answer-id is not going to be counted towards the quota. Once 20 people have filled out all the survey questions, the quota action will be triggered by anyone else choosing "Yes".
Quotas are not automatically exclusive. Think of a survey that contains only a "Yes or No" question. You set a quota on this survey that contains a restriction of 20 users who have answered "Yes" to this question. The quota will be checked every time somebody answers "Yes" to that question '''<u>and</u>''' completes the whole survey. If the person answers the quota question but doesn't complete the survey, that answer-id is not going to be counted towards the quota. Once 20 people have filled out all the survey questions, the quota action will be triggered by anyone else choosing "Yes".


<!--T:8-->
<!--T:8-->
Line 36: Line 33:
To set a limit on the number of "No" responses, you need to add an additional quota, restricting the number of participants who choose "No".
To set a limit on the number of "No" responses, you need to add an additional quota, restricting the number of participants who choose "No".


<div class="simplebox">[[File:help.png]] '''Note:''' If you would like your respondents to be redrected (in accordance to the answer provided to a question) to a certain survey question/to have the survey terminated, use the LimeSurvey [[Expression Manager|expression manager]].</div>
<div class="simplebox">[[File:help.png]] '''Note:''' If you would like your respondents to be redirected (in accordance to the answer provided to a question) to a certain survey question/to have the survey terminated, use the LimeSurvey [[Expression Manager|expression manager]].</div>


==Example of a quota== <!--T:12-->
==Example of a quota== <!--T:12-->
Line 43: Line 40:
You might have to conduct a survey where you want to limit it to 25 male and 30 female respondents. You could then define a quota with a limit of 25 for the answer "Male" from your gender question in the survey.  Another quota for the answer "Female" with a limit of 30 could be added as well.  This will give you a maximum of 25 males who will be able to complete the survey, and a maximum of 30 females who can complete the survey.
You might have to conduct a survey where you want to limit it to 25 male and 30 female respondents. You could then define a quota with a limit of 25 for the answer "Male" from your gender question in the survey.  Another quota for the answer "Female" with a limit of 30 could be added as well.  This will give you a maximum of 25 males who will be able to complete the survey, and a maximum of 30 females who can complete the survey.


<!--T:14-->
A survey participant has to match all answers under the quota for it to apply to that response.


=Supported question types= <!--T:10-->
=Supported question types= <!--T:10-->


<!--T:11-->
<!--T:11-->
Currently only the following question types can have a quota defined for it:
The quota system can be applied only to the following types of questions at the moment:
*Gender
*'''Gender'''
*Multiple Choice
*'''Multiple Choice'''
*Array - 5 Point Choice
*'''Array - 5 Point Choice'''
*Array - 10 Point Choice
*'''Array - 10 Point Choice'''
*Language Switch
*'''Language Switch'''
*Yes/No
*'''Yes/No'''
*List (Radio)
*'''List (Radio)'''
*List (Dropdown)
*'''List (Dropdown)'''
*List with comments
*'''List with comments'''
 
=Survey quotas panel=
 


=Adding a new Quota= <!--T:15-->
==Add new quota==


<!--T:16-->
!--T:16-->
Adding a new quota is really adding a framework for set of quota conditions. For a fully working quota you must firstly "Add a quota", and then "Add Answers" to that quota (see next section).
Adding a new quota is really adding a framework for set of quota conditions. For a fully working quota you must firstly "Add a quota", and then "Add Answers" to that quota (see next section).


Line 86: Line 84:
Once a quota is added, you will be able to add answers under the quota.
Once a quota is added, you will be able to add answers under the quota.


=Adding an answer= <!--T:21-->
===Add an answer===
 
*'''Select Question:'''
*'''Select Question:'''


Line 96: Line 95:
+Once selecting your question, you will be show a list of answers under that question. Here you will select an answer you would like to add to you quota, then press "Next".
+Once selecting your question, you will be show a list of answers under that question. Here you will select an answer you would like to add to you quota, then press "Next".


=Adding multiple quotas for the same question & subquestion= <!--T:24-->
 
 
 
==Adding multiple quotas for the same question & subquestion== <!--T:24-->


<!--T:25-->
<!--T:25-->
Line 103: Line 105:
<!--T:26-->
<!--T:26-->
This means also that multiple quotas for the same '''subquestion''' or the same single choice question can never come true.
This means also that multiple quotas for the same '''subquestion''' or the same single choice question can never come true.
==Edit quota==
==Delete quota==
=Export quotas=
=Import quotas=


=Quota and response data= <!--T:27-->
=Quota and response data= <!--T:27-->
Line 114: Line 124:
When tokens are used in a survey and the user is screened out due to a quota, then the according token entry is marked with the letter "Q" in the Completed column. That way the token is invalidated and the survey participant can't re-start the survey.
When tokens are used in a survey and the user is screened out due to a quota, then the according token entry is marked with the letter "Q" in the Completed column. That way the token is invalidated and the survey participant can't re-start the survey.
</translate>
</translate>
=Example=

Revision as of 17:53, 9 November 2017

General explanation

A quota is used to set a limit on responses from defined groups of people on an active survey. Some common attributes used in defining quotas are things like gender, age, race, province/state. To access the survey quotas panel, access the survey menu and select the Survey quotas tab:



  Attention : Quotas are tested only when survey is activated. So, if you set a quota with limit "0" and the survey is not activated , you will not be able to check whether it is working or not.



A survey example that can help you demonstrate the usage of quotas is available for download from the following link: LimeSurvey_sample_survey_Quotas.lss. If you do not know about the LimeSurvey import function, read the following wiki section first: import a survey in LimeSurvey.


How do quotas work

Quotas are not automatically exclusive. Think of a survey that contains only a "Yes or No" question. You set a quota on this survey that contains a restriction of 20 users who have answered "Yes" to this question. The quota will be checked every time somebody answers "Yes" to that question and completes the whole survey. If the person answers the quota question but doesn't complete the survey, that answer-id is not going to be counted towards the quota. Once 20 people have filled out all the survey questions, the quota action will be triggered by anyone else choosing "Yes".

If "No" is chosen, the quota system is never triggered. Therefore, the survey won't restrict anyone from responding the certain questions, unless otherwise specified.

To set a limit on the number of "No" responses, you need to add an additional quota, restricting the number of participants who choose "No".

Note: If you would like your respondents to be redirected (in accordance to the answer provided to a question) to a certain survey question/to have the survey terminated, use the LimeSurvey expression manager.

Example of a quota

You might have to conduct a survey where you want to limit it to 25 male and 30 female respondents. You could then define a quota with a limit of 25 for the answer "Male" from your gender question in the survey.  Another quota for the answer "Female" with a limit of 30 could be added as well.  This will give you a maximum of 25 males who will be able to complete the survey, and a maximum of 30 females who can complete the survey.


Supported question types

The quota system can be applied only to the following types of questions at the moment:

  • Gender
  • Multiple Choice
  • Array - 5 Point Choice
  • Array - 10 Point Choice
  • Language Switch
  • Yes/No
  • List (Radio)
  • List (Dropdown)
  • List with comments

Survey quotas panel

Add new quota

!--T:16--> Adding a new quota is really adding a framework for set of quota conditions. For a fully working quota you must firstly "Add a quota", and then "Add Answers" to that quota (see next section).

When adding a quota, you will be asked for a "Quota Name", the "Quota Limit", and a "Quota Action".

From version 1.85RC you will also have the option of setting your own unique quota "Quota Message", "url" and "URL Description" for each language used in your survey. You can also set "Autoload URL" so that the survey redirects users to the quota URL when the quota action is triggered.

All new quotas are assigned to the Survey you were viewing when you clicked "Set Survey Quotas".

  • Quota Name: This is a name to reference the quota by, generally it should describe the quota it will represent.
  • Quota Limit: This is maximum number of completed surveys to allow for the quota. This sets a limit that will be check when quota selected questions are answered during the survey.
  • Quota Action: This is an action to perform when a participant is filling out a survey and lands up being part of a quota that has become full.
    • Terminate Survey: This immediately terminates the survey, and closes the interview.
    • Terminate Survey With Warning: This warns the participant and allows them to go back
  • Autoload URL: This tells LimeSurvey to automatically redirect the participant to the URL when the quota action occurs.
  • Quota Message: The text displayed to your survey participant if the quota action is triggered (ie: the quota is full).
  • URL: The URL displayed to survey participants after the quota message, or the URL participants are automatically redirected to if 'Autoload URL' is turned on. You can use URL fields in this section.
  • URL Description: The text displayed for the URL. (Only in Version 1.85RC)

Once a quota is added, you will be able to add answers under the quota.

Add an answer

  • Select Question:

+When adding a answer under the quota, you will be shown a list of all available quota questions which are in your survey. If a question does not show up on the list, then its not yet supported with quotas. After you have chosen the question you want, press "Next" to move on to answer selection.

  • Select Answer:

+Once selecting your question, you will be show a list of answers under that question. Here you will select an answer you would like to add to you quota, then press "Next".



Adding multiple quotas for the same question & subquestion

Adding multiple quotas for the same question is surely possible - but  know that quotas are checked with a logical 'AND' operator - so to meet the quota the user has to answer both subquestion in that question like in your quota.

This means also that multiple quotas for the same subquestion or the same single choice question can never come true.

Edit quota

Delete quota

Export quotas

Import quotas

Quota and response data

All data is saved when the participant clicks the "Next" button. Even if the quota is full, the data submitted until the survey is terminated will be recorded. Nevertheless, such id is marked as "No Completed".

Quota and tokens

When tokens are used in a survey and the user is screened out due to a quota, then the according token entry is marked with the letter "Q" in the Completed column. That way the token is invalidated and the survey participant can't re-start the survey.


Example