Respondents

A respondent is a person who participates in surveys and other opportunities. Each respondent is unique to a partner. Respondents are represented in Dynata by their respondent_id, the unique identifier assigned by the partner. To participate in opportunities, respondents must have all the attributes required for targeting.

Create Respondents

To create or update a respondent, use the Respondent Gateway put-respondent endpoint. The put-respondent endpoint requires a respondent_id, country, and language. It’s best practice to also include gender, birth_date, postal_code, and mapped attributes when creating a respondent.

Warning!

Do not pass age, postal code, and gender values in the attributes array. Use the birth_date, postal_code , and gender properties to set these values.

Inbound

If a respondent has not been created before going through the inbound URL, they’ll be created the first time they’re sent in.

Warning!

Do not pass the age, postal code, and gender values in the attributes query string parameter. Use the respective query parameters, birth_date, postal_code , and gender.

The respondent will be created using the respondent’s query string parameters and the opportunity’s locale.country (this is included in the opportunity’s ctx in the survey link).

Prescreening

Upon entry to the Inbound, Dynata will pre-screen for gender, postal_code, and birth_date if these respondent properties have not been passed in previously.

Refinement

Dynata will pre-screen through Inbound for attributes that were not passed previously when required by the opportunity.

Update Respondent Attributes

After a respondent has been created, their attributes can be set using the put-respondent-answers or put-respondent endpoints.

Learn more about Attributes.

View Respondent Information

The get-respondent-info endpoint can be called to view information about an existing respondent. The information includes set atttributes, status, and other respondent metadata. Partners can use respondent information to match respondents with opportunities.

Country & Language

A respondent can only participate in opportunities for a single country and language. If a respondent attempts an opportunity in a different country or language, they will not qualify.