On respondent redirect, PureSpectrum will append a url variable called ps_rstatus. This is in addition to your standard redirects for completion, term, etc.
ps_rstatus gives you a descriptive indication of why the respondent was redirected as a term (and can serve as a backup in case of url tampering by the respondent).
For example, if the ps_rstatus=23, the survey is paused. You should pause the survey on your end immediately to prevent clickwaste. As you call the Get surveys method, you will find out if the survey has been reset to live or set to closed.
Another example, ps_rstatus=13 indicates an issue with your targeting. You should call the surveys api again and check the "last_modified" date. If the last_modified has change since you last pulled the survey, there is a strong chance that a qualification has changed.
The following statuses indicate an issue with your targeting, suggesting the need to refresh your current quotas: 12, 13, 22, 23, 24, 25, 34, 35
The following statuses indicate an issue with survey grouping or duplication: 15, 30, 32
The following statuses indicate an issue with fraud or respondent quality: 20, 29, 31
Status 11 & 19 indicate a dropped off respondent. These status will never be present in a redirect.
It is not possible to build actionable intelligence off of buyer related statuses like 17 or 18. Excessive Buyer quota fulls/terms will negatively impact buyer IR.
API PS Status Code | Status code | Description | Supplier Redirect Type | Counts against Buyer Incidence Rate | May Retake Survey? |
|---|---|---|---|---|---|
11 | PS Drop | N/A | Yes | ||
12 | PS Quota Full Core | The respondent belongs to a quota where remaining=0, and currently_open=0 | Overquota | If quota reopens or new quota opens | |
13 | PS Termination Core | Screener termination on qualification questions. Recheck survey qualifications | Termination | If qualifications change | |
14 | PS Side In Progress | The Respondent is in Progress | N/A | ||
15 | PS Quality | De-Dupe by PureSpectrum | Security if available, Termination if unavailable | No | |
16 | Buyer In Progress | N/A | No | ||
17 | Buyer Quota Full | Buyer has indicated quota-full | Overquota | x | No |
18 | Buyer Termination | Buyer has disqualified the respondent | Termination | x | No |
19 | Buyer Drop | The respondent has failed to return to PureSpectrum after three times current LOI | N/A | x | No - but may take a grouped survey |
20 | Buyer Quality Termination | Speeding, straight-lining, trap questions | Quality if available, Termination if unavailable | No | |
21 | Complete | Complete | x | No | |
22 | PS Survey Closed Termination | Survey Closed | Overquota | No | |
23 | PS Survey Paused Termination | Survey Paused | Overquota | Yes | |
24 | PS Unopened Quota Term | Quota has remaining>0, but currently_open=0 | Termination | Yes | |
25 | PS Supplier Allocation Full | No completes remaining for this supplier ID | Termination | Yes | |
26 | PS Past Participation Fail | Respondent is attempting to reload the PS → Supplier redirect. Most likely they have already been redirected to you as a complete or Term. This status will not be present in the Survey Traffic Report as it is not a final status, it is only used for redirection purposes to prevent “replay attacks”. | Termination | No | |
27 | PS Supplier Quota Allocation Full | Respondent has hit a Quota Full status, though the quota is limited to your supplier ID, and may be open to other suppliers. Will only apply to surveys where “Quotas By Supplier” have been set. | Yes | ||
28 | PS Invalid Survey | Survey is invalid. Check entry links | Termination | ||
29 | PS LOI Threshold Failure | The respondent redirected back from the buyer as a complete too quickly ############################# If this respondent's LOI is Less than loi_fraud_threshold_factor% of the Current LOI of the survey, OR if respondent's LOI is less than loi_fraud_threshold_absolute min, the LOI is suspicious. Settings:
| Quality if available, Termination if unavailable | No | |
30 | Buyer Security (De-Dupe) | Respondent has already taken survey, caught by the buyer | Security if available, Termination if unavailable | No | |
31 | Buyer Hash Failure | Respondent has tampered the url, resulting in security hash failure | Quality if available, Termination if unavailable | No | |
32 | PS Grouping Termination | Respondent is disqualified from taking the current survey due to grouping rules. Check grouping rules again | Security if available, Termination if unavailable | Yes, if exclusion period expires | |
33 | Buyer Reconcilliation Reject | The buyer has reconciled the survey, and in this process, a complete has been marked as a term | N/A | No | |
|
|
|
|
| |
35 | PS No matched quotas | Respondent failed to match at least one active quota | Termination | Yes, if a quota is added that the respondent matches | |
36 | PS Max IP Throttling Termination | The number of respondents taking the survey has met the max number of concurrent respondents set by the buyer | Overquota | Yes | |
37 | PS Quota Throttling Termination | The number of respondents taking the survey should satisfy the current target of completes. If more completes are needed, then the supplier_completes.currently_open quantity will increase | Overquota | Yes | |
38 | PS PSID Geo Termination | The respondent has previously taken a survey in a different geography | Security if available, Termination if unavailable | No | |
|
|
|
| ||
40 | PS GeoIP Fail | Respondent IP fails to match the survey country | Security if available, Termination if unavailable | No | |
41 | PS Bot Fail | Respondent is determined to be a bot | Security if available, Termination if unavailable | No | |
42 | PS BlackList Fail | Respondent has a PureScore of 5 or below and is blocked from taking surveys. They may however continue to interact with the PS pre-screener and potentially rehabilitate their score. | Security if available, Termination if unavailable | No | |
43 | PS Anonymous Fail | Respondent tries to be anonymous | Security if available, Termination if unavailable | ||
44 | PS Include Fail | Respondent which is not present in the PSIDRef list | Termination | Yes | |
45 | PS Termination Extended | Termination due to respondent not qualifying based on a profiling variable from the "Extended Profiling Question" class. Recheck survey qualifications. | Termination | If qualifications change | |
46 | PS Termination Custom | Termination due to respondent not qualifying based on a profiling variable from the "Custom Profiling Question" class. Recheck survey qualifications. Custom is the class for a question for a single buyer. These can be more forgiving and have Conditions added after the fact. | Termination | If qualifications change | |
47 | PS Quota Full Extended | The respondent belongs to a quota from the "Extended Profiling Question" class where remaining=0, and currently_open=0 | Overquota | If quota reopens or new quota opens | |
48 | PS Quota Full Custom | The respondent belongs to a quota from the "Custom Profiling Question" class where remaining=0, and currently_open=0 | Overquota | If quota reopens or new quota opens | |
49 | PS Include Fail | The respondent could not enter the survey because their PSID was not on the Include list. More information about Inlclude/Exclude can be found here: Include/Exclude PSID's | Termination | No | |
50 | PS Exclude Fail | The respondent could not enter the survey because their PSID is present on the Exclude. More information about Inlclude/Exclude can be found here: Include/Exclude PSID's | Termination | No | |
51 | Invalid Supplier | The supplier id of the respondent is invalid for this survey | Termination | Yes | |
52 | PSID Service Fail | There was a failure in our internal systems that prevented this respondent from proceeding | Termination | Yes | |
55 | PS Unique Link Termination | This study has insufficient links available for the respondent to be redirected to the study | Termination | Yes | |
56 | Unauthorized Augment | The respondent attempted an augment survey without first qualifying for the main study. Excessive counts of this status indicate an issue in the buyer survey, or that you are sending respondents directly into an augment survey which is not valid. | Termination | Yes | |
57 | PS Supplier Quota Full | The respondent belongs to a quota where remaining=0, and currently_open=0. Unlike status code 12 - this is on a supplier level rather than on a survey level. | Overquota | Yes | |
58 | PS Supplier Quota Throttling Termination | Similiar to Status 37 - The number of respondents taking the survey for this quota should satisfy the current target of completes. If more completes are needed, then the supplier_completes.currently_open quantity will increase | Overquota | Yes | |
59 | Buyer Config Error | The respondent was redirected from the buyer with missing parameters. | Termination | No | |
60 | PS_Js_Fail | The respondent is using an incompatible browser, or has disabled JavaScript in their browser. This respondent will see a warning, and then be redirected back to the supplier after 15 seconds. | Termination | Yes | |
62 | Ps_NoPureScore | Internal system error when a respondent’s profile returns “undefined” for purescore. May be caused when a respondent attempts to tamper with their profile. | Termination | Yes | |
63 | PS_Blacklist_Data_Quality | The Respondent failed at given Limit of data quality check questions, they will be terminated with PS Blacklist Data Quality status. | Termination | Yes | |
64 | PS_Blacklist_Data_Quality_2 | The respondent has failed at a given limit of data quality check questions on a second attempt. Anyone failing with this status will automatically see their purescore drop below 5, and future transactions will result in status 42 (ps_blacklist_fail) | Termination | No | |
|
| The IP address of the respondent falls under the “highest” risk category by Relevant ID’s | Termination | No | |
67 | PS_SC_Fraudster_Fail | The respondent has been evaluated as a High Risk threat by Sample Chain for fraud | Termination | No | |
68 | PS_SC_Threat_Fail | The respondent has been evaluated as a High Risk threat by Sample Chain for fraud | |||
69 | PS_TC_Termination | This status adds another layer of de-duplication against a related or grouped survey(s) and covers the following statues: ps_OQ, ps_drop, ps_quality, ps_termination | Termination | No | |
70 | PS_DF_DUPE | The respondent has been flagged as a duplicate within the same survey ID. We expect most PS_quality terminations to be reclassified under this code. Integrate GET PSIDEligible using the optional Research Defender | Security if available, Termination if unavailable | No | |
71 | ScHashFail | Respondent has attempted to alter security check API response | Security if available, Termination if unavailable | No | |
73 | PS_Transaction_Fraud | The respondent got flagged by our internal fraud check | Termination | ||
74 | Buyer_Eligibity_Check_Fail | The buyer has failed to created the URL link for the respondent. Use the GET PSIDEligible to pre-process buyer eligibility for a respondent. You may also use the batch PSIDEligible check POST PSIDEligible - Batch multiple surveys | Termination | Yes | |
75 | PS_Blacklist_Data_Quality_4 | Respondent failed data quality battery on a survey where DQ is required | Termination | No | No |
76 | PS_DQ_Screener_Invalid | Internal Error due to missing data quality battery answers | Termination | No | Yes |
77 | PS_Supply_Inbound_Hash_Security | Security if available, Termination if unavailable | |||
78 | PS_DQ_Honeypot_Fail | Security if available, Termination if unavailable | |||
79 | PS_PureText_Dedupe_Fail | Respondent has attempted OE question with duplicated text | Security if available, Termination if unavailable | No | |
80 | PS_AI_Text_Fail | Respondent has attempted OE question with text from AI/ChatGPT | Security if available, Termination if unavailable | No | |
81 | PS_Puretext_Language_Fail | Respondent has attempted OE question with different language text | Security if available, Termination if unavailable | No | |
82 | PS_Survey_Signature_Fail | Survey signature is not correct in survey entry link | Security if available, Termination if unavailable | Yes | |
83 | PS_Browser_Manipulation_Fail | ||||
84 | Buyer_PS_API_Fail | ||||
85 | ps_rd_predupe_fail | Respondent has failed the Research Defender Predupe Check | No | ||
86 | ps_df_dupe_grouping | Respondent has failed a grouped survey check based on device ID | No |