Differences

This shows you the differences between two versions of the page.

--- en:survey:panels [28.11.2014 13:27] – admin
+++ en:survey:panels [24.05.2021 15:16] – [Personalized Links to the questionnaire] sophia.schauer
@@ Line 7: / Line 7: @@
 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.
-It works like this: Each participant will receive a personalized link. If one of the participant clicks this link, an identifier (ID or subscriber ID) is transmitted to oFb. At the end of the survey the oFb must now inform the provider that the participant has completed the questionnaire. And the identifier is in turn transmitted back to the provider. For this purpose one has to click the Back or Exit link.
+It works like this: Each participant will receive a personalized link. If one of the participant clicks this link, an identifier (ID or subscriber ID) is transmitted to SoSci Survey. At the end of the survey the SoSci Survey must now inform the provider that the participant has completed the questionnaire. And the identifier is in turn transmitted back to the provider. For this purpose one has to click the Back or Exit link to which the participant ID is sent. Also for screenout, a possible quota stop (see [[:en:survey:quota]]) or for participants with doubtful answers there are usually separate links from the panel.
+===== Abstract =====
+In most cases, it is sufficient to use the following steps:
+==== Share Link ====
+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:
+<code>
+https://s2survey.net/project/?r=[panelID]
+</code>
+==== 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:
+<code>
+https://www.panelanbieter.de/complete?xyz=ABCDEF&uid=[panelID]
+</code>
+Under **Compose questionnaire**, insert an additional page before the "last page" in the questionnaire. Place the following PHP code there.
+<code php>
+redirect('https://www.panelanbieter.de/complete?xyz=ABCDEF&uid=%reference%');
+</code>
+Note that the wildcard ''[panelID]'' in the original redirect (this may be different) has been replaced by a [[:en:create:placeholders|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 [[:en:survey:quota]]. A quality check at the end could look like this -- to be placed just above the Complete redirect.
+<code php>
+if ((value('MISSING') > 20) || (caseTime('begin') < 300)) {
+  redirect('https://www.panelanbieter.de/quality?xyz=DEFGHI&uid=%reference%');
+}
+</code>
+The further instructions explain the background of the Complete-Redirect.
 ===== Personalized Links to the questionnaire  =====
@@ Line 41: / Line 91: @@
 **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 are not allowed to save any interview variable named ''reference'' using ''[[:de:create:functions-proc#set|set()]]''.
+**Important:** If you want to use the placeholder ''%reference%'', then you must not prepare a placeholder named ''%reference%'' using ''[[:de:create:functions:replace|replace()]]''.
 ===== The provider uses a different variable as the "r"  =====