Research Panel Integrations

Seamlessly integrate with major research panel platforms to recruit quality participants. Srvey supports 6 research platforms (Prolific, Amazon MTurk, CloudResearch, Respondent, Positly, and Cint) plus Custom Platform for other services.

Quick Start

Connect your survey to a research panel in three steps:

1. Enable integration - Open your survey and navigate to Panel Integrations in the sidebar
2. Configure platform - Enable the platform and set completion code, completion URL, screenout URL, and quota full URL
3. Copy survey URL - Use the URL with parameters shown for your platform in your panel study

Supported Platforms

Srvey integrates with six major research platforms:

Platform	Participant ID	Other Parameters	Has Completion URL Template
Prolific	PROLIFIC_PID	STUDY_ID, SESSION_ID	Yes
Amazon MTurk	workerId	assignmentId, hitId	No
CloudResearch	workerId	assignmentId, hitId, studyId	Yes
Respondent	RESPONDENT_ID	PROJECT_ID	Yes
Positly	positly_id	session_id	No
Cint	respondent_id	project_id	No

How It Works

The panel integration system handles the complete participant recruitment flow:

Platform Detection

When participants arrive from a research panel, Srvey automatically detects which platform they came from by checking URL parameters. Detection happens in this priority order:

1. Prolific (PROLIFIC_PID)
2. CloudResearch (workerId + studyId)
3. MTurk (workerId + hitId)
4. Respondent (RESPONDENT_ID)
5. Positly (positly_id)
6. Cint (respondent_id)

Parameter Capture

When a platform is detected, Srvey captures and stores all relevant parameters:

• Participant IDs for matching responses to panel records
• Study/Session IDs for platform reconciliation
• Other platform-specific tracking parameters

These parameters are stored with each response and included in exports.

Completion Handling

When participants complete the survey:

1. Completion code generated - Unique or static code created
2. Code displayed - Shown on thank-you page
3. Auto-redirect (if enabled) - Participant sent back to platform with code

Setting Up Each Platform

Prolific

URL Parameters:

Parameter	Description
PROLIFIC_PID	Unique participant identifier
STUDY_ID	Your study identifier
SESSION_ID	Session tracking ID

Survey URL Format:

https://srvey.io/s/your-survey?PROLIFIC_PID={{%PROLIFIC_PID%}}&STUDY_ID={{%STUDY_ID%}}&SESSION_ID={{%SESSION_ID%}}

Completion URL:

https://app.prolific.com/submissions/complete?cc={code}

Setup Steps:

1. Enable Prolific in Panel Integrations
2. Enter your completion code
3. Copy the survey URL with parameters
4. Paste into Prolific study settings
5. Set Prolific to redirect using a URL

Amazon MTurk

URL Parameters:

Parameter	Description
workerId	Worker's MTurk ID
assignmentId	HIT assignment ID
hitId	Human Intelligence Task ID

Survey URL Format:

https://srvey.io/s/your-survey?workerId=${workerId}&assignmentId=${assignmentId}&hitId=${hitId}

Completion: Workers manually enter the code shown on the thank-you page into MTurk.

Setup Steps:

1. Enable MTurk in Panel Integrations
2. Enter your completion code
3. Copy the survey URL with parameters
4. Create External HIT in MTurk with the URL
5. Instruct workers to enter the code after completion

CloudResearch

URL Parameters:

Parameter	Description
workerId	Worker's ID
assignmentId	Assignment ID
hitId	HIT ID
studyId	CloudResearch study ID

Survey URL Format:

https://srvey.io/s/your-survey?workerId=[workerId]&assignmentId=[assignmentId]&hitId=[hitId]&studyId=[studyId]

Completion URL:

https://connect.cloudresearch.com/participant/project/{project_id}/complete?code={code}

Setup Steps:

1. Enable CloudResearch in Panel Integrations
2. Enter your completion code
3. Set completion URL with your project ID
4. Copy the survey URL with parameters
5. Configure in CloudResearch study settings

Respondent

URL Parameters:

Parameter	Description
RESPONDENT_ID	Unique respondent identifier
PROJECT_ID	Your project identifier

Survey URL Format:

https://srvey.io/s/your-survey?RESPONDENT_ID={{RESPONDENT_ID}}&PROJECT_ID={{PROJECT_ID}}

Completion URL:

https://app.respondent.io/r/done?code={code}

Positly

URL Parameters:

Parameter	Description
positly_id	Participant's Positly ID
session_id	Session tracking ID

Survey URL Format:

https://srvey.io/s/your-survey?positly_id={{positly_id}}&session_id={{session_id}}

Completion URL:

https://app.positly.com/complete?code={code}

Cint

URL Parameters:

Parameter	Description
respondent_id	Unique respondent ID
project_id	Your project ID

Survey URL Format:

https://srvey.io/s/your-survey?respondent_id=[respondent_id]&project_id=[project_id]

Completion: Configure redirect URLs in Cint panel settings.

Completion and Redirect Handling

Completion Codes

Choose your completion code type:

Type	Description	Best For
Unique	Different code per participant	Tracking individual completions
Static	Same code for all participants	Simple studies

Screenout URLs

Configure where ineligible participants are redirected:

• Prolific: https://app.prolific.com/submissions/complete?cc=nocode
• Other platforms: Configure in Advanced Redirect URLs

Quota Full URLs

Configure where participants go when quota is reached. Set in the Advanced Redirect URLs section of each platform.

Real-World Examples

Example: Academic Study with Prolific

Scenario: Psychology study with 200 participants.

Srvey Settings:
- Platform: Prolific (enabled)
- Completion Code: PSYCH2025
- Redirect: Enabled

Prolific Settings:
- Study URL: https://srvey.io/s/psych-study?PROLIFIC_PID={{%PROLIFIC_PID%}}&STUDY_ID={{%STUDY_ID%}}&SESSION_ID={{%SESSION_ID%}}
- Completion: Redirect to URL
- Places: 200

Example: MTurk HIT

Scenario: Market research survey for 50 workers.

Srvey Settings:
- Platform: MTurk (enabled)
- Completion Code: Auto-generated
- Redirect: Disabled (manual code entry)

MTurk HIT:
- External Question URL: https://srvey.io/s/market-research?workerId=${workerId}&assignmentId=${assignmentId}&hitId=${hitId}
- Reward: $2.00
- Max Assignments: 50

Example: Multi-Platform Study

Scenario: Large study across Prolific, CloudResearch, and Respondent.

Srvey Settings:
- Prolific: Enabled with completion code
- CloudResearch: Enabled with project-specific URL
- Respondent: Enabled with redirect

Benefits:
- Same survey, multiple recruitment sources
- Track responses by platform in analytics
- Export with platform column for analysis

Plan Availability

Feature	Free	Pro	Enterprise
Prolific integration	-	Yes	Yes
All platforms (MTurk, CloudResearch, etc.)	-	-	Yes
Custom platform	-	-	Yes
Parameter capture	-	Yes	Yes
Completion URL redirect	-	Yes	Yes
Screenout URL handling	-	Yes	Yes
Quota full URL handling	-	Yes	Yes

Panel integrations require the prolific_integration (Pro) or panel_integrations (Business+) feature.

Troubleshooting

Issue: Parameters not captured

Symptoms: Panel participant ID is empty in responses.

Solutions:

• Verify URL format matches platform syntax exactly
• Check parameter names are case-sensitive correct
• Test by visiting URL manually with sample parameters
• Ensure platform is enabled in settings

Issue: Platform not detected

Symptoms: Response shows no platform in analytics.

Solutions:

• Ensure correct parameters are in the URL
• Check detection priority (CloudResearch before MTurk)
• Verify parameter names match exactly

Issue: Completion code not showing

Symptoms: Thank-you page shows no code.

Solutions:

• Verify platform is enabled
• Check completion code is configured
• Ensure survey is in Active status

Issue: Auto-redirect not working

Symptoms: Participant stays on thank-you page.

Solutions:

• Check redirect URL is configured correctly
• Verify {code} placeholder is included
• Test in incognito mode (popup blockers)
• Try a different browser

Issue: Screenout redirect not triggering

Symptoms: Screened-out respondents stay on survey.

Solutions:

• Verify screenout URL is configured
• Check screen-out logic is working
• Use platform-specific screenout endpoints

Best Practices

• Test the complete flow before launching your study
• Use platform preview modes to verify parameters
• Monitor responses in real-time for issues
• Export regularly to verify parameter capture
• Use unique codes for tracking capability
• Configure screenout URLs for better participant experience
• Check analytics to compare completion rates by platform
• Keep completion codes consistent across study sessions