Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 10 Next »

Overview

In the interest of reducing respondent fatigue and improving the respondent experience, you may bypass the respondent screener in PureSpectrum by passing in the respondent's qualification/condition codes in the query string parameters.  You must use the PureSpectrum values for these qualification codes and condition codes.

For singlepunch questions like gender, you should pass in a single value e.g. &211=111.  For questions that are multipunch, you may pass in multiple, comma separated values e.g. &1031=111,112.

Respondent Qualification Usage

In the example where you are sending a white(214|111) male(211|111) respondent, 34 years old(212|34) earning 50,000 household income(214|50000), with both a dog and a cat(1031|111,112), your entry link would be:

https://spectrumsurveys.com/startSurvey?supplier_id=[%your_supplier_id%]&survey_id=[%survey_id%]&ps_supplier_respondent_id=[%your_member_id%]&ps_supplier_sid=[%your_session_id%]&211=111&212=34&213=50000&214=111&1031=111,112 

Profiling Info on Children

Profiling Info on Children

If you would like to pass in respondent criteria that pertains to the age and gender of their children, please follow the format &218=112&220_1=111&230_1=120&220_2=2&230_2=12 where 218=112 is a required parameter signifying that the respondent is a parent. 

220 is gender of child, 230 is age of child in months. 

the suffix _1 indicates child 1, _2 indicates child 2, etc.  We accept information for up to 5 children.  Additional items will be ignored, and duplicate items will be ignored as well.

In the above example, the respondent is a parent of 2 children, a boy age 10, and a girl age 1.

Profiling for geography

Profiling for Geography

PureSpectrum supports many different geographical regions for profiling respondents; Nationally Representative, Census Region, Census Division, State, DMA, CBSA, MSA, County and Zip.  In all cases, PureSpectrum uses zip codes to map all respondents to the relevant geographic region.  Therefore, the only survey entry link attribute necessary for geographic qualification is zip code.  

Example

Surveys with the criteria:

"qualification_code": 225,  (state)
"condition_codes": [ "41"]   (Oregon)

Would have an entry like passing a zip code in Oregon:

https://spectrumsurveys.com/startSurvey?supplier_id=[%your_supplier_id%]&survey_id=[%survey_id%]&ps_supplier_respondent_id=[%your_member_id%]&ps_supplier_sid=[%your_session_id%]&229=97110


More information about PureSpectrum Qualification and Condition codes can be found here:

Qualifications and Conditions Codes

Required Variables

VariableSyntaxRequiredDescriptionExample
Supplier IDsupplier_idyThe Supplier's id to PureSpectrum.  The value will be included in the link generated by PureSpectrum.https://spectrumsurveys.com/startSurvey?supplier_id=nnn&survey_id=nnnnn&ps_supplier_respondent_id=[%your_member_id%]&ps_supplier_sid=[%your_session_id%]
Survey IDsurvey_idyThe survey id the respondent is to complete.  The value will be included in the link generated by PureSpectrum.https://spectrumsurveys.com/startSurvey?supplier_id=nnn&survey_id=nnnnn&ps_supplier_respondent_id=[%your_member_id%]&ps_supplier_sid=[%your_session_id%]
Session IDps_supplier_sidyThe unique session id for a given entry.  Should always be unique.https://spectrumsurveys.com/startSurvey?supplier_id=nnn&survey_id=nnnnn&ps_supplier_respondent_id=[%your_member_id%]&ps_supplier_sid=[%your_session_id%]
Respondent IDps_supplier_respondent_idyThe persistent supplier member id.  This should never change for a given respondent.https://spectrumsurveys.com/startSurvey?supplier_id=nnn&survey_id=nnnnn&ps_supplier_respondent_id=[%your_member_id%]&ps_supplier_sid=[%your_session_id%]

Mapping Variables

If the name for these variables differs from PureSpectrum's name, you can map them via the user interface to simplify the integration.

Considerations

Please note that we will ignore qualification codes with condition code=null, and any additional condition codes beyond the first condition code for singlepunch questions.

We may ask these demographic questions at any time to verify the accuracy of the answers passed in.

In the event that any qualification codes are missing, those questions will be asked of the respondent before qualifying them for the survey.

  • No labels