Skip to main content

Set up an external sample provider

Integrate Dynata, Lucid, or any other sample provider

Updated over 4 months ago

Accounts on the Team or Enterprise plans can use their own sample.

To do this, you need to choose "Bring your own sample" from the audience type box when you create a new audience:

You will receive the usual entry points for every other audience type that needs to be completed and a set of fields that need to be completed under "sample integration.

How it works

When you set up a "bring your own sample" audience, you will receive a URL for the survey. This will look something like this:

https://audience.mx8.io/v1/audiences/basic/AGH64S/go?pd={pid}&psid={psid}

This consists of the base survey URL and several parameters your sample provider will fill in when redirecting respondents to the URL.

These parameters must typically be returned to the sample provider in the exit URL. For example, a typical exit URL for Dynata looks like this:

https://api.dynata.com/respondent/exit?rst=1&psid=(psid}

When setting up the audience, you should specify each exit URL, including the parameters your sample provider needs. The platform will create a survey URL that includes parameters you can use with your sample provider to run the survey.

If you are working with Dynata, their documentation on exit links is here. For Lucid, it is here.

The survey exit URLs

The URLs provide a set of URLs that the respondent should be redirected to at the end of the survey. You must enter a link for each of the following cases. Depending on your sample provider, you might end up providing the same link in multiple cases:

  • A URL for completed respondents, e.g., when the survey is completed.

  • A URL for terminated respondents, e.g., because they don't qualify for criteria within the survey.

  • A URL for quota screenout respondents, e.g., because they don't meet any of the quotas in the project.

  • A URL for respondents with over-quotas, e.g., because the only quota they qualify for is already full.

  • A URL for poor-quality respondents, e.g., ones where they fail fraud checks

  • A URL for duplicate respondents, e.g., those who have already taken that survey.

  • A URL for respondents where the entry URL is malformed and the survey cannot be taken.

You must include any parameters that should be passed into the survey link in the exit URL.

Respondent ID field

In the final box, enter the name of the respondent ID field. This field uniquely identifies respondents. It's typically ps_id or respondent_id, depending on your provider.

Getting the survey link

Once you have set up the audience, you can get the survey link by clicking on the "copy" button here:

Did this answer your question?