This translation is older than the original page and might be outdated. See what has changed.
Translations of this page:
 

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.

Abstract

In most cases, it is sufficient to use the following steps.

Below is a more detailed explanation of what the different links are all about.

Important: These steps are not sufficient in multi-choice surveys, where a personal identifier must also be stored.

Provide the panel provider with the link to the questionnaire and attach a ?r=[panelID].

If your link to the questionnaire is https://s2survey.net/project/, tell the panel provider that the link to the questionnaire is as follows:

https://s2survey.net/project/?r=[panelID]

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://www.panelanbieter.de/complete?xyz=ABCDEF&uid=[panelID]

Under Compose questionnaire, insert an additional page before the “last page” in the questionnaire. Place the following PHP code there.

redirect('https://www.panelanbieter.de/complete?xyz=ABCDEF&uid=%reference%');

Note that the wildcard [panelID] in the original redirect (this may be different) has been replaced by a SoSci placeholder %reference%.

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 Quota. A quality check at the end could look like this – to be placed just above the Complete redirect.

if ((value('MISSING') > 20) || (caseTime('begin') < 300)) {
  redirect('https://www.panelanbieter.de/quality?xyz=DEFGHI&uid=%reference%');
}

The further instructions explain the background of the Complete-Redirect.

If the provider of a panel pays a fee to the participants, he would like to know who has the questionnaire at all completed course. To this end, he must “follow” the individual 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 12345xyz could name the participant 12345 who got the invitation to the questionnaire xyz.
  • 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 GHIJ765 could denote the panelist:in 12345 in your survey. For privacy reasons, the same individuals in different studies may be assigned different personal identifiers.

Data in Internet Adresses

The communication between panels and SoSci Survey runs (mostly) via GET parameters in the URLs. More about the URL to the Questionnaire and redirect links soon. First of all, it is essential that an Internet address can have several components:

Parts of URL

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 (&). In the example above the pairs tic=ABCDEF9876 and pid=GHIJ765 are send to the adress https://www.soscisurvey.de/project/.

This means: If a person opens this URL in a browser, two values as send to the questionnaire www.soscisurvey.de/project. But at first these values are not saved in the dataset.

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.

Communication between panel and Questionnaire

  • (1) After the booking of a sample by a panel provider you get normally a redirect link. Actually not only one, but different ones for successful participation (complete), for unsuitable participants (screenout/quotafull) and for sloppy participants (quality/qualityfail).
  • (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 link. You must also agree with the panel provider what names the parameters for the subscriber ID (TIC) and for any other data should have. If you take the name r for participation IDs you save work (see above). In the example the name tic was used. Usually, you immediately inform the panel provider of an Internet address that contains your questionnaire URL (URL to the Questionnaire) and a wildcard for the TIC (see above).

GET data with the name r are automatically saved as reference in the dataset (The Link to the questionnaire). To save data with another name you need a question of the type Device and transmitted variables.

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 ID (TIC).

  • (4a) In the questionnaire link (URL/F), the panel provider puts a different participation ID (TIC) for each panelist:in. The provider sends this link to the participant or offers it in his website. How the panelist:in gets the link is ireelevant – important is that the panelist:in clicks on the link.
  • (4b) By clicking the internet adress it gets opend at the browser. This means, that the panelist's browser sends the data that are in the link to the adress of the link. The address belongs to your questionnaire, so the data (TIC and INFO, if applicable) will be sent to your questionnaire. There the data have to be collected and saved.

Now the interview starts and the panelist dills the sides of the questionnaire. Sooner (Screenout/Quotenstop) or later he gets to the page with the redirect().

  • (5a) The redirect() function sends the panelist:in's browser a request to call a new URL, namely the redirect URL (URL-R) along with the subscriber ID (TIC). You build this Internet address based on the information from the panel (URL-R) and the previously received subscriber ID (TIC).
  • (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:in has filled in the questionnaire. Or he knows that the panelist is dismissed depending on the called redirect link.

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 to the TIC and you have to make sure that the data are saved in the dataset.

  • (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.

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/project/?r=Identifier’’, e.g. ‘’https://www.soscisurvey.de/demo/?r=Identifier’’.

The provider will exchang the identifier for each participant.

Note: If you do not want to call the standard questionnaire in the link, use the link only once the question mark (‘’?’’) and for other variables, the ampersand (‘’&’’), e.g. ‘’https://www.soscisurvey.de/demo/?q=fb2&r=Identifier’’. To create the links see also The link to the questionnaire.

Note: If the provider wants to use a different variable necessarily instead of the variable ‘’r’’, then you only need two more lines of PHP code, which is below.

In order to inform the participant identifier to the provider end of the survey, the participant is simply redirected to a website of the provider. Once again, the identifier is transmitted.

Vom Anbieter erhält man üblicherweise einen Exit-Link der etwa so aussieht:
http://www.provider.com/p9815245/exit.php?id=Code Instead of the code you must now use the reference that you got in the beginning with each respondent. This can be done simply with the placeholder ‘’reference’’:
http://www.anbieter.com/p9815245/exit.php?id=%reference%

Now you have to only redirect the respondents - the so-called Redirect. You can use the function redirect(). However, this breaks the survey immediately and directs the participants to another page. So you have to insert a blank page itself before the end of the questionnaire, and paste thePHP-Code/ and then the redirect()command:

redirect('http://www.anbieter.com/p9815245/exit.php?id=%reference%');

You should put nothing else on this page.

If one invokes the questionnaire with a test identifier and the link above (which you simply invent yourself), then you should be redirected at the end of the survey to the page of the provider and in the address line of the browser you should see the test-identifier. Probably you will get an error message from the provider, because the identifier is not valid.

Hint: With the redirect() function participants can be also send away when the contigent is met. Whether the contigent has been met, you can, for example, check this by using the statistic() function.

Important: If a participant leaves the questionnaire with redirect() then the questionnaire is marked as incompleted in the data record. To filter incomplete data records, you have to go back to the last completed page (LAST PAGE).

Important: If you want to use the placeholder %reference%, then you must not prepare a placeholder named %reference% using replace().

The provider uses a different variable as the "r"

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. The variable for this is read in on the first (!) page in the questionnaire with a question of the type Device and transmitted variables. Enter the name of the variable containing the panel identifier (e.g. “userID”).

Question of type: Device and transmitted variables

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 DV01_RV1, for example, one would set the wildcard as follows:

// This code can be found under the question "Device and transmitted variables".
// or be placed before the forwarding
replace('%panelID%', 'DV01_RV1', 'response');  // Prepare wildcard
// PHP code for redirect
redirect('http://www.anbieter.com/p9815245/exit.php?id=%panelID%');
en/survey/panels.txt · Last modified: 19.07.2021 17:11 by sophia.schauer
 
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
Driven by DokuWiki