Integrate with Positly¶

This page describes how to configure a new Batch of slots for participants that will be recruited through the Positly recruitment service. Meadows integrates with Positly to enable participant recruitment for behavioral research studies. Start here for a more general introduction on recruitment.

Quick Start

Open your experiment version and go to the Participants tab
Click Create a new Batch.. and select the "Positly" template from the dropdown
Paste your Positly Completion Link in the Exit URL field
Configure entry variables (add participantID to track participant Positly ID)
Set the number of slots and click Create
Copy the Entry URL and paste it into Positly as the Activity Link
Enable exit page options (recommended: display exit link and auto-forward)

New to Meadows? See the Getting Started guide for a complete walkthrough.

Batch configuration¶

Entry URL¶

After you have configured and confirmed your batch, you'll enter this URL into Positly as the Activity Link.

Entry variables¶

With these so-called query parameters you can store metadata about your participant from Positly with your Meadows data. This is not required but can help link the participant's identity across systems, or if you wish to use demographics in your analysis. Find more information in the Positly documentation on demographic attributes. Here are a few examples:

participantID: Add this variable to store the participant's Positly ID on Meadows.
assignmentID: This is the ID of your Positly "Study".
device: The device type being used by the participant, e.g. "laptop".

Exit URL¶

Here you should paste the Completion Link from your Positly Run.

Exit page¶

These are features of the final page on Meadows that the participant will see when they complete your experiment:

display exit link: This will show a large green button that links back to Positly, making it easy for participants to return to complete their session.
display completion code: This displays the "task_id" part of the Completion URL. This only serves to give participants a sense of extra security, as the code is also supplied automatically through the Completion URL.
display meadows alias: This will display the Meadows nickname (of the form adjective-animal) on the final page, which may help in your troubleshooting communication with the participant.
automatically forward to exit link: If this is selected, after 4 seconds on the "thank you" page, the participant's browser will automatically redirect them back to Positly.