Skip to main content

Decipher / Forsta — Overview

Everything DQC does inside a Decipher/Forsta survey is built from two independent halves:

  1. The Quality Tool runs client‑side and scores each participant during fielding — device score, Data Trust Score, persona, duplicate flag.
  2. The transaction egress runs server‑side and posts each participant's outcome to DQC at the survey lifecycle hooks.

You can install the first without the second. The second needs the first, because it sends what the first collected.

How the pieces fit together

The pages, and whether you need them

PageStatusWhat it covers
General setupRequiredInstall the toolbox after the <survey> tag, define save_dqc_data(), add the dqc_data holder. Nothing else works without this.
Sending Transaction DataRequired to send dataForsta domain authorization (Step 0 — start it on day one), send_results_dqc(), the entry checks, and the two lifecycle calls.
Company MappingRequired to send dataThe buyer and the seller. A seller is required on every response, so this is not optional.
Failures MappingOptionalSend your own in‑survey quality checks — honeypots, trap questions, open‑ends.
Termination ScriptsOptionalEnd the survey early for duplicates, low scores or high‑risk personas. Only if your research policy allows it.
DispositionsInformativeHow DQC turns the status you send into a disposition. You never send a disposition — this is a reference.
Decipher XML GeneratorToolTick the options you need and copy the complete survey XML. Produces exactly what the pages above build by hand.
TroubleshootingWhen stuckThe common failure modes as symptom → cause → fix.

Two things worth knowing before you start

Step 0 has a clock on it

Authorizing api.dqco-op.com for server‑side calls is a request to Forsta Support and can take a few days. It is the only step in this section you cannot complete yourself, so submit it first and keep working while you wait.

You do not have to write any of this by hand

The Decipher XML Generator emits the whole survey — toolbox, exec blocks, holder, egress, failures and terminations — from a set of checkboxes. Read the pages above to understand what it produced, or to add DQC to a survey that already exists.