You can add custom parameters to your Ballpark participant links to track where participants come from and pass that information back to your external tools.
What this lets you do
When you invite participants through your CRM, external panel provider, or other tools, you can:
Track which participants came from which source
Pass participant IDs or other identifiers through to Ballpark
Get that information back when participants finish, so you can redirect and mark them as complete in your system
Common use cases
Panel management: Using panels like User Interviews or Cint, you can pass through their IDs so you can automatically mark participants as complete and trigger payments.
A/B testing recruitment: Test different recruitment messages by adding a parameter to track which version each participant saw.
🔍 Using Rally as your CRM? Use our integration to seamlessly run Ballpark studies with your own participants. Learn more →
How it works
Step 1: Add parameters to your participant share link
Most participant panels and CRMs will have guides to appending parameters to URLs (see Common Use Cases for example guides).
You'll need to provide the Ballpark share URL to the tool:
Open your study
At the top-right press Share
Select either Self-guided or Live session
Press Copy
Alternatively, you can manually add parameters by taking your Ballpark link and adding your custom parameters to the end:
Standard link:
https://app.ballparkhq.com/share/self-guided/abc123With custom parameters:
https://app.ballparkhq.com/share/self-guided/abc123?participant_id=12345&source=email_campaign
You can add any parameters you need. Common ones include:
participant_id- to track individual participantssource- to track where they came fromcampaign- to track specific campaignspanel_id- if you're using a panel provider
Step 2: Set up your redirect link
You can now add these parameters to your redirect link. Ballpark will automatically pass them through when participants reach the end of the study.
Example redirect link:
https://yourcrm.com/complete?participant_id={{participant_id}}&campaign={{campaign}}
When a participant finishes, they'll be redirected to a URL with these {{placeholders}} completed, like: https://yourcrm.com/complete?participant_id=12345&campaign=email_campaign
Setting up the redirect
Open your Ballpark study
On the Build tab, navigate down to the Exit step
Press Options > Button and toggle on
Add your redirect URL with parameter placeholders in double curly braces:
{{parameter_name}}
Any parameters you added to the participant link will be available as placeholders in your redirect URL.
Technical details
Parameters are captured when participants first visit the link and stored with their response data
You can view parameters as columns at the end of the Response table, fields on the Details tab of each response and in CSV downloads
You can use up to 25 different parameter names per study (each parameter can have unlimited different values)
You'll need to specify which parameters are passed through to redirect URLs on the exit step
Parameter names are case-sensitive
Need help?
If you're setting this up with a specific tool or panel provider and need guidance, just get in touch with our support team. We're happy to help you get everything connected properly.
We'd also love to hear your suggestions for tools you'd like us to build full integrations with. If there's a CRM, panel provider, or other tool you use regularly that would benefit from a deeper connection with Ballpark, let us know – your feedback helps us decide what to build next.