Page Comparison

...

...

The “external survey start” of EFS allows to send survey participants from one project to a second project and to redirect them upon completion. This can be necessary in the following situations, for example:

• You want your panelists to take part in a project that was created by somebody else on another EFSinstallation or using external software. However, for the incentive management in your panel you would like to record which panelists have completed the survey.

• You want to conduct a conjoint survey using external survey software, the frame survey is to be created with EFS, though.

Topics

...

Technical Background

The external survey start is based on the use of GET parameters. GET parameters are variable values that are transferred to a page via the URL. This is a well-established standard web technology. It has already been used in EFS for a long time, e.g. for the transfer of external data to a survey via URL parameters (see the manual “EFS Survey 8.1”, Chapter 3.7.13).

Constructing URLs with GET Parameters

...

Creating the Questionnaires and Configuring Forward and Return Jumps

...

• Create the primary and secondary projects. The primary project can be of the “anonymous” or the “personalized” type, for the sake of simplicity the secondary project should be “anonymous”.

• Create the first part of the primary questionnaire.

• Next up is the page that redirects the participants to the secondary survey. Create this page, selecting “External survey start” as the page type.

  • Click on + Dynamics and select External Survey Start to create the External Survey Start page.

...

• The new page is displayed in the questionnaire view. Click on the Edit page properties iconlink.

• You are automatically taken to the Page properties tab.

• In the “Destination URL of external survey” field, enter the URL of the secondary project. You will find this in the field labeled “URL” in the project information of the secondary project.

...

• The other options are configured appropriately for this example by default: “Add ticket” is activated, “Add ticket for target EFS project < 5.2” “Use long clear-text tickets” is deactivated.

• Confirm by clicking on ChangeSave.

• Create the questionnaire for the secondary project.

• The final page of the secondary project serves as the jump page to return to the primary survey. This means that instead of filling this page with contents as usual, you click again on the Edit page properties icon the page link to open the Page properties tabProperties (left hand side).

• Enter the URL of the primary project as the destination URL. This you will find in the project information of the primary project, as explained above.

• The other options are configured appropriately by default: the checkboxes “Automatically add ospe.php3” and “Add return ticket” are ticked.

...

• Confirm by clicking on ChangeSave.

• Create the second part of the primary project that the participants will complete after the return.

...

• The configuration of the questionnaires is now complete.

Testing

When testing, some aspects require special consideration:

...

The browser address bar will tell you whether the jump occurs in the desired place. The figure below shows the URL of a questionnaire page in the primary project right before the jump to the secondary project. There you will notice the folder “d19a” “3a6f” of the sample project.

...

After the jump, the folder “54a5” “38d1” of the secondary project will appear in the same place.

...

After the return jump the participant is taken back to the primary project with the folder “d19a”“3a6f”. In the URL you will also recognize the automatically or manually inserted attachment ospe.php3 and the GET parameter return_tic which is used to identify the participant and to direct him to the correct page.

...

Checking the statistics and the export data record

The statistics and the export data record of both primary and secondary project should be showing you the values from your test run. The consecutive number of the respondents (“lfdn”) is automatically transferred to the secondary project via “tic”. You should be able to locate the “lfdn” of a data record in the primary project in the column labeled “external_lfdn” of the secondary project’s matching data record.

...

• Parameter “tic” is transferred at the jump from the primary to the secondary survey, “return_tic” is transferred at the return jump to the primary project.

• The parameters ensure that the participants can be identified at the return jump and that they resume the primary project at the correct location.

• It the jump connects two EFS projects, the tickets ensure that you can match the data records. For this purpose, the consecutive number of the respondents in the primary project is transferred automatically into the variable “external_lfdn” of the secondary project.

• If you are using external software and wish to match the data records later, Instead, you have to transfer “tic”, “lfdn” or another value that might serve to identify the participants via GET parameter. Please see Chapter 4.3.1, p. 19 for detailed instructions.

EFS allows to customize the external survey start according to special requirements:

...

• Import the participants into the secondary project or create the accounts manually. The participants’ codes are usually generated by the system. (Alternatively, the codes can also be generated in Excel and imported along with the participants.)

• Next, the codes of the secondary project have to be extracted and imported into the primary project. Click on the Excel export or CSV export button to export the list of participants including the codes. The list of participants can be used as it is as an import file for the primary project.

• Proceed to import the participant data and codes into the primary project. From EFS 6.0, the codes can be imported directly: they are stored in the “code” database field.

• Assign the “code” column to the appropriate database field when importing into the primary project.

• The desired participant data including access code are now available in the primary project as well. Next, the jump page has to be configured so as to allow for the automatic authentication by transfer of the code. Switch to the questionnaire of the primary project. Locate the jump page and, select the Edit page properties icon.

• Extend the URL so that the value of the variable #code# of the primary project is transferred to the “code” field of the secondary survey: http://www.efs-survey.de/xyz/?code=#code#

• Confirm by clicking on ChangeSave.

• The return page in the secondary project is configured as usual.

...

Authentication When Jumping From a Panel Survey to a Personalized Project

Since EFS 6.0, panel surveys can be used as target projects. I.e., you can route partici- pants from one panel survey to another, as long as both surveys are placed on the same installation. This option is used quite frequently, in particular in situations when the content of a survey has to be spread over several projects.

There are two possible settings:

• Only selected panelists can participate

• All panelists can participate

Only selected panelists can participate

If you want only selected panelists to participate in the two connected projects, please proceed as follows:

• 􏰀  Make sure the participating panelists are members of the samples of both projects.

• 􏰀  The link for the jump from primary to secondary project should look as follows: http://www.your-domain.com/xyz/ ?syid=573&sid=574&pcode=#panelist_code#&pses=#panel_ses#

This contains:

• syid: Project ID

• sid: Sample ID of the appropriate sample in the secondary project. You can find this ID by scrolling over the title in the overview of samples with the mouse pointer while observing the link in the status bar of your browser. It looks like this:

  http://www.your-domain.com/ front.php?module=panel_sampling&act=view_sample&pid=610&sid=611

• pcode: Panelist code.

• pses: Session ID of the panelists. If you can trust that the panelists have cookies activated, you can drop the session ID. But if you want to allow the jump with cookies switched off, the session ID must be transferred.

All panelists can participate

If you want all panelists to participate in both projects or at least in the secondary project, please proceed as follows:

• Activate the option “All panelists can participate in the survey (independent from being in a sample for the survey)” in the Project properties menu of both projects resp. only in the secondary project.

• The link for the jump from primary to secondary project should look as follows: http://www.your-domain.com/xyz/

  ?syid=573&sid=574&pcode=#panelist_code#&pses=#panel_ses#

This contains:

• syid: Project ID

• 􏰀sid: Sample ID of the “internal” sample of the secondary project.

• pcode: Panelist code.

• pses: Session ID of the panelists. If you can trust that the panelists have cookies activated, you can drop the session ID. But if you want to allow the jump with cookies switched off, the session ID must be transferred.

Transferring Data from the Primary to the secondary Project and storing these Data in URL Parameter

The return jump from the secondary to the primary project is a very different situation than the forward jump: The participant is not taken to the start page of a new project but resumes an already started project. Therefore, unlike in the case of the forward jump, the data transfer cannot be done using URL parameters: These can only be processed on the first page of a project. Instead, the data are transferred to user-defined variables (c variables).

The following steps are required:

• In the Project properties menu of the primary project you create the required user- defined variables. When doing so make sure that the file type matches the values to be transferred.

• After that, you enter the destination URL for the return jump in the secondary project. It looks as follows: http://www.efs-survey.de/xyz/ospe.php3

• To this URL you have to add

  • the appropriate user-defined variable of the primary project. In our example, this is “c_0001".

  • the value of the variable. This can be a constant value or also a participant- specific value dynamically inserted via wildcard. In our example, this is the participant variable “u_group”.

• The destination URL would then be, for example: http://www.efs-survey.de/xyz/ospe.php3?c_0001=#u_group#

Besides project folder and “return_tic”, the example URL contains a GET parameter “c_0001” with the value “11”.

Linking More Than Two Projects

It is possible to link more than two projects via external survey start. The following combinations are possible, for example:

• 1. project → 2. project → 3. project → 2. project → 1. project

• 1. project → 2. project → 1. project → 3. project → 1. project.

Please note that the participants always have to be redirected back along the same path they came. This is necessary as the “tic” parameters can only be used to transfer those data regarding session, jump page etc. of the previous project that are available in the current project.

• The path 1. project->2. project->3. project->2. project->1. project is possible.

• The path 1. project->2. project->3. project->1. project->2. project is not possible.

When redirecting from the second to a third project the options “Add return ticket” and “Add ospe.php3” have to be disabled. They are used for returning primary-project relevant information back to the primary project. They cannot be used to relay secondary-project relevant information to another project.

When analysing the data, please mind that the variable “external_lfdn” contains the “lfdn” of the primary project in all following projects.

Special Considerations when using External Software

You can rename the GET parameters “tic” and “return_tic” if this is required for redirecting to a survey that was created using external software.

External Software requires

The relevant function can be found both in the Edit page properties dialog (Figure 3.7) and in the Projects → {Selected project} → Project properties menu, “General options” section, in the following fields:

• Name of ticket variable (external start of survey)

• Name of ticket variable (when returning from an external survey)

External Software

It may happen sometimes that you wish to transfer a number of values while the external software is able to evaluate only one GET parameter. In such situations, please check whether there is another option for transferring the desired values.

Sawtooth, for example, can accept only one parameter, however, this may contain several values that are separated by comma. In this case it is possible to transfer both the “tic” parameter and other values as a comma-separated string.

Suppose you want to transfer the following values:

1, x, #tic

In the EFS primary survey you combine those in a value of the variable “a” as follows:

a=1,x,#tic#

Via the wildcard, “tic” is inserted at a precisely defined position in the URL: Sawtooth is now able to accept the resulting string and break it down by means of an analysis algorithm. This way, the value for “tic” can be extracted, stored, and subsequently transferred back.