Actions

Panel integration

From LimeSurvey Manual

Revision as of 13:36, 28 November 2017 by Cdorin (talk | contribs)


The below examples and explanations are based entirely on our forum users' contributions. Feel free to contribute if you wish to expand our open knowledge about panel integration.


Introduction

You can set up from this tab which URL parameters will be accepted by your survey (these parameters will be attached to the general survey start URL). This option is important if you wish to integrate your survey with a professional survey panel provider that provides you the participants. The latter usually hands over a unique ID of every survey participant and you will need to save/handle these unique IDs for further reference.


  Attention : With some providers, the unique ID of the participant that is dropping out due to a quota limitation or when finishing the survey needs to be sent back to the panel provider in the survey end URL or quota URL.



In order to access your survey's panel integration, go to the survey menu and click on the Panel integration tab.


Survey panel integration

Once accessed, an empty table will be displayed with the option that allows you 'to add an URL parameter.



Two fields will have to be filled out:

  • Parameter: Type in this field the name of the new parameter. It will be included in the URL;
  • Target question: Generally, the URL parameter is saved as a question. It will represent the place where the survey respondents will land on once they click on the link that also includes in its URL the parameter defined above.
You could also save the URL parameter as a response to a short text question or multiple short text question type (you will be able to select any short text question to save it to). However, even if you do not save the value of the URL parameter, you will still be able to use this parameter in the end URL. For further documentation, continue reading the End-URL wiki section.


How to use the panel integration function

A simple example is presented below in which we try to explain how to use the panel integration function

1) First, create a short/long text question and name it what ever you want (we will use "LS"). Then, move it to the beginning of your survey.

2) Go to the panel integration tab, and click on the "Add URL parameter"

[[File:]]

The name you pick for the parameter will have to be included in the entry link that you will later supply to your panel provider. It will be named "LSid" in our example.

Select the short/long text question you created in the first step. The respondents that come from the respective professional panel provider will land on the target question. It can be hidden so that the respondents can directly start completing the survey.

3) Now, you have to set up the entry link that you will send to the your panel provider. To get your link, execute/preview once your survey. Our execute/preview link is:

[[File:]]

Now, edit the URL in such a way that it has the parameter added at the end: survey/language?LSid="xxxxxx". Our link should look like this:

What ever you replace the "xxxxxx" with will be grabbed and stored in the short/long free text question when your respondent lands on that page.

[[File:]]
  {{{1}}}



Examples

http://www.website.com/index.php/SurveyID?lang=en

http://www.website.com/index.php/SurveyID?lang=en&i_survey=TestID, where TestID is taken from the professional survey panel.