This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
en:survey:panels [21.12.2014 22:15] – [Exit-links back to the provider] admin | en:survey:panels [02.05.2025 08:47] (current) – [Screenout etc.] admin | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Working with External Panel providers | + | ====== Working with External Panel Providers |
If you recruit the participants of your survey through a panel provider, you have to work with IDs, backlinks, exit links and redirects. This section describes how to implement it with SoSci Survey elegantly. | If you recruit the participants of your survey through a panel provider, you have to work with IDs, backlinks, exit links and redirects. This section describes how to implement it with SoSci Survey elegantly. | ||
- | ===== The meaning behind | + | ===== Abstract ===== |
+ | |||
+ | In most cases, it is sufficient to use the following steps. | ||
+ | |||
+ | Below is a more detailed explanation of what the different | ||
+ | |||
+ | **Important: | ||
+ | |||
+ | |||
+ | ==== Share Link ==== | ||
+ | |||
+ | Provide the panel provider with the link to the questionnaire and attach a ''? | ||
+ | |||
+ | If your link to the questionnaire is '' | ||
+ | |||
+ | < | ||
+ | https:// | ||
+ | </ | ||
+ | |||
+ | ==== Add Complete-Redirect ==== | ||
+ | |||
+ | You probably received redirects for 3 or 4 different scenarios from the panel provider: | ||
+ | |||
+ | * Complete -- the participant has completed the questionnaire | ||
+ | * Screenout -- the participant is not suitable for the survey due to characteristics requested in the questionnaire | ||
+ | * QuotaFull -- Sufficient questionnaires are already available for the demographic group(s) of the participant | ||
+ | * Quality -- due to the answers (control questions, bogus items) or the speed of answering you have to assume that the questionnaire was not filled out meaningfully | ||
+ | |||
+ | In the simplest case, use the Complete URL. This could be, for example: | ||
+ | |||
+ | < | ||
+ | https:// | ||
+ | </ | ||
+ | |||
+ | Under **Compose questionnaire**, | ||
+ | |||
+ | <code php> | ||
+ | redirect(' | ||
+ | </ | ||
+ | |||
+ | Note that the wildcard '' | ||
+ | |||
+ | ==== Screenout etc. ==== | ||
+ | |||
+ | You can still place the other redirects elsewhere in the questionnaire if you like. The use of quota stops and screenout is described in chapter [[: | ||
+ | |||
+ | <code php> | ||
+ | if ((value(' | ||
+ | redirect(' | ||
+ | } | ||
+ | </ | ||
+ | |||
+ | The further instructions explain the background of the Complete-Redirect. | ||
+ | |||
+ | ===== The Meaning Behind the Many Links ===== | ||
If the provider of a panel pays a fee to the participants, | If the provider of a panel pays a fee to the participants, | ||
- | It works like this: Each participant | + | * A ParticipationID (TIC)\\ Whenever a provider of a panel sends invitations to a questionnaire he creates an unique individual ID. The provider saves this ID intern and which emailadress got an invitation to which questionnaire. The ID '' |
+ | * A PersonsID (optional, INFO)\\ This identifier is relevant in multi-wave surveys, it clearly identifies the panelist:in to whom the invitation was sent. Thus, the identifier '' | ||
+ | |||
+ | ==== Data in Internet Adresses ==== | ||
+ | |||
+ | The communication between panels and SoSci Survey runs (mostly) via GET parameters in the URLs. More about the [[en: | ||
+ | |||
+ | {{: | ||
+ | |||
+ | At first there is the internet adress (which has different parts by it self). To this can --devided per questionmark-- more data be connected. These data are pairs of a name (key) and a key, where an equal is written between them. Several pairs are devided with an ampersan (''&'' | ||
+ | |||
+ | This means: | ||
+ | |||
+ | ==== Communication between Panel and Questionnaire ==== | ||
+ | |||
+ | The panel provider has to bill if a panelist filled the questionnaire. The questionnaire has to inform the panel provider if the questionnaire is filled. The communication runs via the panelists browser. Spoiler ahead: If the panelist sends the redirect URL (UPL/R) and the participation ID (TIC) to the provider it counts as successful participation an gets billed. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | * (1) After the booking | ||
+ | * (2) These links have to be put at appropriate times in the questionnaire. How to do this is explained in this manual. | ||
+ | * (3) Furthermore you have to tell the panel provider the questionnaires | ||
+ | |||
+ | GET data with the name '' | ||
+ | |||
+ | After a view tests with you and the provider the study can start. Now, hopefully the panel provider serches for successful participants for your study and creates a individual participants | ||
+ | |||
+ | * (4a) In the questionnaire link (URL/F), the panel provider puts a different participation | ||
+ | * (4b) By clicking the internet adress it gets opend at the browser. This means, that the panelist' | ||
+ | |||
+ | Now the interview starts and the panelist dills the sides of the questionnaire. Sooner (Screenout/ | ||
+ | |||
+ | * (5a) The '' | ||
+ | * (5b) The browser gets the request and opens the according adress. In this way the data (TIC) are send back to the panel provider. | ||
+ | |||
+ | The panel provider now registers the call of his redirect upl with the specific TIC. Thereby he knows that the panelist: | ||
+ | |||
+ | What is the additional data (INFO) about? This can be, for example, a personal identifier or demographic data about the panelist. The panel provider possibly sends this data connected | ||
+ | |||
+ | * (6) After the survey all data are available which the panel provider send __and__ you have saved. In any case, check directly after the first tests whether all necessary data (in multi-wave surveys especially a person ID) are available in the data set. | ||
+ | |||
- | ===== Personalized Links to the questionnaire | + | ===== Personalized Links to the Questionnaire |
The easiest way for the panel provider is to submit the identifier as a reference. For this purpose, the variable ‘‘r’’ must be attached to the link of the questionnaire. The address is then ‘’%%ServerURL/ | The easiest way for the panel provider is to submit the identifier as a reference. For this purpose, the variable ‘‘r’’ must be attached to the link of the questionnaire. The address is then ‘’%%ServerURL/ | ||
Line 45: | Line 140: | ||
===== The provider uses a different variable as the " | ===== The provider uses a different variable as the " | ||
- | If the provider can not or doesn’t want to use r in the link or wants to set a variable such as susid, it is also pretty easy to solve. | + | If the provider can not or doesn’t want to use r in the link or wants to set a variable such as susid, it is also pretty easy to solve. |
- | Like a placeholder for the links you have to specify the name of interview variable, of course. | + | {{: |
- | <code php> | + | As a wildcard in the links, one must then of course specify the name of the variable as it is stored in the data set. If the variable for reading in is called |
- | // This code should be on page 1 | + | |
- | $id = readGET('Susid'); // ID Read (on page 1) | + | |
- | set ($id, 'panelID'); // Save in interview variable | + | |
- | // Optionally, you can also put the panel ID in the data record about the case | + | <code php> |
- | // Remain open for the settlement with the panel provider questions. | + | // This code can be found under the question " |
- | put('IV01_01', | + | // or be placed before |
+ | replace('%panelID%', | ||
</ | </ | ||
<code php> | <code php> | ||
- | // PHP code for redirect | + | // PHP code for redirect |
redirect(' | redirect(' | ||
</ | </ | ||
+ | Instead of using '' | ||
+ | |||
+ | <code php> | ||
+ | // PHP-Code für Redirect | ||
+ | redirect(' | ||
+ | </ | ||
+ | |||
+ | |||
+ | ===== Panels and randomized sample ===== | ||
+ | |||
+ | A normal [[: | ||
+ | |||
+ | |||
+ | Here you can see the process described in detail: [[: | ||
+ | |||
+ | |||
+ | ===== Searching for mistakes ===== | ||
+ | |||
+ | If you send the panel provider the questionnaire link (mit Platzhalter für die Panel-ID, look at [[# | ||
+ | |||
+ | If this is not working there are three possible reasons why: | ||
+ | |||
+ | - The panel ID is not correctly transferred to the questionnaire by the panel provider | ||
+ | - The panel ID is not correctly returned to the panel provider in the redirect | ||
+ | - The '' | ||
+ | |||
+ | To narrow down the problem, first search for the test data sets generated by the panel provider under **Collected data** -> **View data**. If you cannot find any suitable cases there, check again whether you have sent the panel provider the links to the correct survey project. | ||
+ | |||
+ | In the data cases, check whether there is a panel ID. This is usually a long number or a cryptic code consisting of numbers and letters. If you are working with '' | ||
+ | |||
+ | * you have either sent the panel provider an incorrect link. | ||
+ | * Or in the **Project settings** under //Special// a different variable name was specified for the reference in //Variables in the link to the questionnaire// | ||
+ | * Or the question " | ||
+ | * Or you have defined several questionnaires in the project (**Compile questionnaire** -> **Manage questionnaires**) and the wrong one is being called up. | ||
+ | |||
+ | If the panel ID is saved in the data record but is not transmitted back, first check your redirect links again and whether the placeholders have been inserted correctly. | ||
+ | |||
+ | **Tip:** To test, you can simply start the questionnaire with a panel ID of your choice. So if the link is '' | ||
+ | |||
+ | |||
+ | ===== Panel-Providers ===== | ||
+ | |||
+ | Below we link to the instructions from panel providers known to us. | ||
+ | |||
+ | * [[https:// |