| Note |
|---|
Only available to UI buyers at this time. |
Overview
To provide a better respondent experience, we recommend skipping common demographic questions in your survey. You may specify demographic variables that you would like appended in your survey within the Survey Entry Link.
Use
To append a respondent’s answer to a PureSpectrum qualification, use the following notation when entering your entry link in either the UI or in the Buy API:
“https://mysurvey.com/survey?demographicVariable=[%%ps_qualification_id%%]”
where “https://mysurvey.com/survey” is the link to your survey, “ps_qualification_code” corresponds to the PureSpectrum qualification ID, and “demographicVariable” is a keyname of your choosingPureSpectrum’s “Automatic Variable Mapping” tool is designed with simplicity in mind - helping your team skip the confusion and error that comes with setting up survey links with appropriate transaction variables. While the automatic variable mapping tool works out of the box for most users - some users have special link requirements that are incompatible with the Automatic Variable Mapping tool. For these users, we offer a feature that disables “automatic” variable mapping, and enables “manual” variable mapping.
Use Cases
If your link requires the transaction id as a “path” variable instead of a query string parameter
If your survey is using a link format that is different from your standard link format
If you use multiple survey platforms, and require different link formats for different surveys
Use
| Info |
|---|
To activate this feature - please contact your Client Success representative, or email support@purespectrum.com |
To disable automatic variable mapping - check the box below the “Test URL” that reads “Disable Automatic Variable Mapping”.
After you have disabled the automatic variable mapping - you will need to make sure the “transaction_id” variable is present in your links above.
To insert the value of the respondent’s transaction id into your link, insert [%%ps_transaction_id%%] into your link.
| Info |
|---|
Example https://mysurvey.com/survey?gender=[%%211%%]/[%%ps_transaction_id%%]?variable=123 |
When a respondent is redirected to your survey, their entry link will contain the PureSpectrum condition code or input of their answertransaction_id. This value of the respondents answer respondent’s transaction_id will be inserted where you have specified.
| Info |
|---|
Example https://mysurvey.com/survey/abcd1234?transaction_id=abc123&gender=111Note: We automatically append “transaction_id” to your entry linkvariable=123 |
Important Considerations
While you may call the keyname as you wish (e.g. “gender”, “gen”, “sex”), the value returned in the keyname will always use the PureSpectrum condition code. Please refer to the attributes API Endpoint to determine your qualification and condition codes: Looking Up Attributes
We can always append Gender & Age of a respondent, and can also append any audience criteria that is defined in the survey.
If the survey is screening on ethnicity, then race can be added to the live link using “&race=[%%214%%]
If a qualification is added that is not present in the survey, the entry link for the respondent may contain “null” in the query string parameter, which may break your survey. (e.g. “https://mysurvey.com/survey?transaction_id=abc123&race=null”)
Income and age questions return an integer. If you need to place these respondents into a bucket, like ages 55-64, you will need to account for this in your survey when processing the respondent’s profile.
Common Demographics and their Qualification ID’s
...
Demographic
...
ps_qualification_code
...
Demographic Option
...
PureSpectrum Condition Code For Option
...
Gender
...
211
...
Male
...
111
...
Gender
...
211
...
Female
...
112
...
Age
...
212
...
User Defined Input
...
Returns the user’s age as an integer (e.g. age=27)
...
Household Income
...
213
...
User Defined Input
...
Returns the user’s household income as an integer (e.g. income=55000)
...
zipcode
...
229
...
User Defined Input
...
Returns the user’s zipcode as an integer (e.g. 90403)
The transaction_id is a critical component of the link. You will not be able to launch a study if your survey has “Disable Automatic Variable Mapping” checked, and the Live URL is missing the variable [%%ps_transaction_id%%]
In order to complete the transaction, you will still need to return the respondent back to PureSpectrum using the format: https://spectrumsurveys.com/surveydone?transaction_id=[%%ps_transaction_id%%]&st=[%%st%%] where st is the status code of the respondent.
| Note |
|---|
If you need help looking up qualification status codes and condition codes, please contact PureSpectrum support at support@purespectrum.com |
Additional Examples
Appending gender, age, and income for a respondent that is male, 29, and makes $45,000/year
...
Your entry link defined in PureSpectrum - https://mysurvey.com/survey?gen=[%%211%%]&age=[%%212%%]&income=[%%213%%]
...
your Client Success representative, or email support@purespectrum.com |