Accounts on the Team or Enterprise plans can use their own sample.
To do this, you need to choose External Providers ("Set up links for any sample provider outside the MX8 Labs network") from the respondent source box when you create a new respondent source:
You will receive the usual entry points for every other respondent source that need to be completed, along with a set of fields under "sample integration" that also need to be completed.
How it works
When you set up an External Providers respondent source, you will receive a URL for the survey. This will look something like this:
https://audience.mx8.io/v1/audiences/basic/{audience_id}/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. {audience_id} is the identifier the platform assigns to this respondent source — you don't create it yourself. Use the "copy" button on the respondent source to get your own link with the real value already in place, as described under "Getting the survey link" below.
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 respondent source, 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, see Dynata's survey exit-link documentation. For Lucid, see Cint's sample-provider support documentation.
The survey exit URLs
The URLs provide the destinations for respondents at the end of the survey. Enter a link for each outcome that should redirect to your provider. Depending on your sample provider, you might provide 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 who refused consent at the start of the survey.
- A URL for respondents where the entry URL is malformed and the survey cannot be taken.
New external-provider sources start with MX8 Labs built-in outcome-page URLs. These show the relevant outcome when you have not configured a provider destination. Replace them with your provider's exit URLs before fielding when the provider needs respondents returned to its own system. Existing custom URLs are retained.
You must include any parameters that should be passed into the survey link in the exit URL. Provider-owned integration fields can be read-only while the source is In Field; configure the exit URLs and respondent-ID mapping before launch.
Use Completion redirect delay (seconds) and Termination redirect delay (seconds) to control when the respondent leaves the survey after its final message. Leave a delay blank to inherit the survey's timing, enter 0 to redirect immediately, or enter a positive whole number of seconds to keep the end message visible for that long. A blank destination URL means there is no redirect for that outcome. Internal survey test links stay in the survey on completion or termination. External audience test links use their configured destination and delay, so use those links to check provider handoff. Undo remains available before navigation when the redirect countdown allows time to use it.
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 saved the respondent source, return to the survey's respondent source list. Find the source you created and select Copy link to copy its survey URL. Send that URL to your sample provider for fielding.
