Redirect URLs

Overview

Once having completed a survey, the respondents must be registered with PureSpectrum via a callback URL.

When returning the respondent back to PureSpectrum, the redirect URL should contain the transaction_id & appropriate status st query parameters.

Format:

Staging:
https://staging.spectrumsurveys.com/surveydone?st={STATUS_CODE}&transaction_id={TRANSACTION_ID}

Production:
https://spectrumsurveys.com/surveydone?st={STATUS_CODE}&transaction_id={TRANSACTION_ID}

Definitions

transaction_id is the unique, per session transaction ID. A respondent can have multiple transactions, i.e. attempting to take the survey from different devices or at different times. This will be appended as a query parameter to the client's survey entry URL, when sending the respondent to the survey.

For example http://yoursurvey.com/survey1 will become http://yoursurvey.com/survey1?transaction_id=123456.

st is the status code for Complete, Term, Overquota, or other redirects, defined by the buyer's survey.

Map transaction ID (UI only)

If you need to receive transaction_id in a different form, you can map this variable to yours in the menu option for “Buyer Settings” under your buyer account.

If you run multiple surveys on different platforms, you may check the boxes for additional transaction variables, just ensure that the presence of unknown variables is compatible with all active systems.

Status Codes to be Used in the Redirect URL

Type	Status code (st)	Description
Complete	21	Respondent completed the survey and registered as Complete
Over quota	17	Number of required respondents has already been reached for that quota
Termination	18	Respondent is not qualified for the survey
Quality	20	Quality concern, e.g. Speeding, straight-lining, trap questions
Buyer Security	30	Duplicate, respondent has already taken survey
Buyer Hash Security	31	Respondent has tampered with the Buyer’s URL

Examples

Status	Redirect URL
Completes	https://spectrumsurveys.com/surveydone?st=21&transaction_id={TRANSACTION_ID}
Over Quota	https://spectrumsurveys.com/surveydone?st=17&transaction_id={TRANSACTION_ID}
Termination	https://spectrumsurveys.com/surveydone?st=18&transaction_id={TRANSACTION_ID}
Quality	https://spectrumsurveys.com/surveydone?st=20&transaction_id={TRANSACTION_ID}
Dedupe	https://spectrumsurveys.com/surveydone?st=30&transaction_id={TRANSACTION_ID}

Qualtrics Example

Status	Redirect URL
Completes	https://spectrumsurveys.com/surveydone?st=21&transaction_id=${e://Field/transaction_id}
Over Quota	https://spectrumsurveys.com/surveydone?st=17&transaction_id=${e://Field/transaction_id}
Termination	https://spectrumsurveys.com/surveydone?st=18&transaction_id=${e://Field/transaction_id}
Quality	https://spectrumsurveys.com/surveydone?st=20&transaction_id=${e://Field/transaction_id}
Dedupe	https://spectrumsurveys.com/surveydone?st=30&transaction_id=${e://Field/transaction_id}

More information on Redirects can be found on the Finalize and Launch page.

Overview#

Definitions#

Status Codes to be Used in the Redirect URL#

Examples#

Qualtrics Example#

Overview

Definitions

Status Codes to be Used in the Redirect URL

Examples

Qualtrics Example