Skip to main content

Configure partner redirect URLs

Overview​

When conducting data collection in collaboration with a partner, you must configure partner redirect URLs to ensure proper communication between systems. These URLs allow your partner's platform to send respondents to your survey and enable you to redirect them back to the partner's system based on their completion status (completed, quota full, screened out, etc.). Proper configuration ensures seamless integration and accurate tracking of respondent outcomes.

Key features​

Start URL​

The entry point URL where your partner directs respondents to begin the survey. This URL should be provided to your partner so they can send qualified respondents to your data collection platform. You can include tracking parameters to identify the source and maintain respondent continuity across systems.

QuotaFull URL​

The redirect URL used when survey quotas have been reached. When a respondent attempts to access the survey but all quota cells are full, they will be automatically redirected to this partner URL. This allows the partner to properly track and compensate respondents who were willing to participate but couldn't due to quota limitations.

ScreenOut URL​

The redirect URL for respondents who do not qualify for the survey based on screening criteria. When a respondent fails to meet qualification requirements (e.g., demographic filters, behavioral criteria), they are redirected to this URL so the partner can record the screen-out and handle the respondent appropriately.

Completed URL​

The redirect URL for respondents who successfully complete the entire survey. Once a respondent finishes all questions and submits their responses, they are redirected to this partner URL. This allows the partner to confirm completion, provide incentives, and close the respondent's session properly.

URL Formatting / Capture parameter​

You can capture and forward dynamic parameters in your partner URLs using square bracket placeholders. These placeholders will be automatically replaced with actual values when redirecting respondents. This allows you to pass tracking information, respondent identifiers, or any custom data between your survey platform and your partner's system.

Use the format [parameterName] to define a placeholder that will be populated with the corresponding value. For example, if your partner provides a respondent ID when sending users to your survey, you can capture and return it in the redirect URL.

Example:

https://my.partner.com/completed?respondantId=[givenRespondantId]

In this example:

  • [givenRespondantId] will be replaced with the respondent ID that was originally provided by your partner

This ensures seamless data tracking and allows both systems to maintain consistent respondent identification throughout the data collection process.