Skip to content
Developer

Respondent Survey Flow

Respondent Survey Flow

Registering Respondent

You can register a respondent in one of two ways:

  1. You can register a respondent via the /put-respondent endpoint.
  2. You can also register a respondent via optional query parameters on the inbound URL.

Preliminary Information

You must create a respondent in order to participate in opportunities in REX. We recommend including birth-date, gender, and postal code when creating a respondent.

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.

Use the Opportunity Registry to find surveys for respondents.

If an opportunity matches the respondent’s criteria, extract the live link from the JSON object to create the inbound URL.

Inbound (Entry URL)

Using the opportunity live link (ctx (context) and language) append the required and optional query parameters, then sign the link using the Dynata signing methodology. Learn more here.

The live Link from the Opportunity Registry payload JSON

https://respondent.rex.dynata.com/start?ctx=a7cc720b-208a-4e55-bab6-c619a765b24a&language=en

Fully signed inbound URL with query parameters.

https://respondent.rex.dynata.com/start?ctx=09e735cb-065a-4cef-b8f7-9b41d92e105a&language=en&respondent_id=example-123&expiration=2022-05-06T21%3a52%3a35.040Z&access_key=UI18565B90123FNC618IBAF1C3247JL30A67A00C&signature=6ef38b22f7a1c8d1a8627e41e79ee208159631b3f45ed518501aaaa99aa0c347

Use the created inbound URL to send the respondent into the survey.

Outbound (Redirect URL)

After the respondent enters the inbound URL and finishes the survey, they will be redirected to the outbound URL. The outbound URL contains the respondent’s survey disposition and status information. It also includes any custom query parameters you passed in with the inbound URL. Learn more here.

Outbound URL with status and disposition

https://example.partner.net/return?access_key=HS4SKZKA6JMNJEMK8FZGS24DX3UXBMHM9W65UHUZ&ctx=09e735cb-065a-4cef-b8f7-9b41d92e105a&disposition=1&expiration=2022-05-05T18%3A06%3A17.779Z&status=0&signature=758ae267c225598b25a90967688f2f799413275122eb4bd905c0078bfb636385