Skip to main content

Kinesis Support

All the topics, resources needed for Kinesis.

FocusVision Knowledge Base

Create/Change Project (Panel)

A panel project allows the user to launch a survey to a specific panel sample. This page will guide you through the process of creating and launching a panel project.

1:  Create New Project

Working in project mode requires at least one project to be created. To create a new project, first access the Project Selection page by clicking one of the two menu items highlighted in red:

Existing projects will be listed on the Project Selection page. Click ADD NEW PROJECT to begin.

2:  Edit Properties

2.1:  General Settings

This is where project details are defined, such as which survey this project is associated with and default maximum participation. Projects do not have to be associated with surveys, so survey-related details can be ignored on this screen if this project is for a newsletter or some other email- or SMS-only communication.

Name

The name of the project (for internal-use only; will not be displayed to panelists).

Description

Optional description of the project (for internal-use only; will not be displayed to panelists).

Link to survey

To launch to a survey programmed within Kinesis Survey, select the survey from within this pulldown menu. To launch to a survey programmed in another survey platform, select "None" in this pulldown and click the Survey Settings tab to configure the survey URLs as needed.

Default reward points

Reward points granted for each of the available completion statuses (Completed, Profile, Quota). Set these to 0 if your survey project will not utilize points. The points are only rewarded if you are using Kinesis Panel or its API for updating panelist activity, and the exit pages are defined properly in your survey, as described in the project's survey settings tab on this page.

Default maximum participation

This will set the maximum number of times a panelist can participate in this project. Typically you would want one panelist to complete a project exactly one time. However, certain profilers and other types of studies may require alternate values. For an unlimited number of times, set the number to 0. Panelists can resume projects until they become closed or until their status has been recorded as completed, profile termination, or quota terminated. Note that what is defined here is the default for the campaigns, not the actual maximum participation limit itself.

2.2:  General Settings - Fulcrum enabled project

When creating a new project, or if you already have an existing project, select My Project -> Edit properties to see the Project Properties page. First select “Yes” to enable Fulcrum integration and to show options below.

Typically you would click on the “Select survey from list” button to open up a list of available projects in Fulcrum. If you would like handle the entire sampling process manually, start by entering the Fulcrum survey number. The system will now allow you to obtain sample manually. Click on the green “Check” button and Kinesis Panel will verify that the entered Fulcrum survey number exists. If it does not exist, the field will turn red.

2.3:  Other Settings

Project close grace peroid
Use this property to choose the amount of time between when a project completes, and when someone who has already started the survey can finish it. The grace period has no effect upon those attempting to start the survey, only those who are currently taking it. Once marked completed, no one is allowed to start, or come back in to finish after dropping out. If you select no grace period, then someone taking the survey at the time you close it will not be awarded points upon completion. If, however, you set some about of time, like 10 minutes, or 2 hours, then those already taking the survey may have time to finish it. The default grace period for projects is 2 hours.
IMPORTANT: The amount of time you choose is relative to when you close the project, NOT to when the panelist started.
Maximum desired completes
The total number of completes in this project (including all campaigns) that are needed before automatically marking the project as completed. Leave blank for no limit. When a project is automatically marked as complete, the project manager and anybody in the email list will be notified.
Project manager
The user who is responsible for this project (must be admin or project manager).
Email list
A comma separated list of contacts to notify in case the project is marked completed automatically.
Client
This selection is optional and simply indicates the client this project is associated with. You can add new clients by clicking the add button. If a new client is added, it will become the client that is selected in the drop down menu of clients. You can search by using client name in various system functions.
Force language?
When set to Yes and the project is integrated into a Kinesis Survey project, the force language setting will force panelist to complete the survey in their chosen panel language. When force language is set to No, the panelist will be able to select from any available language (if more than one is available) in the survey project.

2.4:  Survey Settings

This tab is used to configure a survey URL when launching to a project built in a survey application other than Kinesis Survey.

Survey URL

The Survey URL is where respondents should be sent to take the survey, and with what parameters. "sesskey" is a unique key generated by Kinesis Panel to track each respondent's survey status, and is the only required parameter that must be sent to and from the survey, although a traditional survey typically mandates sending both a unique identifier (so survey data can be matched with specific respondents) and the sesskey. All system fields and datapoints in your panel can be piped into this URL (identifier, email, gender, etc.).

Exit Properties

This section contains the exit links you need to implement within your survey, and clarifies the destinations where respondents should be sent upon achieving one of the 3 possible completion statuses (Complete, Profile-terminate, Quota-terminate).

Survey Exit Hash Algorithm

Choose between MD5 and SHA-1 hash algorithms to use. When in use, the hash value will be automatically appended at the end of the external link. The hash verification can be used by the third party system to validate that the link has not been tampered with by the panelist. The hash algorithm uses the section of the URL after the question mark and appends Secret Hash Salt as specified in the project's general properties and takes either MD5 and SHA-1 of the resulting string:

http://web4.kinesissurvey.com/sv500/html.pro?id=SURVEYID&pcid=ks&identifier=[IDENTIFIER]&sesskey=[sesskey]

If the Secret Hash Salt is G00d^PassWD and you selected MD5, a function call in PHP would look like the following:

md5("id=SURVEYID&pcid=ks&identifier=XXXX&sesskey=XXXX"."G00d^PassWD");

Secret Hash Salt

The hash salt is used in conjunction with the hash verified survey and reporting URLs (please see the other tabs). The hash salt is added to the algorithm to make it tamper-proof for external parties. Setting a good salt with at least 12 characters is recommended if you use MD5 or SHA-1 secured URLs.

2.5:  Category Assignment

Select Categories
You can mark each project to belong to certain categories for later reference. Typically, the category selection is used to filter panelists based on their participation in similar studies i.e. Consumer goods -> Baby products. For example, you may not want to invite the same panelists to participate in multiple studies in the same category too frequently. In order to use the category selection you need to create categories and sub categories first. This is done in the Category Manager. You may return to each of your projects at a later time to make adjustments.

3:  Create Sample

A sample is a subset of panelists created for the purpose of targeting email or SMS communication (survey invitations or otherwise). A new sample can be created using either of the following methods:

Query for sample

Queries are the starting point for pulling sample based on specific criteria. Think of them as target demographics or target definitions for a subset of panelists. Because queries are definitions, their counts are dynamic and can fluctuate over time as panelists join or leave the panel. The query system is highly flexible and allows you to include or exclude individuals based upon any stored database variable.

Import sample

This feature is used for importing a list of panelists generated from an external source.

For more information on creating sample for your projects, please see Sample Manager.

4:  Invite Sample to the Project

Invitations are sent and managed by setting up "campaigns" in project mode. A campaign is the entire scheduling history for an individual sample for a particular project. A campaign includes the initial invitation and subsequent reminders sent to panelists. A sample must be created before you can send out invitations.

For more information on how to invite a sample to a project, please see our section on Inviting Sample to a Project.

  • Was this article helpful?