What is the Duplicate Entrance Score?
The Duplicate Entrance Score (DES) detects whether a respondent is likely a duplicate of another recent entrant in the same survey. It compares IP address and/or demographics against peers who entered shortly before. You can run it as an IP-only check, a demographics check, or both. DES is available in the Quick Import and on API v3. It is not supported on v1/v2addRespondent requests.
High-level checks performed
- Needs either an IP or at least 4 demographic fields to compute a valid score. IP-only is enough for the IP duplicate check. No IP and fewer than 4 demographics is accepted but scored as invalid (
N/A). - Accepts up to 10 demographics. Each demographic
typemust be unique (use custom type strings instead of repeating"other"). - Compares the current entrant against peers from the last 15 minutes (up to a minimum of 10 peers when available; fewer peers still compared).
- If no peers exist (first entrant in the window), the score is 100 (
VALID_ENTRANT). - If any peer shares the same IP, the score is 0 (
DUPLICATE_IP) and peer respondent IDs are returned. - Otherwise, demographics are compared per peer. Exact matches keep a low (duplicate-like) score; similar age / year of birth can add a limited penalty; any hard mismatch treats that peer as different. The final score is the minimum over peers.
- Scores below 40 are categorized as
DUPLICATE_ENTRANT; otherwiseVALID_ENTRANT. - After a Quick Import, ReDem also flags the first respondent in a
DUPLICATE_ENTRANTchain. Previously that original entrant stayedVALID_ENTRANTeven though later respondents listed them as a duplicate.
Demographic types
type is a free-form string. Any custom label is allowed and compared with exact match (case-insensitive after trim), except the age-like types below.
Recommended type values
Age-like types (
age, yearOfBirth)
These are the only types that use similarity instead of exact match:
- Numeric answers within ±3 count as similar (adds a limited score penalty once per peer, even if both
ageandyearOfBirthare similar) - Exact numeric matches count as same
- Non-numeric or larger differences count as different (that peer is treated as fully different)
Categories
Default cleaning
When cleaning is enabled with recommended settings:- Exclude respondents with a DES score below 40
- Category-based DES exclusions (
DUPLICATE_IP,DUPLICATE_ENTRANT) are off by default
How to use the DES?
Quick Import
In the Quick Import, add the Duplicate Entrance Score quality check and map an IP column, demographic columns (at least 4, up to 10), or both. IP-only is enough for the IP duplicate check. Column pickers show Header ID and Question Text, and both are searchable. When you select DES, ReDem recommends which demographic questions to use. Review and adjust the suggestions as needed. Your mapping is kept when you change quality checks, add respondents, or reuse a previous survey’s setup. See Quick Import.API
Send a single DES data point onPOST /v3/addRespondent with optional entranceTime (defaults to the current timestamp if omitted), optional ip, and an optional demographics array. Provide an IP, at least 4 demographics, or both. Only one DES data point is allowed per respondent (dataPointId defaults to "DES").
